Naar de inhoud

KSeF-status- en foutcodes uitgelegd

Als het Poolse e-facturatieplatform KSeF een factuur niet accepteert, geeft het de factuur een statuscode, zoals 440 of 450, of beantwoordt het het verzoek met een foutcode, zoals 21405. Zoek hieronder je code om te zien wat die betekent, wat meestal de oorzaak is en wat je aanpast voordat je de factuur opnieuw verstuurt.

In het kort

Wat KSeF-statuscodes en foutcodes zoals 440, 450 of 21405 betekenen, waarom het Poolse e-facturatieplatform de factuur niet accepteerde en wat je aanpast.

Deze lijst bevat 32 codes uit de officiële documenten hieronder. 5 hebben een eigen pagina; 27 worden alleen in de tabel uitgelegd, omdat dit systeem- of transportstatussen zijn waarbij het niet helpt om de factuur aan te passen.

Niet opgenomen: 21111, 21115, 21117, 21217, 21301, 21304, 21308, 21401, 21406, 9101, 9102, 9103, 9105, 21164, 21165, 21175, 21181, 21182, 21183, 21418, 25001, 25002, 25003, 25004, 25005, 25006, 25007, 25008, 25009, 25010, 25011, 26001, 26002, 30001, 71001, 71002, 71004, 71005. Het gaat om een ander proces dan het versturen van een factuur.

Statuscodes van facturen

Code Wat het betekent
405 Verwerking geannuleerd door een sessiefout

KSeF-factuurstatus 405 betekent dat de verwerking van de factuur is geannuleerd door een fout in de sessie waarin de factuur is verstuurd. Los het probleem op dat de sessiestatus aangeeft en verstuur de factuur daarna opnieuw in een nieuwe sessie.

Przetwarzanie anulowane z powodu błędu sesji

410 Geen machtiging om deze factuur uit te reiken

Nieprawidłowy zakres uprawnień

415 Factuur met bijlage niet geaccepteerd

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

430 Factuurbestand niet door de controle gekomen

Błąd weryfikacji pliku faktury

435 Factuurbestand kon niet worden ontsleuteld

KSeF-factuurstatus 435 betekent dat KSeF het factuurbestand niet kon ontsleutelen. Vraag de aanbieder van je software om de versleuteling te controleren en verstuur de factuur daarna opnieuw.

Błąd odszyfrowania pliku

440 Dubbele factuur

Duplikat faktury

450 Factuurinhoud niet door de inhoudelijke controle gekomen

Błąd weryfikacji semantyki dokumentu faktury

500 Onbekende fout

KSeF-status 500 betekent dat er een onbekende fout is opgetreden terwijl KSeF de factuur of de sessie verwerkte. Controleer de status later opnieuw. Blijft die op 500 staan, neem dan met het referentienummer contact op met de support van KSeF voordat je beslist of je de factuur opnieuw verstuurt.

Nieznany błąd ({statusCode})

550 Bewerking geannuleerd door het systeem

KSeF-status 550 betekent dat het systeem de bewerking heeft geannuleerd. Probeer het opnieuw, zoals de KSeF-documentatie adviseert.

Operacja została anulowana przez system

Statuscodes van sessies

Code Wat het betekent
405 Batchpakket niet door de controle gekomen

KSeF-sessiestatus 405 betekent dat de onderdelen van het batchpakket de controle van KSeF niet doorstonden. Vraag de aanbieder van je software om te controleren hoe het pakket wordt opgebouwd en opgegeven, en verstuur het daarna in een nieuwe batchsessie.

Błąd weryfikacji poprawności dostarczonych elementów paczki

415 Sessiesleutel kon niet worden ontsleuteld

KSeF-sessiestatus 415 betekent dat KSeF de meegestuurde sleutel niet kon ontsleutelen. Vraag de aanbieder van je software om de sleutelversleuteling en de gebruikte publieke sleutel te controleren. Open daarna een nieuwe sessie en verstuur de facturen opnieuw.

Błąd odszyfrowania dostarczonego klucza

420 Te veel facturen in de sessie

KSeF-sessiestatus 420 betekent dat de sessie de limiet voor het aantal facturen heeft overschreden. Verdeel de facturen over meerdere sessies en verstuur ze opnieuw.

