Kody błędów walidacji e-faktur
Co oznaczają kody błędów BR-*, PEPPOL-* i KSeF i jak je poprawić. Każdy kod objaśniony prostymi słowami – bez żargonu.
Podstawowe reguły EN 16931 (BR-*)
- BR-01Faktura nie ma identyfikatora specyfikacji (CustomizationID, BT-24) – odbiorca nie wie, według jakiego zestawu reguł została wystawiona.
- BR-02Faktura nie ma numeru (BT-1). Każda faktura musi mieć unikalny numer.
- BR-03Faktura nie ma daty wystawienia (BT-2).
- BR-04Faktura nie ma kodu typu (BT-3).
- BR-05Faktura nie ma kodu waluty (BT-5).
- BR-06Brakuje nazwy sprzedawcy (BT-27).
- BR-07Brakuje nazwy nabywcy (BT-44).
- BR-09Adres sprzedawcy nie ma kodu kraju (BT-40).
- BR-11Adres nabywcy nie ma kodu kraju (BT-55).
- BR-16Faktura nie ma żadnej pozycji – wymagana jest co najmniej jedna pozycja towaru lub usługi.
- BR-25Pozycja faktury nie ma nazwy towaru lub usługi (BT-153).
- BR-CL-04Kod waluty nie jest poprawnym kodem ISO 4217 – np. literówka albo małe litery.
- BR-CO-04Pozycja faktury nie ma kategorii VAT (BT-151).
- BR-CO-09Numer VAT nie ma dwuliterowego prefiksu kraju (np. PL, LT, DE).
- BR-CO-10Zadeklarowana suma pozycji netto (BT-106) nie równa się faktycznej sumie pozycji (BT-131).
- BR-CO-13Suma faktury bez VAT (BT-109) musi być równa: suma pozycji − rabaty na poziomie dokumentu + opłaty na poziomie dokumentu.
- BR-CO-14Łączna kwota VAT (BT-110) musi być równa sumie kwot wszystkich kategorii VAT (BT-117).
- BR-CO-15Suma z VAT (BT-112) musi być równa sumie bez VAT (BT-109) plus łączny VAT (BT-110).
- BR-CO-16Kwota do zapłaty (BT-115) musi być równa sumie z VAT (BT-112) minus kwota zapłacona (BT-113) plus zaokrąglenie (BT-114).
- BR-CO-17Kwota kategorii VAT (BT-117) nie równa się: podstawa (BT-116) × stawka (BT-119) / 100, po zaokrągleniu do 2 miejsc.
- BR-CO-26Sprzedawca nie ma żadnego identyfikatora: ani ID sprzedawcy (BT-29), ani numeru rejestrowego (BT-30), ani numeru VAT (BT-31). Nabywca nie może automatycznie zidentyfikować dostawcy.
- BR-S-08W podziale VAT dla stawki podstawowej podstawa opodatkowania nie zgadza się z sumą pozycji z tą stawką (± rabaty/opłaty dokumentu).
- BR-E-10Podział VAT oznaczony jako „zwolnione z VAT” nie ma przyczyny zwolnienia (kod BT-121 lub tekst BT-120).
- BR-08Dane sprzedawcy nie zawierają adresu pocztowego (BG-5).
- BR-10Dane nabywcy nie zawierają adresu pocztowego (BG-8).
- BR-12Faktura nie ma sumy pozycji netto (BT-106).
- BR-13Faktura nie ma sumy całkowitej bez VAT (BT-109).
- BR-14Faktura nie ma sumy całkowitej z VAT (BT-112).
- BR-15Faktura nie ma kwoty do zapłaty (BT-115).
- BR-CO-18Faktura nie ma żadnego podziału VAT (BG-23) – wymagany jest co najmniej jeden.
- BR-S-01Jest pozycja albo rabat / opłata ze stawką podstawową VAT (kategoria S), ale sprzedawca nie ma numeru VAT (BT-31).
- BR-S-05W pozycji ze stawką podstawową VAT (kategoria S) stawka wynosi 0 – stawka podstawowa musi być większa od zera.
- BR-AE-05W pozycji z odwrotnym obciążeniem (kategoria AE) stawka nie wynosi 0 – przy odwrotnym obciążeniu stawka musi być 0.
- BR-AE-10W podziale VAT z odwrotnym obciążeniem (AE) brakuje przyczyny – wymagany tekst „Reverse charge” (BT-120) lub kod (BT-121).
- BR-Z-05W pozycji ze stawką zerową VAT (kategoria Z) stawka nie wynosi 0.
- BR-CL-14Kod kraju nie jest poprawnym dwuliterowym kodem ISO 3166-1 (np. literówka albo małe litery).
- BR-CL-25Kod schematu adresu elektronicznego (EndpointID/@schemeID) nie pochodzi z oficjalnej listy CEF EAS.
Reguły Peppol BIS Billing 3.0
- PEPPOL-COMMON-R040Identyfikator zadeklarowano jako GLN (schemeID 0088), ale format nie spełnia reguł GS1: musi mieć 13 cyfr z poprawną cyfrą kontrolną.
- PEPPOL-EN16931-R001Brak procesu biznesowego (ProfileID) – Peppol go wymaga.
- PEPPOL-EN16931-R003Peppol wymaga referencji nabywcy albo numeru zamówienia – odbiorca używa ich do przypisania faktury.
- PEPPOL-EN16931-R004Identyfikator specyfikacji (CustomizationID) nie jest dokładną wartością Peppol BIS Billing 3.0.
- PEPPOL-EN16931-R008Dokument zawiera puste elementy XML. Peppol ich zabrania – element musi mieć wartość albo zostać usunięty.
- PEPPOL-EN16931-R010Brakuje adresu elektronicznego nabywcy (endpoint Peppol, BT-49).
- PEPPOL-EN16931-R020Brakuje adresu elektronicznego sprzedawcy (endpoint Peppol, BT-34).
- PEPPOL-EN16931-F001Data w dokumencie nie jest w formacie YYYY-MM-DD.
- PEPPOL-EN16931-R120Kwota netto pozycji nie równa się: ilość × (cena jednostkowa / ilość bazowa, do której odnosi się cena) + opłaty pozycji − rabaty pozycji.
Niemieckie reguły Peppol (DE-R-*)
- DE-R-001Gdy sprzedawca i nabywca są w Niemczech, faktura musi zawierać informacje o płatności (BG-16).
- DE-R-002Gdy sprzedawca i nabywca są w Niemczech, wymagana jest grupa danych kontaktowych sprzedawcy (BG-6).
- DE-R-003Gdy sprzedawca i nabywca są w Niemczech, wymagane jest miasto sprzedawcy (BT-37).
- DE-R-004Gdy sprzedawca i nabywca są w Niemczech, wymagany jest kod pocztowy sprzedawcy (BT-38).
- DE-R-005Gdy sprzedawca i nabywca są w Niemczech, wymagana jest osoba lub punkt kontaktowy sprzedawcy (BT-41).
- DE-R-006Gdy sprzedawca i nabywca są w Niemczech, wymagany jest telefon kontaktowy sprzedawcy (BT-42).
- DE-R-007Gdy sprzedawca i nabywca są w Niemczech, wymagany jest e-mail kontaktowy sprzedawcy (BT-43).
- DE-R-008Gdy sprzedawca i nabywca są w Niemczech, wymagane jest miasto nabywcy (BT-52).
- DE-R-009Gdy sprzedawca i nabywca są w Niemczech, wymagany jest kod pocztowy nabywcy (BT-53).
- DE-R-010Gdy sprzedawca i nabywca są w Niemczech i podano adres dostawy (BG-15), wymagane jest miasto dostawy (BT-77).
- DE-R-011Gdy sprzedawca i nabywca są w Niemczech i podano adres dostawy (BG-15), wymagany jest kod pocztowy dostawy (BT-78).
- DE-R-014Gdy sprzedawca i nabywca są w Niemczech, w każdej kategorii VAT wymagana jest stawka (BT-119).
- DE-R-015Gdy sprzedawca i nabywca są w Niemczech, wymagana jest referencja nabywcy (BT-10, w niemieckim B2G – Leitweg-ID).
- DE-R-016Gdy sprzedawca i nabywca są w Niemczech i użyto kodu VAT S/Z/E/AE/K/G/L/M, wymagany jest NIP sprzedawcy (BT-31), numer rejestracji podatkowej (BT-32) albo przedstawiciel podatkowy (BG-11).
- DE-R-017Gdy sprzedawca i nabywca są w Niemczech, kod typu faktury (BT-3) musi być jednym z: 326, 380, 381, 384, 389, 875, 876, 877.
- DE-R-018Gdy sprzedawca i nabywca są w Niemczech, skonto w warunkach płatności (BT-20) musi mieć ścisły format: #SKONTO#TAGE=n#PROZENT=n.nn#, wielkimi literami, bez spacji, wiersz kończy się # i znakiem nowej linii.
- DE-R-019Gdy sprzedawca i nabywca są w Niemczech, a kod sposobu płatności (BT-81) to 58 (SEPA), rachunek odbiorcy (BT-84) musi być poprawnym IBAN.
- DE-R-020Gdy sprzedawca i nabywca są w Niemczech, a kod sposobu płatności (BT-81) to 59 (polecenie zapłaty SEPA), rachunek obciążany (BT-91) musi być poprawnym IBAN.
- DE-R-022Gdy sprzedawca i nabywca są w Niemczech, nazwy plików załączników (BG-24, BT-125) muszą być unikalne (bez rozróżniania wielkości liter).
- DE-R-023-1Gdy sprzedawca i nabywca są w Niemczech, a sposób płatności to przelew (BT-81: 30 lub 58), wymagana jest grupa przelewu (BG-17).
- DE-R-023-2Gdy sprzedawca i nabywca są w Niemczech, a sposób płatności to przelew (BT-81: 30 lub 58), grupy karty (BG-18) i polecenia zapłaty (BG-19) są niedozwolone.
- DE-R-024-1Gdy sprzedawca i nabywca są w Niemczech, a płatność jest kartą (BT-81: 48, 54 lub 55), wymagana jest grupa danych karty (BG-18).
- DE-R-024-2Gdy sprzedawca i nabywca są w Niemczech, a płatność jest kartą (BT-81: 48, 54 lub 55), grupy przelewu (BG-17) i polecenia zapłaty (BG-19) są niedozwolone.
- DE-R-025-1Gdy sprzedawca i nabywca są w Niemczech, a sposób płatności to polecenie zapłaty (BT-81: 59), wymagana jest grupa polecenia zapłaty (BG-19).
- DE-R-025-2Gdy sprzedawca i nabywca są w Niemczech, a sposób płatności to polecenie zapłaty (BT-81: 59), grupy przelewu (BG-17) i karty (BG-18) są niedozwolone.
- DE-R-026Gdy sprzedawca i nabywca są w Niemczech, a typ faktury to 384 (faktura korygowana), wymagane jest co najmniej jedno odwołanie do poprzedniej faktury (BG-3).
- DE-R-027Gdy sprzedawca i nabywca są w Niemczech, telefon sprzedawcy (BT-42) musi być poprawny – co najmniej 3 cyfry.
- DE-R-028Gdy sprzedawca i nabywca są w Niemczech, e-mail sprzedawcy (BT-43) musi mieć dokładnie jeden znak @, bez spacji i kropek wokół niego, co najmniej 2 znaki po obu stronach; kropka nie może być pierwszym ani ostatnim znakiem.
- DE-R-030Gdy sprzedawca i nabywca są w Niemczech i używane jest polecenie zapłaty (BG-19), wymagany jest identyfikator wierzyciela SEPA (BT-90).
- DE-R-031Gdy sprzedawca i nabywca są w Niemczech i używane jest polecenie zapłaty (BG-19), wymagany jest rachunek obciążany (BT-91).
Kontrole KSeF FA(3)
- KSEF-SIZEPlik przekracza 1 MB. KSeF odrzuca faktury większe niż 1 MB (bez załączników).
- KSEF-BOMPlik zaczyna się od znacznika UTF-8 BOM. KSeF wymaga UTF-8 bez BOM.
- KSEF-NS-DRAFTFaktura używa wycofanej roboczej przestrzeni nazw FA(3) (2025-04-03), która wciąż krąży w sieci. Produkcyjny KSeF przyjmuje tylko ostateczną przestrzeń FA(3).
- KSEF-FA2To faktura FA(2). Produkcyjny KSeF odrzuca FA(2) od 2026-02-01 – przyjmowana jest tylko FA(3).
- KSEF-NIPSuma kontrolna NIP-u na fakturze się nie zgadza – najprawdopodobniej literówka. KSeF odrzuca faktury z błędnym NIP-em.
Struktura i format pliku
- FORMAT-NOT-XMLNie udało się odczytać pliku jako XML. To może być PDF, obraz albo plik uszkodzony lub ze zmienionym rozszerzeniem.
- FORMAT-CIIFaktura używa składni UN/CEFACT CII (ZUGFeRD/Factur-X, XRechnung w wariancie CII). Ten walidator sprawdza na razie tylko faktury UBL.
- FORMAT-UNKNOWNPlik jest XML-em, ale nie fakturą UBL ani fakturą korygującą – element główny jest inny.
- FORMAT-NON-PEPPOL-CIUSFaktura jest w UBL, ale deklaruje profil krajowy (np. XRechnung), a nie Peppol BIS Billing 3.0. Reguł krajowych na razie nie sprawdzamy.
- XSDStruktura XML nie odpowiada schematowi UBL 2.1: brakuje elementu, element ma literówkę albo stoi w złym miejscu. W UBL kolejność elementów ma znaczenie.
Sprawdź swój plik w walidatorze
Tiltima to narzędzie, a nie porada prawna ani podatkowa.