UBL vs. CII: Porovnanie dvoch syntaxí elektronickej fakturácie
UBL vs. CII: Porovnanie dvoch syntaxí elektronickej fakturácie
Ktokoľvek sa zaoberá elektronickou fakturáciou, rýchlo narazí na dve skratky: UBL a CII. Obe sú XML syntaxe, ktoré implementujú rovnakú európsku normu EN 16931, no zásadne sa líšia v svojej štruktúre. V tomto článku vysvetľujeme rozdiely, spoločné znaky a pomáhame vám rozhodnúť sa, ktorá syntax je pre váš prípad použitia vhodná.
Čo je EN 16931?
Pred ponorením sa do syntaxí krátky pohľad na rámec: Európska norma EN 16931 definuje sémantický dátový model pre elektronické faktúry. Popisuje, aké informácie musí elektronická faktúra obsahovať a aké obchodné pravidlá platia. Samotná norma je však nezávislá od syntaxe. Špecifikuje, čo musí faktúra obsahovať, ale nie ako má byť XML súbor štruktúrovaný.
Práve tu prichádzajú dve oficiálne syntaxe: UBL a CII.
UBL 2.1: Štandard OASIS
Universal Business Language (UBL) je XML formát vyvinutý normalizačnou organizáciou OASIS. UBL pokrýva oveľa viac než len faktúry. Definuje dokumenty pre celý proces obstarávania, od objednávok a dodacích listov po faktúry.
Vlastnosti UBL
- Menný priestor:
urn:oasis:names:specification:ubl:schema:xsd:Invoice-2 - Koreňový element:
<Invoice>(alebo<CreditNote>pre dobropisy) - Štruktúra: Plochá a modulárna s jasne pomenovanými elementmi
- Rozšírenosť: Široko používaný medzinárodne, najmä v Škandinávii, Holandsku a sieti Peppol
- XRechnung: XRechnung podporuje UBL ako jednu z dvoch povolených syntaxí
Prí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: Štandard UN/CEFACT
Cross-Industry Invoice (CII) spravuje UN/CEFACT (Centrum Organizácie Spojených národov pre uľahčenie obchodu a elektronického podnikania). CII je založený na referenčnom dátovom modeli dodávateľského reťazca (SCRDM) a používa hlbšie vnorenú štruktúru než UBL.
Vlastnosti CII
- Menný priestor:
urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100 - Koreňový element:
<CrossIndustryInvoice> - Štruktúra: Hlboko vnorená so zoskupenými kontextovými elementmi
- Rozšírenosť: Široko používaný v Nemecku a Francúzsku, základ pre ZUGFeRD a Factur-X
- ZUGFeRD: ZUGFeRD výhradne používa CII ako vložený XML formát
Prí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>
Kľúčové rozdiely
| Vlastnosť | UBL 2.1 | CII D16B |
|---|---|---|
| Normalizačný orgán | OASIS | UN/CEFACT |
| Hĺbka vnorenia | Plochejšia | Hlbšie vnorená |
| Formát dátumu | ISO 8601 (2025-07-25) | UN/EDIFACT Formát 102 (20250725) |
| Dobropis | Samostatný dokument CreditNote | Prostredníctvom TypeCode v rámci toho istého dokumentu |
| Kompatibilita so ZUGFeRD | Nie | Áno |
| Kompatibilita s Peppol | Áno (štandard) | Áno (voliteľná) |
| Kompatibilita s XRechnung | Áno | Áno |
Ktorú syntax by ste si mali vybrať?
Vyberte UBL, ak:
- Posielate faktúry prostredníctvom siete Peppol (UBL je tam štandardom)
- Pracujete medzinárodne s partnermi v Škandinávii alebo krajinách Beneluxu
- Posielate faktúry XRechnung klientom verejného sektora v Nemecku (obe syntaxe sú povolené, UBL je mierne bežnejší)
- Preferujete plochejšiu, čitateľnejšiu XML štruktúru
Vyberte CII, ak:
- Chcete vytvárať faktúry ZUGFeRD/Factur-X (CII je pre ne povinný)
- Pracujete s francúzskymi obchodnými partnermi (Factur-X je založený na CII)
- Potrebujete hybridné PDF s vloženými XML fakturačnými údajmi
Používanie oboch syntaxí s invapi
invapi plne podporuje UBL aj CII. Faktúry môžete vytvárať, konvertovať a validovať v oboch syntaxiach, všetko prostredníctvom jednotného API. Bezplatný XRechnung Validátor tiež automaticky zistí, či je faktúra UBL alebo CII, a validuje ju voči správnej sade pravidiel.
Ak si nie ste istí, ktorú syntax potrebujete, začnite s UBL pre čisté faktúry XRechnung alebo s CII, ak chcete generovať ZUGFeRD PDF. S invapi môžete kedykoľvek konvertovať medzi formátmi. Pozrite sa na náš cenník a nájdite správny plán pre vaše požiadavky.
Záver
UBL a CII sú dva rovnako platné spôsoby implementácie rovnakej európskej normy. Voľba závisí od vášho konkrétneho prípadu použitia: UBL pre medzinárodné scenáre a Peppol, CII pre ZUGFeRD a nemecko-francúzsky trh. So správnymi nástrojmi sa nemusíte viazať na jednu syntax, ale môžete flexibilne prepínať medzi oboma.