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. |
| 410 | Geen machtiging om deze factuur uit te reiken |
| 415 | Factuur met bijlage niet geaccepteerd |
| 430 | Factuurbestand niet door de controle gekomen |
| 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. |
| 440 | Dubbele factuur |
| 450 | Factuurinhoud niet door de inhoudelijke controle gekomen |
| 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. |
| 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. |
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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 440 | Sessie geannuleerd KSeF-sessiestatus 440 betekent dat de sessie is geannuleerd. Open een nieuwe sessie en stuur de facturen binnen de toegestane tijd. |
| 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. |
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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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.