/ docs
ProduktZnalostiVývojáři
Platforma Control
Validace faktury

Bezplatný eConnect Validator: zkontrolujte, zda Váš XML soubor splňuje požadavky UBL, BIS Billing a NLCIUS.

Před odesláním e-faktury se chcete ujistit, že XML soubor je technicky správný. eConnect Validator kontroluje Vaši fakturu na XML schémata, Schematron pravidla a validace specifické pro jednotlivé země. Nástroj je bezplatně dostupný jako online validátor.

Co validátor kontroluje?

eConnect Validator provádí několik kontrol Vašeho souboru e-faktury:

Validace XML schématu. Je základní struktura souboru správná? Jsou všechny povinné XML elementy přítomné a správně vnořené?

Validace Schematron. Splňuje faktura obchodní pravidla zvoleného profilu? Jde o pravidla pro výpočty DPH, povinná pole a seznamy kódů.

Kontrola profilu. Systém automaticky rozpozná, jaký profil Vaše faktura sleduje (BIS Billing V3, NLCIUS, PINT, XRechnung) a aplikuje příslušná validační pravidla.

Pravidla specifická pro zemi. Pro každou zemi platí doplňková validační pravidla. Pro Nizozemsko jsou to pravidla NL-R, pro Německo pravidla DE-R, pro Dánsko pravidla DK-R atd. Validátor je automaticky aplikuje na základě kódu země ve faktuře.

Podporované formáty

Validátor podporuje všechny běžné formáty e-faktur:

FormátPopisPeppol BIS Billing V3Peppol standard pro faktury a dobropisyNLCIUS / SI-UBL 2.0Nizozemská implementace EN 16931PINT (všechny varianty)Peppol International Invoice (EU, A-NZ, Japonsko, Singapur, Malajsie, SAE)XRechnungNěmecká implementaceCII (Cross-Industry Invoice)Alternativní XML syntaxe, včetně Factur-X
Jak používat validátor?

Online validátor je dostupný na /cs/validator. K jeho použití nemusíte vytvářet účet.

  1. Otevřete Document Validator.
  2. Nahrajte Váš XML soubor nebo vložte XML obsah.
  3. Validátor automaticky rozpozná formát a aplikuje správná pravidla.
  4. Prohlédněte si výsledek: pro každé pravidlo vidíte, zda kontrola prošla, dala varování nebo obsahuje chybu.

Při chybách validátor zobrazí přesný kód chyby, popis problému a umístění v XML souboru (XPath). Tak přesně víte, co musíte upravit.

Interpretace chyb

Validátor vydává tři typy hlášení:

  • Chyba (error): faktura nesplňuje specifikaci a bude v síti Peppol odmítnuta. Toto musíte vyřešit před odesláním.
  • Varování (warning): faktura nebude odmítnuta, ale existuje bod k pozornosti. Varování se v budoucí verzi mohou stát povinnými.
  • Informativní: poznámka bez důsledků pro odesílání.

Běžné kódy chyb začínají prefixem, který označuje oblast: PEPPOL- pro pravidla platná v celé síti Peppol, NL-R- pro nizozemská pravidla, BR- pro základní pravidla z EN 16931. Popis chyby vždy uvádí, jaké je očekávané chování.

Časté chyby validace u dobropisů

Při odesílání dobropisu se pravidelně vyskytují některé specifické chyby validace. Chyba se objevuje na úrovni Peppol (u odeslání přes API např. jako [API400.AT04] Invalid payload). Podle pravidla příčina a řešení:

Kód chybyPříčinaŘešeníBR-IC-02 (EN 16931: BR-IC-2)Řádek faktury (BG-25) s kategorií DPH Intra-community supply / K (BT-151) bez povinného party-VAT: seller VAT (BT-31) nebo seller tax representative VAT (BT-63), a buyer VAT (BT-48). Neukazuje na konkrétní číslo řádku; chybějící údaje v detailech strany.Vyplňte seller VAT (nebo tax rep) a buyer VAT s prefixem země, bez mezer/teček. Zkontrolujte všechny řádky s kategorií K.BR-IC-11Při intrakomunitárním dodání (kategorie DPH "Intra-community supply") chybí datum dodání BT-72.Vyplňte skutečné datum dodání (BT-72, cac:Delivery/cbc:ActualDeliveryDate), nebo uveďte fakturanční období (BG-14). Jedno z obou je povinné.BR-IC-12Při intrakomunitárním dodání chybí kód země BT-80 dodací adresy.Vyplňte kód země "deliver to" (BT-80, cac:Delivery/cac:DeliveryLocation/cac:Address/cac:Country/cbc:IdentificationCode) kódem ISO 3166-1 alpha-2.BR-27Jednotková cena položky (PriceAmount, BT-146) je záporná ("Item net price shall NOT be negative"; mimo jiné Maventa/Peppol to hlásí jako "XML Invalid").Jednotková cena musí být vždy kladná. Nelze vypnout -- nejde o nastavení tenanta eConnect, ale o pravidlo EN 16931/Peppol. Dobropište pomocí záporného množství (TypeCode 380) nebo pomocí schématu CreditNote (381, cena i množství kladné). Opravte export ve zdrojovém softwaru; opětovné odeslání stejného XML BR-27 neřeší. Viz také Varianty dobropisu a self-billing.NL-R-001Na dobropisu od NL dodavatele chybí povinná reference na fakturu.Vyplňte cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID číslem původní faktury. Povinné pro dobropisy. Viz také Varianty dobropisu.

