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.
| Jednostka | Kod | Uwaga |
|---|---|---|
| Sztuka | C62 | „one”, w Niemczech najczęściej dla sztuki |
| Sztuka (alternatywa) | H87 | „piece”, również prawidłowy |
| Ryczałt | LS | „lump sum”; alternatywnie C62 z ilością 1 |
| Godzina | HUR | dla usług, czasu pracy |
| Dzień | DAY | |
| Tydzień | WEE | |
| Miesiąc | MON | np. najem, abonament |
| Rok | ANN | |
| Kilogram | KGM | |
| Gram | GRM | |
| Tona (metryczna) | TNE | |
| Metr | MTR | |
| Centymetr | CMT | |
| Kilometr | KMT | koszty przejazdu, logistyka |
| Metr kwadratowy | MTK | |
| Metr sześcienny | MTQ | |
| Litr | LTR | |
| Para | PR | |
| Zestaw / komplet | SET | |
| Kilowatogodzina | KWH | rozliczenie 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:InvoicedQuantityatrybutunitCode, czyli<cbc:InvoicedQuantity unitCode="C62">2</cbc:InvoicedQuantity> - ZUGFeRD / CII: przy elemencie
ram:BilledQuantityatrybutunitCode, 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 w | Kod |
|---|---|
| Liczba sztuk (towary, artykuły) | C62 (lub H87) |
| Godziny pracy, doradztwo | HUR |
| Ryczałty, ceny stałe | LS (lub C62, ilość 1) |
| Masa | KGM, GRM, TNE |
| Długości, metry bieżące | MTR, KMT |
| Powierzchnie, objętości | MTK, 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.
Darmowe narzędzia
Powiązane artykuły
Konwertuj swoje faktury PDF teraz
Wypróbuj TaxLayer za darmo – 2 konwersje miesięcznie, bez karty kredytowej.
Rozpocznij