Validácia faktúry

Bezplatný eConnect Validator: skontrolujte, či Váš XML súbor spĺňa požiadavky UBL, BIS Billing a NLCIUS.

Pred odoslaním e-faktúry sa chcete uistiť, že XML súbor je technicky správny. eConnect Validator kontroluje Vašu faktúru na XML schémy, Schematron pravidlá a validácie špecifické pre jednotlivé krajiny. Nástroj je bezplatne dostupný ako online validátor.

Čo validátor kontroluje?

eConnect Validator vykonáva viacero kontrol Vášho súboru e-faktúry:

Validácia XML schémy. Je základná štruktúra súboru správna? Sú všetky povinné XML elementy prítomné a správne vnorené?

Validácia Schematron. Spĺňa faktúra obchodné pravidlá zvoleného profilu? Ide o pravidlá pre výpočty DPH, povinné polia a zoznamy kódov.

Kontrola profilu. Systém automaticky rozpozná, aký profil Vaša faktúra sleduje (BIS Billing V3, NLCIUS, PINT, XRechnung) a aplikuje príslušné validačné pravidlá.

Pravidlá špecifické pre krajinu. Pre každú krajinu platia doplnkové validačné pravidlá. Pre Holandsko sú to pravidlá NL-R, pre Nemecko pravidlá DE-R, pre Dánsko pravidlá DK-R atď. Validátor ich automaticky aplikuje na základe kódu krajiny vo faktúre.

Podporované formáty

Validátor podporuje všetky bežné formáty e-faktúr:

FormátPopisPeppol BIS Billing V3Peppol štandard pre faktúry a dobropisyNLCIUS / SI-UBL 2.0Holandská implementácia EN 16931PINT (všetky varianty)Peppol International Invoice (EÚ, A-NZ, Japonsko, Singapur, Malajzia, SAE)XRechnungNemecká implementáciaCII (Cross-Industry Invoice)Alternatívna XML syntax, vrátane Factur-X
Ako používať validátor?

Online validátor je dostupný na /sk/validator. Na jeho použitie nemusíte vytvárať účet.

  1. Otvorte Document Validator.
  2. Nahrajte Váš XML súbor alebo vložte XML obsah.
  3. Validátor automaticky rozpozná formát a aplikuje správne pravidlá.
  4. Pozrite si výsledok: pre každé pravidlo vidíte, či kontrola prešla, dala varovanie alebo obsahuje chybu.

Pri chybách validátor zobrazí presný kód chyby, popis problému a umiestnenie v XML súbore (XPath). Tak presne viete, čo musíte upraviť.

Interpretácia chýb

Validátor vydáva tri typy hlásení:

  • Chyba (error): faktúra nespĺňa špecifikáciu a bude v sieti Peppol odmietnutá. Toto musíte vyriešiť pred odoslaním.
  • Varovanie (warning): faktúra nebude odmietnutá, ale existuje bod na pozornosť. Varovania sa v budúcej verzii môžu stať povinnými.
  • Informatívne: poznámka bez dôsledkov pre odosielanie.

Bežné kódy chýb začínajú prefixom, ktorý označuje oblasť: PEPPOL- pre pravidlá platné v celej sieti Peppol, NL-R- pre holandské pravidlá, BR- pre základné pravidlá z EN 16931. Popis chyby vždy uvádza, aké je očakávané správanie.

Časté chyby validácie pri dobropisoch

Pri odosielaní dobropisu sa pravidelne vyskytujú niektoré špecifické chyby validácie. Chyba sa objavuje na úrovni Peppol (pri odoslaní cez API napr. ako [API400.AT04] Invalid payload). Podľa pravidla príčina a riešenie:

