XRechnung 3.0

Niemcy · B2G aktywne, B2B 2027–2028

XRechnung to niemiecki CIUS na bazie EN 16931 — faktura UBL lub CII z rygorystycznymi niemieckimi regułami sektora publicznego, przede wszystkim obowiązkowym identyfikatorem trasowania (Leitweg-ID). Jest już wymagana przy fakturowaniu niemieckich instytucji publicznych, a wystawianie B2B staje się obowiązkowe etapami od 2027 roku.

Czym to jest

XRechnung 3.0.2 określa dokładne pola, listy kodów i reguły biznesowe, które musi spełniać niemiecka faktura, w składni UBL lub CII. Standard utrzymuje KoSIT, a CrateAPI waliduje względem własnych artefaktów walidacyjnych KoSIT — tych samych, których używa system Twojego odbiorcy.

Gdzie jest obowiązkowe

Niemcy: e-fakturowanie sektora publicznego (B2G) działa już dziś. Wystawianie B2B staje się obowiązkowe od 2027 roku dla firm z obrotem powyżej 800 tys. €, a od 2028 roku dla wszystkich — zobacz nasz tracker mandatów.

Czego nie robimy. Leitweg-ID — kod trasowania potrzebny niemieckiemu nabywcy publicznemu — mapuje się bezpośrednio na pole buyer_reference (BT-10) modelu kanonicznego. To standardowe pole EN 16931, które XRechnung po prostu czyni obowiązkowym, a nie specyficzny dodatek XRechnung.

Wypróbuj

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

Istotne endpointy

Endpoint	Uwagi
`POST /v1/generate/ubl?profile=xrechnung`	Składnia UBL, reguły XRechnung 3.0.2.
`POST /v1/generate/cii?profile=xrechnung`	Składnia CII — te same reguły, inna postać XML.
`POST /v1/validate/{ubl,cii}?profile=xrechnung`darmowe	Własne artefakty walidacyjne KoSIT, te same, względem których sprawdza Twój odbiorca.
`POST /v1/render/{html,pdf}?lang=de`	Dla faktur, które otrzymujesz i nie możesz odczytać jako surowego XML.

Przykłady i dokumentacja

Pobierz zwalidowany przykład XRechnung z naszej biblioteki przykładów lub przeczytaj pełną dokumentację API.

FAQ

UBL czy CII dla XRechnung?

Dowolne — XRechnung jest zdefiniowany w obu składniach, a CrateAPI generuje i waliduje obie. Użyj tej, której oczekuje Twój partner handlowy lub portal.

Czy to to samo co ZUGFeRD?

Nie, ale jest powiązane: ZUGFeRD 2.x to niemiecki hybrydowy format PDF+XML, dzielący rdzeń XML (CII) z Factur-X. Dla wariantu hybrydowego PDF zamiast czystego XML zobacz naszą stronę Factur-X.

Czy potrzebuję specjalnego pola dla Leitweg-ID?

Nie — to standardowe pole buyer_reference (BT-10) modelu kanonicznego, które XRechnung czyni obowiązkowym, a inne profile pozostawiają opcjonalnym.

Wypróbuj darmowy walidator Przeczytaj dokumentację