TaxLayer
Technika2026-11-117 min czytaniaprzez TaxLayer Team

Jednostka miary w XRechnung i ZUGFeRD: właściwe kody jednostek (BT-130, UN/ECE Rec 20)

Niepozorne pole przekreśla wiele świeżo wygenerowanych e-faktur: jednostka miary. „2 sztuki”, „8 godz.” czy „1 ryczałt” na papierze brzmi jednoznacznie, ale w ustrukturyzowanej e-fakturze liczy się nie tekst, lecz kod ze stałej listy. Jeśli zamiast kodu stoi „sztuka”, walidator odrzuca plik. Ten poradnik pokazuje, jakich kodów jednostek wymaga EN 16931 w polu BT-130, gdzie leżą częste pułapki i jak sprawdzić jednostkę przed wysyłką.

> Krótka odpowiedź: Każda pozycja faktury wymaga w polu BT-130 kodu jednostki miary z listy UN/ECE Rec 20. Sztuka to C62 (lub H87), godzina HUR, dzień DAY, kilogram KGM, metr MTR, metr kwadratowy MTK, litr LTR, ryczałt LS. Dowolny tekst, jak „sztuka”, „godz.” czy „ryczałt”, nie jest prawidłowym kodem i prowadzi przez regułę BR-23 do odrzucenia. W ZUGFeRD i XRechnung jednostka występuje jako atrybut unitCode przy ilości.

Dlaczego jednostka to kod, a nie tekst

Na fakturze PDF jednostka miary jest słowem: sztuka, godziny, kilogramy, ryczałt. E-faktura zgodna z EN 16931 jest natomiast zbiorem danych czytelnym maszynowo. Aby każdy system odbiorcy jednoznacznie rozumiał „8 HUR” jako osiem godzin, niezależnie od tego, czy faktura pochodzi z Monachium, czy z Lizbony, norma nie przewiduje dla jednostki dowolnego tekstu, lecz kod z międzynarodowo uzgodnionej listy.

To pole nazywa się w EN 16931 BT-130 (Invoiced quantity unit of measure code), po polsku jednostka fakturowanej ilości. Reguła BR-23 wymaga go dla każdej pozycji faktury: „Pozycja faktury (BG-25) musi zawierać kod jednostki miary fakturowanej ilości (BT-130).” Jeśli kodu brakuje lub jest nieprawidłowy, plik nie jest zgodny.

Lista kodów: UN/ECE Recommendation 20

Dozwolone wartości pochodzą z UN/ECE Recommendation 20, uzupełnionej o kody z Recommendation 21 (są oznaczone poprzedzającą literą X). To ta sama lista, z której od dziesięcioleci korzystają EDIFACT i wiele systemów ERP. W codziennym fakturowaniu potrzebują Państwo tylko jej niewielkiego wycinka.

JednostkaKodUwaga
SztukaC62„one”, w Niemczech najczęściej dla sztuki
Sztuka (alternatywa)H87„piece”, również prawidłowy
RyczałtLS„lump sum”; alternatywnie C62 z ilością 1
GodzinaHURdla usług, czasu pracy
DzieńDAY
TydzieńWEE
MiesiącMONnp. najem, abonament
RokANN
KilogramKGM
GramGRM
Tona (metryczna)TNE
MetrMTR
CentymetrCMT
KilometrKMTkoszty przejazdu, logistyka
Metr kwadratowyMTK
Metr sześciennyMTQ
LitrLTR
ParaPR
Zestaw / kompletSET
KilowatogodzinaKWHrozliczenie energii

Te dobre dwadzieścia kodów pokrywa większość faktur rzemieślniczych, handlowych i usługowych. Pełna lista obejmuje kilkaset pozycji, od kartonu po beczkę, które w codziennym fakturowaniu pojawiają się rzadko.

Najczęstszy błąd: dowolny tekst zamiast kodu

Zdecydowanie najczęstszym błędem dotyczącym jednostek jest to, że widoczny tekst faktury PDF przechodzi bez zmian do pola kodu. Konwerter, który odczytuje kolumnę „Jednostka” i przejmuje jej zawartość jeden do jednego, wpisuje wtedy „sztuka”, „godz.” lub „ryczałt” do atrybutu unitCode. Wynik nie jest prawidłowym kodem i nie przechodzi kontroli list kodów, zwykle jako błąd schematu lub Schematron w okolicy BR-23.