BR-IC-11 a BR-IC-12 jsou základní pravidla EN 16931, která platí pouze tehdy, když dobropis obsahuje intrakomunitární kategorii DPH; u tuzemských dodávek se nevyskytují.

Chyby validace u fakturančních a řádkových období

Faktura může obsahovat období na dvou úrovních: fakturanční období na úrovni dokumentu (BG-14) a řádkové období pro každý řádek faktury (BG-26, pro opakující se služby nebo předplatné na úrovni řádku). Pokud se použijí obě, Peppol vyžaduje, aby každé řádkové období spadalo do nadřazeného fakturančního období. Následující chyby se objeví, pokud tato podmínka není splněna:

Kód chybyZprávaPříčinaŘešeníPEPPOL-EN16931-R110Start date of line period MUST be within invoice period.Počáteční datum řádkového období (BT-134) je dřívější než počáteční datum fakturančního období (BT-73).Zajistěte, aby BT-134 (cac:InvoiceLine/cac:InvoicePeriod/cbc:StartDate) bylo rovno nebo později než počáteční datum fakturančního období BT-73 (cac:InvoicePeriod/cbc:StartDate na úrovni dokumentu).PEPPOL-EN16931-R111End date of line period MUST be within invoice period.Koncové datum řádkového období (BT-135) je pozdější než koncové datum fakturančního období (BT-74).Zajistěte, aby BT-135 (cac:InvoiceLine/cac:InvoicePeriod/cbc:EndDate) bylo rovno nebo dříve než koncové datum fakturančního období 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).Jsou přítomna jak počáteční datum (BT-134), tak koncové datum (BT-135) InvoiceLinePeriod, a BT-135 je dřívější než BT-134.Vyplňte platná data (YYYY-MM-DD): koncové datum větší nebo rovno počátečnímu datu. Pokud řádkové období není potřeba, vynechte celý blok cac:InvoiceLine/cac:InvoicePeriod (BG-26), nejen data. Prázdné nebo neplatné pole data se stále počítá jako přítomné. Vyplňte alespoň počáteční nebo koncové datum, pokud je skupina použita (BR-CO-20).

Základní kontrola R110 spočívá v tom, že počáteční datum řádkového období je rovno nebo později než počáteční datum fakturančního období. Pokud chyba přetrvává, i když řádkové období vypadá správně, zkontrolujte, zda problém není na úrovni dokumentu: buď je fakturanční období (BT-73) nastaveno příliš pozdě, nebo je řádkové období nezamýšleně širší, než bylo zamýšleno. Obě období se musí vzájemně zahrnovat: fakturanční období je vnější hranicí, každé řádkové období do ní musí spadat.

BR-30 (EN 16931) je jiné pravidlo než R110/R111: R110/R111 kontrolují, zda řádkové období spadá do fakturančního období, zatímco BR-30 kontroluje pouze pořadí dvou přítomných dat řádkového období (BT-135 větší nebo rovno BT-134).

Další pravidla pro období, která se mohou vyskytnout ve stejném kontextu:

  • BR-CO-19 / BR-CO-20: pokud se použije fakturanční období (BG-14), resp. řádkové období (BG-26), musí být vyplněno alespoň počáteční nebo koncové datum (jedno z obou stačí, obojí je také povoleno).
  • PEPPOL-EN16931-F001: všechna data musí být ve formátu YYYY-MM-DD.

Tato pravidla platí jak pro faktury (ubl:Invoice), tak pro dobropisy (ubl:CreditNote).

Validace při odesílání

Kromě manuálního validátoru provádí platforma eConnect automatickou validaci i v okamžiku odeslání. Pokud faktura nesplňuje požadavky, odeslání se zablokuje a dostanete chybové hlášení s příslušným validačním pravidlem.

Pro uživatele API: PSB validuje každou fakturu při odeslání a vrací výsledky validace v API odpovědi. Tak můžete validaci zabudovat i do vlastního softwarového procesu.

Sledování nových verzí

Validační pravidla se aktualizují při každé nové verzi specifikace Peppol BIS Billing. eConnect aktualizuje Schematron artefakty a seznamy kódů, jakmile se nová verze stane povinnou. Online validátor vždy validuje vůči aktuální verzi.

Tip: po aktualizaci specifikace zkontrolujte, zda jsou Vaše faktury stále platné. Nová pravidla mohou klást přísnější požadavky na pole, která byla dříve nepovinná.

Často kladené otázky
Co když moje faktura obsahuje chybu při validaci?

Validátor u každé chyby zobrazí přesný kód chyby, popis problému a umístění v XML souboru (XPath). Chyby musí být vyřešeny před odesláním, jinak bude faktura v síti Peppol odmítnuta. Varování jsou body k pozornosti, ale neblokují odeslání.

Jaké formáty může validátor zkontrolovat?

Validátor podporuje Peppol BIS Billing V3, NLCIUS/SI-UBL 2.0, všechny varianty PINT, XRechnung a CII (Cross-Industry Invoice, včetně Factur-X). Formát je rozpoznán automaticky při nahrání XML souboru.

Je moje faktura při odeslání také automaticky validována?

Ano. Platforma eConnect automaticky provádí validaci v okamžiku odeslání. Pokud faktura nesplňuje požadavky, odeslání se zablokuje s chybovým hlášením. Uživatelé API obdrží výsledky validace v API odpovědi.

Chcete si prohlédnout ukázkové soubory pro kontrolu vlastní XML struktury? Stáhnout ukázkové soubory.

Zvalidujte Vaši fakturu

Související
PreviousStruktura UBL faktury
NextUkázkové soubory