Błędy KSeF: statusy faktury i jak je naprawić

Gdy KSeF odrzuca fakturę, status w sesji podaje kod: 450 dla błędu semantyki, 440 dla duplikatu, 430 dla błędu pliku. Tu znajdziesz każdy status faktury z dokumentacji KSeF 2.0, jego przyczyny i sposób naprawy, a także kontrole, które nasz walidator wykonuje na pliku FA(3) w przeglądarce, zanim go wyślesz

Kontrole walidatora na pliku (komunikaty po angielsku)

  • XV-PL-01 KSeF rejects an invoice with an XML processing instruction (…); leave out instructions such as xml-stylesheet (KSeF 2.0, weryfikacja faktury). Szczegóły →
  • XV-PL-02 KSeF rejects an invoice with a discouraged Unicode character: U+… in … (KSeF 2.0, weryfikacja faktury). Szczegóły →
  • XV-PL-03 The NIP … of … has no valid check digit; KSeF's production environment rejects the invoice (KSeF 2.0, weryfikacja faktury). Szczegóły →
  • XV-PL-04 The internal identifier … of Podmiot3 starts with a NIP that has no valid check digit; KSeF's production environment rejects the invoice (KSeF 2.0, weryfikacja faktury). Szczegóły →
  • XV-PL-05 KSeF accepts an invoice with an attachment (Zalacznik) only from a seller who has registered the option in e-Urząd Skarbowy, and only in a batch session (KSeF 2.0, weryfikacja faktury). ostrzeżenie Szczegóły →
  • XV-PL-10 An invoice in PLN has no converted tax (…); those fields are for an invoice in a foreign currency (FA(3) information sheet, P_14_1W). Szczegóły →
  • XV-PL-11 An invoice in … must give its tax in PLN as well; missing: … (VAT Act, art. 106e ust. 11; FA(3) information sheet, P_14_1W). Szczegóły →
  • XV-PL-12 P_15 (…) must be the sum of the net amounts P_13_1 to P_13_11 and the tax P_14_1 to P_14_5 (…) (FA(3) information sheet, P_15). Szczegóły →
  • XV-PL-13 The tax is not the rate applied to its net amount: … (rates 23 or 22, 8 or 7, 5 %; per line rounding allowed) (FA(3) information sheet, P_14_1). ostrzeżenie Szczegóły →
  • XV-PL-14 The sums per rate do not match the lines: …. Each P_13 field is the sum of the net values (P_11) of the lines at its rate, or of their gross values (P_11A) less the tax (FA(3) information sheet, P_13_1, P_11). Szczegóły →
  • XV-PL-15 A corrective invoice (…) must name the invoice it corrects in DaneFaKorygowanej (VAT Act, art. 106j ust. 2; FA(3) information sheet, DaneFaKorygowanej). Szczegóły →
  • XV-PL-16 … belong to a corrective invoice (KOR, KOR_ZAL, KOR_ROZ), not to … (FA(3) information sheet, PrzyczynaKorekty). Szczegóły →
  • XV-PL-17 StanPrzed belongs to a correction of an invoice or a final invoice (KOR, KOR_ROZ), StanPrzedZ and KursWalutyZK to a correction of an advance invoice (KOR_ZAL), and P_15ZK to a correction of an advance or final invoice (KOR_ZAL, KOR_ROZ); this one is … (FA(3) information sheet, StanPrzed, P_15ZK). Szczegóły →
  • XV-PL-18 A final invoice (ROZ) must name the advance invoices it settles in FakturaZaliczkowa (VAT Act, art. 106f ust. 3; FA(3) information sheet, NrFaZaliczkowej). Szczegóły →
  • XV-PL-19 An advance invoice (ZAL) must describe the order or contract and its value in Zamowienie (VAT Act, art. 106f ust. 1 pkt 4; FA(3) information sheet, Zamowienie). Szczegóły →
  • XV-PL-20 Zamowienie is for an advance invoice (ZAL) and its correction (KOR_ZAL), not for … (FA(3) information sheet, Zamowienie). Szczegóły →
  • XV-PL-21 WartoscZamowienia (…) must be the sum of P_11NettoZ and P_11VatZ of the order lines (…) (FA(3) information sheet, WartoscZamowienia). Szczegóły →
  • XV-PL-22 A simplified invoice (UPR) may be issued up to PLN 450 or EUR 100 due; P_15 is … … (VAT Act, art. 106e ust. 5 pkt 3). Szczegóły →
  • XV-PL-23 An invoice other than a simplified one must give the buyer's name and address (Podmiot2: Nazwa and Adres); only a simplified invoice (UPR) up to PLN 450 may name the buyer by NIP alone (VAT Act, art. 106e ust. 1 pkt 3; FA(3) information sheet, Podmiot2). Szczegóły →
  • XV-PL-24 JST 1 (the invoice concerns a subordinate local government unit) needs that unit in Podmiot3 with Rola 8, so that it receives the invoice in KSeF (FA(3) information sheet, JST). Szczegóły →
  • XV-PL-25 GV 1 (the invoice concerns a member of a VAT group) needs that member in Podmiot3 with Rola 10, so that it receives the invoice in KSeF (FA(3) information sheet, GV). Szczegóły →
  • XV-PL-26 An invoice with sales under the margin scheme (P_13_11 …) must carry the margin scheme note: P_PMarzy 1 with its kind (VAT Act, art. 106e ust. 1 pkt 20 to 22; FA(3) information sheet, P_PMarzy). Szczegóły →
  • XV-PL-27 An invoice with exempt sales (P_13_7 or a line at rate zw) must give the legal basis of the exemption: P_19 1 with P_19A, P_19B or P_19C (VAT Act, art. 106e ust. 1 pkt 19; FA(3) information sheet, P_19). Szczegóły →
  • XV-PL-28 An invoice with domestic reverse charge sales (P_13_10 or a line at rate oo) must carry the reverse charge note: P_18 1 (VAT Act, art. 106e ust. 1 pkt 18; FA(3) information sheet, P_18). Szczegóły →
  • XV-PL-29 An invoice over PLN 15,000 due (P_15 …) to a taxpayer, with goods or services of Annex 15 (P_12_Zal_15), must carry the split payment note: P_18A 1 (VAT Act, art. 106e ust. 1 pkt 18a; FA(3) information sheet, P_18A). Szczegóły →
  • XV-PL-30 SumaObciazen and SumaOdliczen are the sums of the Kwota of the charges (…) and of the deductions (…) (FA(3) information sheet, SumaObciazen). Szczegóły →
  • XV-PL-31 … (…) must be P_15 plus the charges less the deductions (…), DoRozliczenia the overpayment when that is negative (FA(3) information sheet, DoZaplaty). Szczegóły →
  • XV-PL-32 The period of the invoice ends (P_6_Do …) before it starts (P_6_Od …) (FA(3) information sheet, OkresFa). Szczegóły →
  • XV-PL-33 A corrected invoice cannot be issued after its correction: DataWystFaKorygowanej … is later than P_1 … (FA(3) information sheet, DataWystFaKorygowanej). Szczegóły →
  • XV-PL-34 P_6 is for a date common to every line and P_6A for lines with different dates; this invoice has both (FA(3) information sheet, P_6). ostrzeżenie Szczegóły →
  • XV-PL-35 Line numbers repeat (NrWierszaFa or NrWierszaZam); each line has its own number, a line before a correction (StanPrzed) the number of the line it corrects (FA(3) information sheet, NrWierszaFa). Szczegóły →
  • XV-PL-36 Line …: … (…) is not the quantity times the unit price, less any discount (P_10), which is … (FA(3) information sheet, P_11). ostrzeżenie Szczegóły →
  • XV-PL-37 KursWaluty on an invoice line is the exchange rate of an invoice in a foreign currency; this invoice is in PLN (FA(3) information sheet, KursWaluty). Szczegóły →
  • XV-PL-38 In self-billing (P_17 1) the buyer issues the invoice as Podmiot2; it is not repeated in Podmiot3 with Rola 5 (FA(3) information sheet, P_17). ostrzeżenie Szczegóły →
  • XV-PL-39 An advance invoice documenting several payments has P_15 (…) equal to the sum of the payments P_15Z (…) (FA(3) information sheet, ZaliczkaCzesciowa). Szczegóły →
  • XV-PL-40 The payments received before the sale (P_15Z, …) exceed the amount due P_15 (…); P_15 less those payments is what remains to be paid (FA(3) information sheet, ZaliczkaCzesciowa). ostrzeżenie Szczegóły →

Statusy faktury w KSeF

  • 450

    Błąd weryfikacji semantyki dokumentu faktury

    Plik jest poprawnym XML zgodnym ze schematem, ale jego treść nie przeszła kontroli KSeF, na przykład suma kontrolna NIP sprzedawcy, nabywcy, podmiotu trzeciego lub upoważnionego (w środowisku produkcyjnym) albo data wystawienia P_1 późniejsza niż data przyjęcia faktury. Sumy kontrolne NIP sprawdza walidator: XV-PL-03

  • 440

    Duplikat faktury

    KSeF ma już fakturę o tej samej kombinacji NIP sprzedawcy (Podmiot1), rodzaju faktury (RodzajFaktury) i numeru (P_2); unikalność obowiązuje przez 10 lat od końca roku wystawienia. Nadaj nowy numer albo sprawdź, czy faktura nie została już przyjęta: odpowiedź zawiera numer KSeF oryginału. Tego nie da się sprawdzić na samym pliku.

  • 430

    Błąd weryfikacji pliku faktury

    Plik nie przeszedł weryfikacji technicznej. KSeF wymaga poprawnego XML 1.0 w UTF-8 bez BOM, zgodnego ze schematem zadeklarowanym przy otwarciu sesji, bez instrukcji przetwarzania i bez niezalecanych znaków Unicode. Walidator sprawdza schemat FA(3), instrukcje przetwarzania i znaki: XV-PL-01

  • 415

    Brak możliwości wysyłania faktury z załącznikiem

    Fakturę z załącznikiem można wysłać tylko w sesji wsadowej i tylko wtedy, gdy sprzedawca zgłosił tę opcję w e-Urzędzie Skarbowym. Walidator ostrzega o załączniku: XV-PL-05

  • 410

    Nieprawidłowy zakres uprawnień

    Podmiot, który otworzył sesję, nie ma uprawnienia do wystawiania faktur w imieniu sprzedawcy. Uprawnienia nadaje się w KSeF; plik nie ma tu znaczenia.

  • 435

    Błąd odszyfrowania pliku

    KSeF nie odszyfrował pliku: faktura szyfrowana jest algorytmem AES-256-CBC z dopełnieniem PKCS#7, a klucz symetryczny algorytmem RSAES-OAEP (SHA-256/MGF1) kluczem publicznym KSeF. To błąd programu wysyłającego, nie treści faktury.

  • 405

    Przetwarzanie anulowane z powodu błędu sesji

    Faktura nie została przetworzona, bo sesja zakończyła się błędem. Wyślij ją ponownie w nowej sesji.

  • 550

    Operacja została anulowana przez system

    Przetwarzanie przerwano z przyczyn wewnętrznych KSeF. Spróbuj ponownie.

Jak czytać statusy

Po wysłaniu faktury w sesji KSeF zwraca jej status. 100 i 150 oznaczają, że faktura jest w przetwarzaniu, 200 sukces i nadanie numeru KSeF. Kody od 405 wzwyż oznaczają odrzucenie: kolejno błędy sesji, uprawnień, pliku, szyfrowania, duplikat i semantykę dokumentu.

Kod 450 pojawia się też przy uwierzytelnianiu, jako "Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu": wtedy chodzi o token KSeF (nieaktywny, unieważniony, poza okresem ważności), a nie o fakturę.

Sprawdzenie faktury przed wysyłką

Otwórz walidator z profilem KSeF FA(3) i wklej albo przeciągnij plik XML. Najpierw sprawdzany jest schemat FA(3), potem kontrole, które KSeF wykonuje na pliku (instrukcje przetwarzania, znaki, sumy kontrolne NIP), oraz wymagania broszury informacyjnej FA(3) i ustawy o VAT dla pól opcjonalnych. Nic nie trafia na nasze serwery.

Poza zasięgiem pliku pozostają duplikaty, uprawnienia, rozmiar w sesji, data P_1 względem dnia wysyłki i biała lista.

Pytania

Co oznacza błąd 450 w KSeF?

Przy wysyłce faktury: "Błąd weryfikacji semantyki dokumentu faktury", czyli treść nie przeszła kontroli, na przykład zła suma kontrolna NIP albo data wystawienia z przyszłości. Przy logowaniu: błędny lub nieaktywny token KSeF.

Co oznacza błąd 440 w KSeF?

Duplikat faktury: KSeF ma już fakturę tego sprzedawcy z tym samym rodzajem i numerem (P_2). Nadaj nowy numer albo sprawdź, czy faktura nie została już przyjęta.

Czy walidator gwarantuje, że KSeF przyjmie fakturę?

Nie. Sprawdza schemat i kontrole, które da się wykonać na samym pliku; nie duplikaty, uprawnienia ani dane, które zna tylko KSeF.

Czy faktura jest wysyłana na wasz serwer?

Nie. Walidacja odbywa się w przeglądarce; tylko API i monitory sprawdzają pliki na naszych serwerach.

Źródła