Typowe nieprawidłowe wartości i ich prawidłowy kod:

  • „sztuka”, „szt”, „szt.”, „x” → C62
  • „godz”, „godz.”, „godzina”, „h” → HUR
  • „ryczałt”, „rycz.”, „ryczałtowo” → LS (lub C62, ilość 1)
  • „kg”, „Kg” → KGM
  • „m”, „mb” (metr bieżący) → MTR
  • „m2”, „m²” → MTK

Proszę pamiętać: kody częściowo rozróżniają wielkość liter i muszą występować dokładnie tak, jak są prowadzone na liście. „c62” małymi literami lub „Hur” jest tak samo nieprawidłowe jak wypisany tekst.

C62 czy H87? Kwestia sztuki

Dla sztuki istnieją dwa powszechne kody: C62 (na liście jako „one”) i H87 („piece”). Oba są prawidłowe i akceptowane przez urzędowe walidatory. W niemieckiej praktyce ZUGFeRD i XRechnung jako standard przyjął się C62, wiele systemów ERP i księgowych oczekuje tej wartości. Dopóki konsekwentnie używają Państwo prawidłowego kodu, żaden z wariantów nie jest błędny. W razie wątpliwości proszę kierować się tym, co odczytuje system odbiorcy u Państwa klienta, lub pozostać przy C62.

BT-130 i BT-150: ilość i podstawa ceny

Oprócz fakturowanej ilości EN 16931 zna drugie pole ilości: bazową ilość ceny (Base quantity, jednostka w BT-150). Opisuje, do jakiej ilości odnosi się cena jednostkowa, na przykład „cena za 100 sztuk” lub „za litr”. Oba pola czerpią jednostkę z tej samej listy UN/ECE Rec 20.

Obie jednostki powinny dla danej pozycji do siebie pasować. Jeśli rozliczają Państwo usługę w godzinach (BT-130 = HUR), nie ma sensu podawać podstawy ceny w sztukach (BT-150 = C62). Gdy ilość, jednostka i podstawa ceny się nie zgadzają, nie zgadza się rachunkowa kontrola ilość razy cena jednostkowa równa się kwota pozycji, a reakcję wywołują kolejne reguły, jak kontrola sum. Jakich pól obowiązkowych wymaga pozycja poza tym, wymienia EN 16931: wszystkie pola obowiązkowe.

Gdzie jednostka znajduje się w XML

Jednostka miary nie jest w żadnej z obu składni osobnym elementem, lecz atrybutem przy podaniu ilości. Łatwo to przeoczyć w plikach tworzonych ręcznie:

  • XRechnung / UBL: przy elemencie cbc:InvoicedQuantity atrybut unitCode, czyli <cbc:InvoicedQuantity unitCode="C62">2</cbc:InvoicedQuantity>
  • ZUGFeRD / CII: przy elemencie ram:BilledQuantity atrybut unitCode, czyli <ram:BilledQuantity unitCode="C62">2</ram:BilledQuantity>

Semantycznie jedno i drugie to BT-130. To, że UBL i CII nazywają tę samą informację różnie, jest normalnym przypadkiem w EN 16931; tło wyjaśnia XRechnung: UBL czy CII?.

Sprawdzenie przed wysyłką

Jednostka należy do pól, które wychodzą na jaw dopiero przy walidacji, ponieważ na wydruku wyglądają prawidłowo. Każdy plik proszę sprawdzić przed wysyłką za pomocą bezpłatnego walidatora ZUGFeRD i XRechnung, który działa w przeglądarce, bez opuszczania faktury z Państwa komputera. Komunikat o błędzie dotyczący unitCode lub BR-23 można sprawdzić w spisie kodów błędów XRechnung. Taką samą staranność warto zachować przy pokrewnych polach pozycji, takich jak data dostawy (BT-72) i numery artykułów (BT-155, BT-156), które automatyczne konwertery również chętnie wypełniają błędnie.

Jak uniknąć błędu jednostki

