UBL vs. CII: Porównanie dwóch składni e-fakturowania

Każdy, kto ma do czynienia z e-fakturowaniem, szybko natknie się na dwa skróty: UBL i CII. Obie to składnie oparte na XML, które implementują ten sam europejski standard EN 16931, ale różnią się zasadniczo strukturą. W tym artykule wyjaśniamy różnice, podobieństwa i pomagamy zdecydować, która składnia jest odpowiednia dla Twojego przypadku użycia.

Czym jest EN 16931?

Zanim zagłębimy się w składnie, krótkie spojrzenie na ramy: Europejski standard EN 16931 definiuje semantyczny model danych dla faktur elektronicznych. Opisuje, jakie informacje musi zawierać e-faktura i jakie reguły biznesowe obowiązują. Jednak sam standard jest niezależny od składni. Określa, co musi być zawarte w fakturze, ale nie jak plik XML powinien być zbudowany.

Tu wkraczają dwie oficjalne składnie: UBL i CII.

UBL 2.1: Standard OASIS

Universal Business Language (UBL) to format XML opracowany przez organizację normalizacyjną OASIS. UBL obejmuje znacznie więcej niż tylko faktury. Definiuje dokumenty dla całego procesu zaopatrzenia, od zamówień i awiza wysyłkowego po faktury.

Cechy UBL

• Przestrzeń nazw: urn:oasis:names:specification:ubl:schema:xsd:Invoice-2
• Element główny: <Invoice> (lub <CreditNote> dla not kredytowych)
• Struktura: Płaska i modułowa z jasno nazwanymi elementami
• Adopcja: Szeroko stosowany na arenie międzynarodowej, szczególnie w Skandynawii, Holandii i sieci Peppol
• XRechnung: XRechnung obsługuje UBL jako jedną z dwóch dozwolonych składni

Przykład (uproszczony)

<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) jest utrzymywany przez UN/CEFACT (Centrum Ułatwiania Handlu i Biznesu Elektronicznego ONZ). CII opiera się na Supply Chain Reference Data Model (SCRDM) i wykorzystuje bardziej głęboko zagnieżdżoną strukturę niż UBL.

Cechy CII

• Przestrzeń nazw: urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100
• Element główny: <CrossIndustryInvoice>
• Struktura: Głęboko zagnieżdżona z pogrupowanymi elementami kontekstowymi
• Adopcja: Szeroko stosowany w Niemczech i Francji, podstawa ZUGFeRD i Factur-X
• ZUGFeRD: ZUGFeRD wykorzystuje wyłącznie CII jako osadzony format XML

Przykład (uproszczony)

<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>

Kluczowe różnice

Którą składnię wybrać?

Wybierz UBL, jeśli:

• Wysyłasz faktury przez sieć Peppol (UBL jest tam standardem)
• Pracujesz międzynarodowo z partnerami w Skandynawii lub krajach Beneluksu
• Wysyłasz faktury XRechnung do klientów z sektora publicznego w Niemczech (obie składnie są dozwolone, UBL jest nieco bardziej popularny)
• Preferujesz bardziej płaską, czytelną strukturę XML

Wybierz CII, jeśli:

• Chcesz tworzyć faktury ZUGFeRD/Factur-X (CII jest dla nich obowiązkowy)
• Pracujesz z francuskimi partnerami biznesowymi (Factur-X bazuje na CII)
• Potrzebujesz hybrydowego PDF z osadzonymi danymi fakturowymi XML

Korzystanie z obu składni z invapi

invapi w pełni obsługuje zarówno UBL, jak i CII. Możesz tworzyć, konwertować i walidować faktury w obu składniach — wszystko przez jedno ujednolicone API. Darmowy walidator XRechnung automatycznie wykrywa, czy faktura jest w formacie UBL czy CII, i waliduje ją według odpowiedniego zestawu reguł.

Jeśli nie jesteś pewien, której składni potrzebujesz, zacznij od UBL dla czystych faktur XRechnung lub od CII, jeśli chcesz generować pliki ZUGFeRD PDF. Z invapi możesz w każdej chwili konwertować między formatami. Sprawdź nasz cennik, aby znaleźć odpowiedni plan dla swoich wymagań.

Podsumowanie

UBL i CII to dwa równoważne sposoby implementacji tego samego europejskiego standardu. Wybór zależy od Twojego konkretnego przypadku użycia: UBL dla scenariuszy międzynarodowych i Peppol, CII dla ZUGFeRD i rynku niemiecko-francuskiego. Z odpowiednimi narzędziami nie musisz ograniczać się do jednej składni, lecz możesz elastycznie przełączać się między obiema.