Przekroczony limit faktur w sesji

430 Batcharchief kon niet worden uitgepakt

KSeF-sessiestatus 430 betekent dat KSeF het oorspronkelijke ZIP-archief van de batch niet kon uitpakken. Vraag de maker van je software het pakket opnieuw op te bouwen en stuur het in een nieuwe batchsessie.

Błąd dekompresji pierwotnego archiwum

435 Delen van het archief konden niet worden ontsleuteld

KSeF-sessiestatus 435 betekent dat KSeF de versleutelde delen van het batcharchief niet kon ontsleutelen. Vraag de maker van je software de versleuteling van de delen te controleren en stuur het pakket daarna in een nieuwe batchsessie.

Błąd odszyfrowania zaszyfrowanych części archiwum

440 Sessie geannuleerd

KSeF-sessiestatus 440 betekent dat de sessie is geannuleerd. Open een nieuwe sessie en stuur de facturen binnen de toegestane tijd.

Sesja anulowana

445 Geen geldige facturen in de sessie

KSeF-sessiestatus 445 betekent dat de controle geen enkele geldige factuur in de sessie heeft gevonden. Herstel de gemelde fouten per factuur, zorg dat er geldige facturen in de sessie zitten en stuur de facturen opnieuw.

Błąd weryfikacji, brak poprawnych faktur

Foutcodes bij het versturen

Code Wat het betekent
21001 Onleesbare inhoud van het verzoek

KSeF-fout 21001 betekent dat KSeF de inhoud van het verzoek niet kon lezen. Vraag de maker van je software het verzoek te controleren aan de hand van de details en het daarna opnieuw te sturen.

Nieczytelna treść.

21155 Te veel facturen in de sessie

KSeF-fout 21155 betekent dat de sessie het toegestane aantal facturen heeft bereikt. Sluit de sessie en stuur de resterende facturen in een nieuwe sessie.

Przekroczono dozwoloną liczbę faktur w sesji.

21157 Verkeerde grootte van een deel van het pakket

KSeF-fout 21157 betekent dat de grootte van een deel van het batchpakket niet geldig is. Bouw het pakket opnieuw op, zodat elk deel binnen de limiet blijft en overeenkomt met de opgegeven grootte, en stuur het in een nieuwe batchsessie.

Nieprawidłowy rozmiar części pakietu.

21161 Te veel delen in het pakket

KSeF-fout 21161 betekent dat het batchpakket meer delen heeft dan KSeF toestaat. Verdeel de facturen over meerdere batchsessies en stuur ze opnieuw.

Przekroczono dozwoloną liczbę części pakietu.

21166 Technische correctie niet beschikbaar

KSeF-fout 21166 betekent dat je geen technische correctie kunt sturen, omdat de factuur al een technische correctie heeft die KSeF correct heeft verwerkt. Kijk de status van de eerdere technische correctie na in plaats van een nieuwe te sturen.

Korekta techniczna niedostępna.

21167 Factuurstatus staat geen technische correctie toe

KSeF-fout 21167 betekent dat er een technische correctie is gestuurd voor een factuur die KSeF correct heeft verwerkt. Controleer of hashOfCorrectedInvoice de hash bevat van de afgewezen offlinefactuur en niet van een factuur die KSeF heeft geaccepteerd.

Status faktury nie pozwala na korektę techniczną.

21173 Sessie niet gevonden

KSeF-fout 21173 betekent dat er geen sessie bestaat met het opgegeven referentienummer. Gebruik het juiste referentienummer van de sessie en stuur het verzoek opnieuw.

Brak sesji o wskazanym numerze referencyjnym.

21178 UPO niet gevonden

KSeF-fout 21178 betekent dat KSeF voor de opgegeven criteria geen UPO (officieel ontvangstbewijs) heeft gevonden. Corrigeer de nummers en vraag de UPO opnieuw op.

Nie znaleziono UPO dla podanych kryteriów.

21180 Sessiestatus staat deze handeling niet toe

KSeF-fout 21180 betekent dat de status van de sessie de handeling niet toestaat, bijvoorbeeld het versturen van facturen of het sluiten van de sessie. Controleer de status van de sessie en open een nieuwe sessie om verdere facturen te versturen.

Status sesji nie pozwala na wykonanie operacji.

21184 Sessie tijdelijk niet beschikbaar

KSeF-fout 21184 betekent dat de sessie tijdelijk niet beschikbaar is vanwege onderhoudswerkzaamheden. Probeer het later opnieuw, of open een nieuwe sessie om verdere facturen te versturen, zoals in de details staat.

Sesja tymczasowo niedostępna.

21205 Pakket mag niet leeg zijn

KSeF-fout 21205 betekent dat het pakket niet leeg mag zijn: een opgegeven deel is niet verstuurd. Verstuur het ontbrekende deel dat in de details staat en controleer of elk opgegeven deel is verstuurd.

Pakiet nie może być pusty.

21208 De tijd om te versturen is verlopen

KSeF-fout 21208 betekent dat de wachttijd voor de verzoeken upload of finish is verstreken. De sessie is daarbij geannuleerd. Open een nieuwe batchsessie en verstuur de delen binnen de toegestane tijd.

Czas oczekiwania na requesty upload lub finish został przekroczony.

21402 Onjuiste bestandsgrootte

KSeF-fout 21402 betekent dat de lengte van de verstuurde inhoud niet overeenkomt met de opgegeven bestandsgrootte. Vraag de aanbieder van je software te controleren of de opgegeven grootte die van het verstuurde bestand is. Verstuur het bestand daarna opnieuw.

Nieprawidłowy rozmiar pliku.

21403 Onjuiste hash van het bestand

KSeF-fout 21403 betekent dat de hash van de verstuurde inhoud niet overeenkomt met de opgegeven hash van het bestand. Vraag de aanbieder van je software te controleren of de opgegeven hash is berekend uit het verstuurde bestand. Verstuur het bestand daarna opnieuw.

Nieprawidłowy skrót pliku.

21405 Invoergegevens hebben de controle niet doorstaan

KSeF-fout 21405 betekent dat de gegevens in het verzoek de controle niet hebben doorstaan. Corrigeer de fout die in de details wordt genoemd en verstuur het verzoek opnieuw.

Błąd walidacji danych wejściowych.

21470 Onbekende of ingetrokken sleutel

KSeF-fout 21470 betekent dat de verstuurde sleutelidentificatie onbekend is of naar een ingetrokken sleutel verwijst. Vraag de aanbieder van je software een ondersteunde sleutelidentificatie te gebruiken en verstuur het verzoek daarna opnieuw.

Przesłany identyfikator klucza jest nieznany lub wskazuje na wycofany klucz.

Lees het officiële document

  • KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Bron: KSeF API 2.0, specyfikacja OpenAPI (open-api.json), versie 2.9.0, gepubliceerd door Ministerstwo Finansów, geraadpleegd op 8 november 2026. Officiële tekst in de oorspronkelijke taal, uit Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, onder MIT License.
  • Weryfikacja faktury Bron: Weryfikacja faktury, versie 09.04.2026, gepubliceerd door Ministerstwo Finansów, geraadpleegd op 8 november 2026. Officiële tekst in de oorspronkelijke taal, uit Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, onder MIT License.

Veelgestelde vragen

Waar zie ik de KSeF-status van een factuur?

Je facturatieprogramma leest die na het versturen uit KSeF: elke factuur in een sessie krijgt een statuscode, een beschrijving en, waar KSeF die geeft, details. Status 200 betekent geslaagd. Bij 100 en 150 is KSeF de factuur nog aan het verwerken.

Waarom komt hetzelfde nummer twee keer voor?

KSeF gebruikt dezelfde nummers voor de status van een factuur en de status van een sessie, met een andere betekenis. Voor een factuur betekent 440 een duplicaat, voor een sessie dat de sessie is geannuleerd. Kijk welke van de twee je programma toont.

Welke codes staan er niet bij?

Statussen die voortgang of succes melden, en de foutcodes voor inloggen, certificaten, tokens, machtigingen en het downloaden van facturen. Die gaan over een ander proces dan het versturen van een factuur.

Waar komen de codes vandaan?

Uit de KSeF 2.0 API-documentatie van het Poolse ministerie van Financiën, gepubliceerd onder de MIT-licentie. Elke codepagina citeert de officiële Poolse tekst en linkt naar de bron.

Bijgewerkt op 8 november 2026