Kód chybyPríčinaRiešenieBR-IC-02 (EN 16931: BR-IC-2)Riadok faktúry (BG-25) s kategóriou DPH Intra-community supply / K (BT-151) bez povinného party-VAT: seller VAT (BT-31) alebo seller tax representative VAT (BT-63), a buyer VAT (BT-48). Neukazuje na konkrétne číslo riadku; chýbajúce údaje v detailoch strany.Vyplňte seller VAT (alebo tax rep) a buyer VAT s prefixom krajiny, bez medzier/bodiek. Skontrolujte všetky riadky s kategóriou K.BR-IC-11Pri intrakomunitárnej dodávke (kategória DPH "Intra-community supply") chýba dátum dodávky BT-72.Vyplňte skutočný dátum dodávky (BT-72, cac:Delivery/cbc:ActualDeliveryDate), alebo uveďte fakturačné obdobie (BG-14). Jedno z oboch je povinné.BR-IC-12Pri intrakomunitárnej dodávke chýba kód krajiny BT-80 dodacej adresy.Vyplňte kód krajiny "deliver to" (BT-80, cac:Delivery/cac:DeliveryLocation/cac:Address/cac:Country/cbc:IdentificationCode) kódom ISO 3166-1 alpha-2.BR-27Jednotková cena položky (PriceAmount, BT-146) je záporná ("Item net price shall NOT be negative"; okrem iného Maventa/Peppol to hlási ako "XML Invalid").Jednotková cena musí byť vždy kladná. Nemožno vypnúť -- nejde o nastavenie tenanta eConnect, ale o pravidlo EN 16931/Peppol. Dobropisujte pomocou záporného množstva (TypeCode 380) alebo pomocou schémy CreditNote (381, cena aj množstvo kladné). Opravte export v zdrojovom softvéri; opätovné odoslanie rovnakého XML BR-27 nerieši. Pozrite tiež Varianty dobropisu a self-billing.NL-R-001Na dobropise od NL dodávateľa chýba povinná referencia na faktúru.Vyplňte cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID číslom pôvodnej faktúry. Povinné pre dobropisy. Pozrite tiež Varianty dobropisu.

BR-IC-11 a BR-IC-12 sú základné pravidlá EN 16931, ktoré platia iba vtedy, keď dobropis obsahuje intrakomunitárnu kategóriu DPH; pri tuzemských dodávkach sa nevyskytujú.

Chyby validácie pri fakturačných a riadkových obdobiach

Faktúra môže obsahovať obdobie na dvoch úrovniach: fakturačné obdobie na úrovni dokumentu (BG-14) a riadkové obdobie pre každý riadok faktúry (BG-26, pre opakujúce sa služby alebo predplatné na úrovni riadku). Ak sa použijú oba, Peppol vyžaduje, aby každé riadkové obdobie spadalo do nadradeného fakturačného obdobia. Nasledujúce chyby sa objavia, ak táto podmienka nie je splnená:

Kód chybySprávaPríčinaRiešeniePEPPOL-EN16931-R110Start date of line period MUST be within invoice period.Počiatočný dátum riadkového obdobia (BT-134) je skorší ako počiatočný dátum fakturačného obdobia (BT-73).Zabezpečte, aby BT-134 (cac:InvoiceLine/cac:InvoicePeriod/cbc:StartDate) bolo rovnaké alebo neskôr ako počiatočný dátum fakturačného obdobia BT-73 (cac:InvoicePeriod/cbc:StartDate na úrovni dokumentu).PEPPOL-EN16931-R111End date of line period MUST be within invoice period.Koncový dátum riadkového obdobia (BT-135) je neskôr ako koncový dátum fakturačného obdobia (BT-74).Zabezpečte, aby BT-135 (cac:InvoiceLine/cac:InvoicePeriod/cbc:EndDate) bolo rovnaké alebo skôr ako koncový dátum fakturačného obdobia BT-74 (cac:InvoicePeriod/cbc:EndDate na úrovni dokumentu).BR-30If both Invoice line period start date (BT-134) and Invoice line period end date (BT-135) are given then the Invoice line period end date (BT-135) shall be later or equal to the Invoice line period start date (BT-134).Sú prítomné počiatočný dátum (BT-134) aj koncový dátum (BT-135) InvoiceLinePeriod, a BT-135 je skoršie ako BT-134.Vyplňte platné dátumy (YYYY-MM-DD): koncový dátum väčší alebo rovnaký ako počiatočný dátum. Ak riadkové obdobie nie je potrebné, vynechajte celý blok cac:InvoiceLine/cac:InvoicePeriod (BG-26), nielen dátumy. Prázdne alebo neplatné pole dátumu sa stále počíta ako prítomné. Vyplňte aspoň počiatočný alebo koncový dátum, ak sa skupina použije (BR-CO-20).

