XML upute

XML upute

UBL 2.1 Validator

Ovaj validator obavezno je koristiti za provjeru ispravnosti XML dokumenta. Ako validacija vrati greške, one će biti ispisane u odgovoru. U službenoj specifikaciji možete pronaći pravilo ili XML element koji je uzrokovao pogrešku.

Otvori UBL 2.1 Validator

Specifikacija

Ovo je službena specifikacija Porezne uprave za eRačun i HR ekstenzije. Definira koji XML elementi se koriste, gdje se nalaze i jesu li obavezni ili opcionalni.

Ako validator vrati grešku, u ovoj specifikaciji potražite pravilo ili XML element koji je uzrokovao problem.

Preuzmi Specifikaciju (PDF)

XSD shema

XSD shema definira potpunu tehničku strukturu UBL 2.1 eRačuna. Najvažnije, definira točan redoslijed elemenata u XML dokumentu.

to znači da je redoslijed elemenata pogrešan. Otvorite XSD shemu u XML editoru i provjerite ispravan slijed elemenata.

Preuzmi XSD shemu

XML primjeri

Ovaj paket sadrži gotove XML primjere za najčešće poslovne scenarije, uključujući različite PDV stope, račune bez PDV-a, maržu, prijenos porezne obveze i kombinirane porezne slučajeve. Koristite ove primjere za usporedbu strukture i vrijednosti vašeg XML-a s ispravnim dokumentima.

Preuzmi XML primjere

 

Česta pitanja i pravila (FAQ)

Što upisati u Seller Contact ID i Seller Contact Name?

Seller Contact ID mora sadržavati OIB bez prefiksa države, dakle točno 11 znamenki. OIB može pripadati fizičkoj osobi koja je kreirala račun ili pravnoj osobi (tvrtki), ovisno o konkretnom poslovnom slučaju.

Seller Contact Name mora sadržavati točan naziv osobe ili tvrtke na koju se navedeni OIB odnosi.

Kada se koristi porezna kategorija O?

Porezna kategorija O koristi se isključivo kada cijeli račun ne podliježe PDV-u.

U tom slučaju u PartyTaxScheme / TaxScheme / ID upisuje se vrijednost FRE. U svim ostalim slučajevima, kada na računu postoji PDV, TaxScheme ID mora biti VAT.

Što ako XML sadrži prazne elemente ili polja?

XML ne smije sadržavati prazne elemente ili polja bez vrijednosti. Takve elemente je potrebno u potpunosti ukloniti iz XML dokumenta.

Ako element nije obavezan i nema vrijednost, ne smije se uopće generirati u kodu, inače će XML pasti na validaciji.

Kako ispravno popuniti EndpointID i PartyIdentificationID?

Način popunjavanja u potpunosti ovisi o tome koristi li se OIB ili GLN.

Ako se koristi OIB:

  • EndpointID sadrži samo OIB, uz parametar schemeID="9934"
  • PartyIdentificationID se upisuje u povezanom formatu 9934:OIB

Ako se koristi GLN:

  • EndpointID sadrži samo GLN vrijednost
  • PartyIdentificationID se upisuje uz parametar schemeID="0088"

Primjere ispravnog popunjavanja uvijek dodatno provjerite u našim službenim XML primjerima.

Kako se iskazuju prolazne stavke i posebni porezi na računu?

Stavke poput posebnog poreza u ugostiteljstvu, povratne naknade ili carina iskazuju se kao trošak na razini dokumenta i za njih se ne upisuje KPD šifra.

Ako račun nema drugih stavki (InvoiceLine), tada je takvu stavku potrebno iskazati kao InvoiceLine te upisati onu KPD šifru koja je najsličnija stvarnoj prirodi stavke.

Koji dokumenti ne trebaju sadržavati KPD šifre?

Dokumenti tipa odobrenje (381) i avansni račun (386) ne trebaju sadržavati KPD šifre.

Ako radite storno avansa, možete koristiti dokument s ID-jem 386 kako biste izbjegli obvezu upisivanja KPD šifre.

Kako se iskazuje marža na računu?

Kod posebnog postupka oporezivanja marže, PDV se ne iskazuje na samom računu, već u posebnom obrascu koji se predaje zasebno (ta zakonska obveza i dalje postoji i nije obuhvaćena ovim promjenama).

Sam račun ne podliježe PDV-u temeljem članka 5. Zakona o PDV-u. Tako mora biti posložen i eRačun:

  • Sadrži samo jednu stavku
  • Sadrži službenu napomenu o oslobođenju
  • Dodijeljena je porezna kategorija O
  • Element cbc:Name mora biti postavljen na HR:O

Ako je potrebno iskazati i PPOM, on se iskazuje kao trošak, ali također mora biti u kategoriji O, jer na takvom računu može postojati isključivo kategorija O.

Kada se koristi Copy Indicator?

Copy Indicator koristi se isključivo kada radite korekciju već uspješno fiskaliziranog računa koja ne uključuje nikakve izmjene u iznosima.

U tom slučaju šalje se novi, ispravljeni račun s identičnim brojem računa.

Ako je potrebno izmijeniti sam iznos već fiskaliziranog računa, tada se zakonski mora kreirati storno računa, a nakon toga potpuno novi račun s novim brojem.

Smije li XML sadržavati razmake u vrijednostima numeričkih polja?

Ne smije.

Numerička polja (iznosi, porezi, količine) ne smiju sadržavati razmake, prazna mjesta ili tekstualne znakove. Sve vrijednosti moraju biti upisane u XML-u isključivo kao čisti broj (npr. 1500.50).

Što ako se javljaju greške u XML-u, a sve izgleda točno?

U tom slučaju obavezno je potrebno detaljno provjeriti namespaceove definirane na samom vrhu XML dokumenta.

Namespaceovi moraju u potpunosti odgovarati službenoj UBL 2.1 specifikaciji.

Preporuka je kopirati i koristiti namespaceove iz naših službenih XML primjera, jer su neispravni ili zastarjeli namespaceovi najčešći uzrok skrivenih grešaka pri validaciji.

Koju KPD šifru je potrebno upisati?

Ne smije se upisivati proizvoljna ili izmišljena KPD šifra.

Potrebno je koristiti isključivo jednu od službeno definiranih šifri prema važećem šifrarniku Porezne uprave. Ako niste sigurni u točnu klasifikaciju, odaberite šifru koja je svojom prirodom najbliža stvarnoj usluzi ili robi koju isporučujete.

Kada je potrebno kreirati HR ekstenziju dokumenta?

HR ekstenzija dokumenta kreira se samo kada račun sadrži specifične stavke koje ne podliježu standardnom PDV-u (npr. oslobođenja, prolazne stavke ili posebni porezi).

Ako račun sadrži isključivo stavke koje su oporezive standardnim PDV-om, HR ekstenzija se uopće ne kreira u strukturi dokumenta. Uvijek se vodite postavkama iz naših XML primjera.

Newsletter subscription