Naar hoofdinhoud
KSeF 2.0 · authenticatie

KSeF-authenticatiestatussen: 415, 425, 450, 470 en 480

De aanmelding bij KSeF eindigt met een status die apart wordt opgevraagd van het verzenden zelf. Naast certificaatfouten (code 460) zijn er statussen over rechten, een ingetrokken sessie, een token en een blokkade. Code 450 betekent hier iets anders dan op een factuur (450 van de factuur).

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 elke status betekent

415
«Uwierzytelnianie zakończone niepowodzeniem» (authenticatie mislukt), details «Brak przypisanych uprawnień» (geen rechten toegekend): de persoon of entiteit op het certificaat heeft geen enkel recht in de context van dat NIP.
425
«Uwierzytelnienie unieważnione» (authenticatie ingetrokken), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: iemand heeft die aanmeldsessie gesloten.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (mislukt door een verkeerd token), met details zoals «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» of «Token nie może być użyty w kontekście {contextIdentifier}»: het gaat om aanmelden met een KSeF-token.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (poging om de inloggegevens van een overleden persoon te gebruiken).
480
«Uwierzytelnienie zablokowane» (authenticatie geblokkeerd), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (vermoeden van een beveiligingsincident; neem contact op met het Ministerie via het meldingsformulier).
500 en 550
«Nieznany błąd» (onbekende fout) en «Operacja została anulowana przez system» (geannuleerd door het systeem), met details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (verwerking onderbroken om interne redenen; probeer het opnieuw).
Overzichtskaart van de KSeF-authenticatiestatussen
Status 415 met de beschrijving uit de API en de overige aanmeldstatussen: 425, 450, 470 en 480, plus de codes 21301 en 21304.

KSeF-tokens en Odoo

Odoo 18, 19 en 20 hebben in hun code een functie om in te loggen met een KSeF-token, maar niets roept die aan: ze loggen alleen in met het certificaat. Een 450 bij het aanmelden komt dus niet uit Odoo. Als je er een ziet, komt die uit een ander programma dat een token gebruikt, zoals dat van een boekhoudkantoor. KSeF trekt tokens automatisch in wanneer de houder zijn rechten verliest.

Bij de overige statussen toont Odoo «KSeF Authentication failed with status …: …» met de beschrijving en zonder de details. Bij 415 en 470 is de beschrijving dezelfde, dus alleen het veld details onderscheidt ze.

Toegangs- en vernieuwingstokens, en codes 21301 en 21304

ElementKSeFOdoo 18, 19 en 20
accessTokenGeldig enkele tientallen minuten, zoals ingesteld in het veld expNa een HTTP 401 vernieuwt het de token en herhaalt het het verzoek één keer.
refreshTokenTot 7 dagenDe geplande actie «Refresh KSeF tokens» meldt zich elke 6 dagen opnieuw aan met het certificaat.
21301 «Brak autoryzacji.» (geen autorisatie)Bij het inwisselen of vernieuwen van tokens, bijvoorbeeld «Token KSeF został unieważniony.» (KSeF-token ingetrokken)Je ziet «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», zonder de code.
21304 «Brak uwierzytelnienia.» (geen authenticatie)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Hetzelfde: de code bereikt het scherm niet.
Schema: wat KSeF teruggeeft bij de aanmeldstatussen 415-480 en wat Odoo 20 toont
Schema op basis van de code van l10n_pl_edi in Odoo 20 en de specificatie van de KSeF-API 2.9.0; wat doorgestreept is, is wat Odoo niet bewaart of niet doet.

Wat te doen

  • 415, of 21301 nadat rechten zijn ingetrokken: de eigenaar van het bedrijf kent in KSeF rechten toe aan de persoon op het certificaat, en jij slaat het certificaat opnieuw op in de instellingen van Odoo.
  • 425: iemand heeft de aanmeldsessie ingetrokken; sla het certificaat opnieuw op zodat Odoo opnieuw inlogt.
  • 480: doe wat KSeF zegt en neem contact op met het Ministerie van Financiën via het formulier; opnieuw aanmelden helpt niet.
  • 500 of 550: probeer het opnieuw.

Onze module, Poland KSeF 2.0 Validator, houdt een lijst bij van KSeF-certificaten en -tokens met hun vervaldatums, maar meldt zich niet aan bij KSeF en ziet deze statussen niet.

Lees verder

Aanmelden bij KSeF met certificaat: code 460 en XAdES-handtekeningfoutenKSeF-code 460 en de uitzonderingen 9101-9105, 21111, 21115, 21117, 21217, 21401 en 21406 bij aanmelden met certificaat: wat Odoo 18, 19 en 20 niet tonen.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.Codes 410 en 415 van KSeF: rechten van de verkoper en bijlagenKSeF 410 «Nieprawidłowy zakres uprawnień» en 415 bij facturen met bijlage: wat ze veroorzaakt in de tests van het Ministerie en wat je in Odoo 18, 19 en 20 moet nakijken.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen