UBL vs. CII: Srovnání dvou syntaxí e-fakturace
UBL vs. CII: Srovnání dvou syntaxí e-fakturace
Každý, kdo se zabývá e-fakturací, brzy narazí na dvě zkratky: UBL a CII. Obě jsou syntaxe založené na XML, které implementují tutéž evropskou normu EN 16931, přesto se zásadně liší ve své struktuře. V tomto článku vysvětlujeme rozdíly, společné rysy a pomáháme vám rozhodnout, která syntaxe je pro váš případ použití správná.
Co je EN 16931?
Než se ponoříme do syntaxí, krátký pohled na rámec: Evropská norma EN 16931 definuje sémantický datový model pro elektronické faktury. Popisuje, jaké informace musí e-faktura obsahovat a jaká obchodní pravidla platí. Norma sama je však syntakticky nezávislá. Specifikuje, co musí faktura obsahovat, ale ne jak má být XML soubor strukturován.
Právě zde přicházejí na řadu dvě oficiální syntaxe: UBL a CII.
UBL 2.1: Standard OASIS
Universal Business Language (UBL) je XML formát vyvinutý normalizační organizací OASIS. UBL pokrývá mnohem více než jen faktury. Definuje dokumenty pro celý nákupní proces, od objednávek a dodacích listů po faktury.
Vlastnosti UBL
- Jmenný prostor:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 - Kořenový element:
<Invoice>(nebo<CreditNote>pro dobropisy) - Struktura: Plochá a modulární s jasně pojmenovanými elementy
- Rozšíření: Široce používán mezinárodně, zejména ve Skandinávii, Nizozemsku a síti Peppol
- XRechnung: XRechnung podporuje UBL jako jednu ze dvou povolených syntaxí
Příklad (zjednodušený)
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
<cbc:ID>INV-2025-001</cbc:ID>
<cbc:IssueDate>2025-07-25</cbc:IssueDate>
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Muster GmbH</cbc:Name>
</cac:PartyName>
</cac:Party>
</cac:AccountingSupplierParty>
</Invoice>
CII D16B: Standard UN/CEFACT
Cross-Industry Invoice (CII) je spravován organizací UN/CEFACT (Centrum Organizace spojených národů pro usnadnění obchodu a elektronické podnikání). CII je založen na modelu Supply Chain Reference Data Model (SCRDM) a používá hlouběji vnořenou strukturu než UBL.
Vlastnosti CII
- Jmenný prostor:
urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100 - Kořenový element:
<CrossIndustryInvoice> - Struktura: Hluboce vnořená se seskupenými kontextovými elementy
- Rozšíření: Široce používán v Německu a Francii, základ pro ZUGFeRD a Factur-X
- ZUGFeRD: ZUGFeRD výhradně používá CII jako svůj vložený XML formát
Příklad (zjednodušený)
<rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100">
<rsm:ExchangedDocument>
<ram:ID>INV-2025-001</ram:ID>
<ram:IssueDateTime>
<udt:DateTimeString format="102">20250725</udt:DateTimeString>
</ram:IssueDateTime>
</rsm:ExchangedDocument>
</rsm:CrossIndustryInvoice>
Klíčové rozdíly
| Vlastnost | UBL 2.1 | CII D16B |
|---|---|---|
| Normalizační orgán | OASIS | UN/CEFACT |
| Hloubka vnořování | Plošší | Hlouběji vnořený |
| Formát data | ISO 8601 (2025-07-25) | UN/EDIFACT Formát 102 (20250725) |
| Dobropis | Samostatný dokument CreditNote | Prostřednictvím TypeCode v rámci jednoho dokumentu |
| Kompatibilita se ZUGFeRD | Ne | Ano |
| Kompatibilita s Peppol | Ano (standard) | Ano (volitelně) |
| Kompatibilita s XRechnung | Ano | Ano |
Kterou syntaxi byste měli zvolit?
Zvolte UBL, pokud:
- Zasíláte faktury prostřednictvím sítě Peppol (UBL je zde standardem)
- Spolupracujete mezinárodně s partnery ve Skandinávii nebo zemích Beneluxu
- Zasíláte XRechnung faktury klientům z veřejného sektoru v Německu (obě syntaxe jsou povoleny, UBL je mírně běžnější)
- Dáváte přednost plošší, čitelnější XML struktuře
Zvolte CII, pokud:
- Chcete vytvářet ZUGFeRD/Factur-X faktury (CII je pro ně povinný)
- Spolupracujete s francouzskými obchodními partnery (Factur-X je založen na CII)
- Potřebujete hybridní PDF s vloženými XML fakturačními daty
Použití obou syntaxí s invapi
invapi plně podporuje jak UBL, tak CII. Můžete vytvářet, konvertovat a validovat faktury v obou syntaxích, vše prostřednictvím jednotného API. Bezplatný XRechnung Validátor také automaticky detekuje, zda je faktura UBL nebo CII, a validuje ji podle správné sady pravidel.
Pokud si nejste jisti, kterou syntaxi potřebujete, začněte s UBL pro čisté XRechnung faktury nebo s CII, pokud chcete generovat ZUGFeRD PDF. S invapi můžete kdykoli konvertovat mezi formáty. Podívejte se na naši stránku s cenami a najděte správný plán pro vaše požadavky.
Závěr
UBL a CII jsou dva rovnocenné způsoby implementace téže evropské normy. Volba závisí na vašem konkrétním případu použití: UBL pro mezinárodní scénáře a Peppol, CII pro ZUGFeRD a německo-francouzský trh. Se správnými nástroji se nemusíte vázat na jedinou syntaxi, ale můžete flexibilně přepínat mezi oběma.