Kto przekształca faktury z istniejącego pliku PDF w e-fakturę, powinien zadbać o to, aby jednostka nie była przekazywana jako tekst, lecz odwzorowana na prawidłowy kod. TaxLayer rozpoznaje jednostkę miary dla każdej pozycji z dokumentu, przypisuje ją do odpowiedniego kodu UN/ECE (sztuka do C62, godziny do HUR i tak dalej) i wyświetla ją na etapie weryfikacji, zanim powstanie plik ZUGFeRD lub XRechnung. Dzięki temu żadna „sztuka” ani „ryczałt” nie trafia niesprawdzona do pola kodu, a plik przechodzi kontrolę według BR-23. To pragmatyczna opcja dla firm, których system źródłowy nie wydaje prawidłowego kodu.

Najważniejsze kody w skrócie

Rozliczane wKod
Liczba sztuk (towary, artykuły)C62 (lub H87)
Godziny pracy, doradztwoHUR
Ryczałty, ceny stałeLS (lub C62, ilość 1)
MasaKGM, GRM, TNE
Długości, metry bieżąceMTR, KMT
Powierzchnie, objętościMTK, MTQ, LTR
Okresy (najem, abonament)DAY, WEE, MON, ANN

---

Jednostka miary to małe, ale twarde pole obowiązkowe EN 16931: bez prawidłowego kodu z UN/ECE Rec 20 nie ma zgodnej e-faktury. W TaxLayer jednostka jest automatycznie odwzorowywana na właściwy kod i sprawdzana przed wygenerowaniem, dzięki czemu błąd dowolnego tekstu w ogóle nie powstaje. Przetestuj teraz bezpłatnie, pierwsze 2 konwersje miesięcznie są gratis. Pytania prosimy kierować na info@taxlayer.de.

Najczęściej zadawane pytania

Jaki kod w XRechnung oznacza sztukę?

Powszechne są C62 („one”) i H87 („piece”). Oba to prawidłowe kody z UN/ECE Rec 20. W niemieckiej praktyce ZUGFeRD i XRechnung najbardziej rozpowszechniony jest C62. Ważne jest tylko, aby podany był prawidłowy kod, a nie dowolny tekst „sztuka” czy „szt.”.

Dlaczego moja e-faktura jest odrzucana z powodu jednostki?

Ponieważ w polu BT-130 znajduje się nieprawidłowa wartość. Zgodnie z regułą BR-23 każda pozycja musi zawierać kod jednostki miary z listy UN/ECE Rec 20. Dowolny tekst, jak „sztuka”, „godz.”, „ryczałt” czy „x”, nie jest prawidłowym kodem i prowadzi do błędu schematu lub Schematron.

Jaki kod obowiązuje dla ryczałtu?

Dla prawdziwego ryczałtu przewidziany jest kod LS („lump sum”). W praktyce wielu wystawców faktur zamiast tego stosuje C62 z ilością 1. Obie drogi są formalnie prawidłowe, o ile podany jest dozwolony kod.

Jaka jest różnica między BT-130 a BT-150?

BT-130 to jednostka fakturowanej ilości (Invoiced quantity unit of measure), BT-150 to jednostka bazowej ilości ceny (Base quantity). Oba pola czerpią wartości z tej samej listy UN/ECE Rec 20 i powinny być dla danej pozycji ze sobą zgodne, aby ilość razy cena jednostkowa się zgadzała.

Jak nazywa się to pole w XML?

Jednostka nie jest osobnym elementem, lecz atrybutem unitCode przy ilości. W XRechnung/UBL występuje jako cbc:InvoicedQuantity unitCode="C62", w ZUGFeRD/CII jako ram:BilledQuantity unitCode="C62".

Czy istnieją kody dla godzin, dni i kilometrów?

Tak. Godzina to HUR, dzień DAY, tydzień WEE, miesiąc MON, rok ANN, a kilometr KMT. Dla masy, powierzchni i objętości także istnieją stałe kody, na przykład KGM dla kilograma lub MTK dla metra kwadratowego.

Konwertuj swoje faktury PDF teraz

Wypróbuj TaxLayer za darmo – 2 konwersje miesięcznie, bez karty kredytowej.

Rozpocznij