Naar hoofdinhoud
KSeF 2.0 · factuurstatus

Technische factuurstatussen in KSeF: 550, 500, 405, 430 en 435

Vijf factuurstatussen wijzen op een probleem bij de verwerking en niet op de gegevens van de factuur. Odoo behandelt ze verschillend: vier eindigen in Rejected en bij een nieuwe verzending, terwijl de 550, die Odoo niet kent, de factuur op Sent laat staan.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 5 november 2026

In het kort

Module
KSeF 2.0
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de module, versie 20.0 · in de bronnen onderaan
Leestijd
3 min

Wat KSeF zegt

CodeTekst van KSeFStatus in Odoo 18, 19 en 20
550«Operacja została anulowana przez system» (geannuleerd door het systeem), details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (onderbroken om interne redenen; probeer het opnieuw)Blijft op Sent (In Progress)
500«Nieznany błąd ({statusCode})» (onbekende fout)Rejected, met de beschrijving van KSeF
405«Przetwarzanie anulowane z powodu błędu sesji» (verwerking geannuleerd door een fout in de sessie)Rejected
430«Błąd weryfikacji pliku faktury» (fout bij het verifiëren van het factuurbestand)Rejected
435«Błąd odszyfrowania pliku» (fout bij het ontsleutelen van het bestand)Rejected
Kaart met de technische factuurstatussen in KSeF
De status 550 met zijn tekst uit de API en de overige technische statussen: 500, 405, 430 en 435.

550: de factuur blijft steken op Sent

Odoo koppelt alleen de codes 100, 150, 200, 405, 410, 415, 430, 435, 440, 450 en 500 aan zijn eigen statussen. Alle andere, ook de 550, eindigen in de melding "Unknown status received from KSeF (Code: 550): …" (in het Pools in 18 en 19: «Otrzymano nieznany status od KSeF (kod: 550): …») en laten "KSeF Status" ongewijzigd. De factuur blijft op Sent (In Progress) staan en Odoo toont daarop de knop om terug naar concept te gaan niet.

KSeF zegt «probeer het opnieuw», maar Odoo kan dat niet vanuit de factuur: het verstuurt alleen facturen zonder KSeF-status. De knop "Check Sending" en de geplande actie vragen alleen opnieuw naar de status, die dan nog steeds 550 is.

Uit deze status komen vraagt een wijziging buiten de interface van Odoo, dus meld het bij je partner of bij wie je Odoo beheert. Dit volgt uit de code van Odoo 18, 19 en 20; we hebben het niet getest tegen de productieomgeving van KSeF.

500, 405, 430 en 435: afgewezen, klaar om opnieuw te verzenden

Bij deze vier zet Odoo de status op Rejected. Bij de 500 voegt het de beschrijving van KSeF toe; bij de andere toont het de eigen vaste tekst. De documentatie van KSeF geeft voor hen geen lijst met oorzaken, behalve wat de naam zegt:

  • 405: de verwerking is geannuleerd door een fout in de sessie waarin de factuur is verzonden;
  • 430: KSeF kon het factuurbestand zelf niet verifiëren;
  • 435: KSeF kon het bestand niet ontsleutelen, dat het verzendende programma versleutelt met AES-256-CBC en de sleutel die bij het openen van de sessie wordt meegegeven.

Odoo bouwt en versleutelt het bestand zelf, dus een terugkerende 430 of 435 wijst naar het verzendende programma en niet naar de factuurgegevens.

Schema: wat KSeF teruggeeft bij status 550 en wat Odoo 20 toont
Schema op basis van de code van l10n_pl_edi van Odoo 20 en de specificatie van de KSeF API 2.9.0; het doorgestreepte is wat Odoo niet bewaart of niet doet.

Wat te doen

  1. Bij de 500, 405, 430 en 435 zet je de factuur terug naar concept (Odoo wist dan zijn KSeF-status en -nummer), bevestig haar en verstuur haar opnieuw.
  2. Bij de 550 vraag je de status opnieuw op met "Check Sending". Als het nog steeds 550 is, is de verwerking onderbroken en moet de factuur opnieuw worden verzonden.
  3. Geef haar dan door aan wie je Odoo beheert, zodat die haar opnieuw kan versturen. Als je haar via een ander kanaal verstuurt, blijft ze in Odoo op Sent staan.

Onze module, Poland KSeF 2.0 Validator, neemt de status alleen over van l10n_pl_edi: bij een 550 blijft de factuur ook in de module op Submitted staan.

Lees verder

KSeF-code 450: «Błąd weryfikacji semantyki dokumentu faktury»KSeF-code 450 weigert een FA(3)-factuur na controle van de inhoud. Waar de echte reden zit, wat Odoo 18, 19 en 20 niet tonen en hoe je de factuur opnieuw verstuurt.KSeF-uitzonderingen bij het verzenden van een factuur: 21405, 21180, 21184 en de restKSeF-uitzonderingen bij het verzenden van een factuur: 21405, 21001, 21155, 21166, 21167, 21173, 21180, 21184, 21402 en 21403. Betekenis en weergave in Odoo.KSeF HTTP 429, 403 en 401: aanvraaglimieten en geweigerde toegangKSeF 2.0 antwoordt met 429 Too Many Requests bij overschrijding, 403 met een reasonCode bij ontbrekende toegang en 401 bij een verlopen token. Limieten en wat Odoo doet.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen