UN/CEFACT CII D16B

Składnia wewnątrz Factur-X i XRechnung

Cross Industry Invoice (CII) D16B to druga, obok UBL, składnia XML EN 16931 — schemat jednodokumentowy leżący u podstaw zarówno hybrydowego formatu PDF Factur-X/ZUGFeRD, jak i jednej z dwóch prawidłowych składni XRechnung.

Czym to jest

Tam gdzie UBL rozdziela faktury i noty korygujące na osobne elementy główne, CII przedstawia obie jako jeden dokument CrossIndustryInvoice, rozróżniany kodem typu. CrateAPI generuje i waliduje czysty XML CII bezpośrednio — nie trzeba przechodzić przez Factur-X, aby go uzyskać.

Gdzie jest obowiązkowe

Rzadko wybiera się CII samodzielnie — pojawia się jako składnia wewnątrz Factur-X (Francja), jako jedna z dwóch prawidłowych składni XRechnung (Niemcy), albo gdy system partnera handlowego jest natywnie CII i trzeba przekonwertować z UBL.

Czego nie robimy. CII i UBL obejmują ten sam model semantyczny EN 16931, tylko w innej postaci XML — dlatego konwersja między nimi jest bezstratna albo odrzucona, a nie stratnym przybliżeniem.

Wypróbuj

curl -X POST "$BASE/v1/generate/cii?profile=en16931" \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d @invoice.json -o invoice.xml

Istotne endpointy

Endpoint	Uwagi
`POST /v1/generate/cii?profile=en16931\|xrechnung`	Profil en16931 lub xrechnung — ten sam silnik co po stronie UBL.
`POST /v1/validate/cii?profile=en16931\|xrechnung`darmowe	Oficjalne reguły schematron + XSD, ustrukturyzowane ustalenia.
`POST /v1/convert/{ubl-to-cii,cii-to-ubl}`	Bezstratnie albo odrzucona — 422 z dokładnymi nieobsługiwanymi funkcjami, nigdy cicha degradacja.
`POST /v1/render/{html,pdf}`	CII wykrywany automatycznie obok UBL, bez potrzeby osobnej flagi.

Przykłady i dokumentacja

Pobierz zwalidowane przykładowe pliki CII (fakturę i notę korygującą) z naszej biblioteki przykładów lub przeczytaj pełną dokumentację API.

FAQ

Czy powinienem użyć UBL czy CII?

Jeśli masz wolny wybór, UBL/Peppol to bardziej powszechna, domyślna opcja ogólnoeuropejska. Użyj CII, gdy wymaga tego partner handlowy, lub gdy potrzebujesz Factur-X/ZUGFeRD albo opcji CII w XRechnung.

Czy mogę konwertować między UBL a CII?

Tak — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, bezstratnie albo odrzucona: jeśli funkcja nie przetrwa konwersji, otrzymujesz błąd 422 z dokładną listą, nigdy po cichu zdegradowaną fakturę.

Czy CII obsługuje noty korygujące?

Tak, ten sam typ dokumentu z innym kodem typu — zobacz grupę CII w naszej bibliotece przykładów, zarówno dla faktury, jak i noty korygującej.

Wypróbuj darmowy walidator Przeczytaj dokumentację