Základná kontrola R110 spočíva v tom, že počiatočný dátum riadkového obdobia je rovnaký alebo neskôr ako počiatočný dátum fakturačného obdobia. Ak chyba pretrváva, aj keď riadkové obdobie vyzerá správne, skontrolujte, či problém nie je na úrovni dokumentu: buď je fakturačné obdobie (BT-73) nastavené príliš neskoro, alebo je riadkové obdobie nezamýšľane širšie, než bolo zamýšľané. Oba obdobia sa musia vzájomne zahŕňať: fakturačné obdobie je vonkajšou hranicou, každé riadkové obdobie do nej musí spadať.

BR-30 (EN 16931) je iné pravidlo ako R110/R111: R110/R111 kontrolujú, či riadkové obdobie spadá do fakturačného obdobia, zatiaľ čo BR-30 kontroluje iba poradie dvoch prítomných dátumov riadkového obdobia (BT-135 väčšie alebo rovné BT-134).

Ďalšie pravidlá pre obdobia, ktoré sa môžu vyskytnúť v rovnakom kontexte:

  • BR-CO-19 / BR-CO-20: ak sa použije fakturačné obdobie (BG-14) alebo riadkové obdobie (BG-26), musí byť vyplnený aspoň počiatočný alebo koncový dátum (jeden z oboch stačí, oboje je tiež povolené).
  • PEPPOL-EN16931-F001: všetky dátumy musia byť vo formáte YYYY-MM-DD.

Tieto pravidlá platia tak pre faktúry (ubl:Invoice), ako aj pre dobropisy (ubl:CreditNote).

Validácia pri odosielaní

Okrem manuálneho validátora vykonáva platforma eConnect automatickú validáciu aj v momente odoslania. Ak faktúra nespĺňa požiadavky, odoslanie sa zablokuje a dostanete chybové hlásenie s príslušným validačným pravidlom.

Pre používateľov API: PSB validuje každú faktúru pri odoslaní a vracia výsledky validácie v API odpovedi. Tak môžete validáciu zabudovať aj do vlastného softvérového procesu.

Sledovanie nových verzií

Validačné pravidlá sa aktualizujú pri každej novej verzii špecifikácie Peppol BIS Billing. eConnect aktualizuje Schematron artefakty a zoznamy kódov, akonáhle sa nová verzia stane povinnou. Online validátor vždy validuje voči aktuálnej verzii.

Tip: po aktualizácii špecifikácie skontrolujte, či sú Vaše faktúry stále platné. Nové pravidlá môžu klásť prísnejšie požiadavky na polia, ktoré boli predtým nepovinné.

Často kladené otázky
Čo ak moja faktúra obsahuje chybu pri validácii?

Validátor pri každej chybe zobrazí presný kód chyby, popis problému a umiestnenie v XML súbore (XPath). Chyby musia byť vyriešené pred odoslaním, inak bude faktúra v sieti Peppol odmietnutá. Varovania sú body na pozornosť, ale neblokujú odoslanie.

Aké formáty môže validátor skontrolovať?

Validátor podporuje Peppol BIS Billing V3, NLCIUS/SI-UBL 2.0, všetky varianty PINT, XRechnung a CII (Cross-Industry Invoice, vrátane Factur-X). Formát je rozpoznaný automaticky pri nahraní XML súboru.

Je moja faktúra pri odoslaní tiež automaticky validovaná?

Áno. Platforma eConnect automaticky vykonáva validáciu v okamihu odoslania. Ak faktúra nespĺňa požiadavky, odoslanie sa zablokuje s chybovým hlásením. Užívatelia API dostanú výsledky validácie v API odpovedi.


Chcete si pozrieť ukážkové súbory na kontrolu vlastnej XML štruktúry? Stiahnuť ukážkové súbory.

Zvalidujte Vašu faktúru

Súvisiace