Vai al contenuto principale
KSeF 2.0 · autenticazione

Stati di autenticazione KSeF: 415, 425, 450, 470 e 480

L'accesso a KSeF termina con uno stato che si consulta separatamente dall'invio. Oltre agli errori del certificato (codice 460) ci sono stati che riguardano permessi, una sessione revocata, un token e un blocco. Il codice 450 qui significa un'altra cosa che in una fattura (450 della fattura).

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 5 novembre 2026

In breve

Modulo
KSeF 2.0
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
3 min

Che cosa significa ogni stato

415
«Uwierzytelnianie zakończone niepowodzeniem» (autenticazione fallita), details «Brak przypisanych uprawnień» (nessun permesso assegnato): la persona o l'entità del certificato non ha alcun permesso nel contesto di quel NIP.
425
«Uwierzytelnienie unieważnione» (autenticazione revocata), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: qualcuno ha chiuso quella sessione.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (fallita per un token errato), con details come «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» o «Token nie może być użyty w kontekście {contextIdentifier}»: riguarda l'accesso con un token KSeF.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (tentativo di usare le credenziali di una persona deceduta).
480
«Uwierzytelnienie zablokowane» (autenticazione bloccata), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (sospetto incidente di sicurezza; contatta il Ministero tramite il suo modulo).
500 e 550
«Nieznany błąd» (errore sconosciuto) e «Operacja została anulowana przez system» (annullata dal sistema), con details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (elaborazione interrotta per cause interne; riprova).
Scheda degli stati di autenticazione KSeF
Lo stato 415 con la sua descrizione dell'API e gli altri stati dell'accesso: 425, 450, 470 e 480, più i codici 21301 e 21304.

Token KSeF e Odoo

Odoo 18, 19 e 20 hanno nel loro codice una funzione per accedere con un token KSeF, ma nessuno la chiama: accedono solo con il certificato. Quindi un 450 all'accesso non proviene da Odoo. Se lo vedi, viene da un altro programma che usa un token, come quello di uno studio di consulenza. KSeF revoca automaticamente i token quando il loro titolare perde i permessi.

Con gli altri stati Odoo mostra «KSeF Authentication failed with status …: …» con la descrizione e senza i details. Nel 415 e nel 470 la descrizione è la stessa, quindi solo il campo details li distingue.

Token di accesso, di refresh e codici 21301 e 21304

ElementoKSeFOdoo 18, 19 e 20
accessTokenVale qualche minuto («kilkanaście», dice la documentazione), quello indicato dal suo campo expDopo un HTTP 401 lo rinnova e ripete la richiesta una volta.
refreshTokenFino a 7 giorniL'azione pianificata «Refresh KSeF tokens» accede di nuovo con il certificato ogni 6 giorni.
21301 «Brak autoryzacji.» (nessuna autorizzazione)Al riscatto o al rinnovo dei token, per esempio «Token KSeF został unieważniony.» (token KSeF revocato)Vedi «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», senza il codice.
21304 «Brak uwierzytelnienia.» (nessuna autenticazione)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Lo stesso: il codice non arriva allo schermo.
Schema: che cosa restituisce KSeF con gli stati di accesso 415-480 e che cosa mostra Odoo 20
Schema realizzato a partire dal codice l10n_pl_edi di Odoo 20 e dalla specifica dell'API KSeF 2.9.0; ciò che è barrato è ciò che Odoo non conserva o non fa.

Che cosa fare

  • 415, o 21301 dopo la revoca dei permessi: il titolare dell'azienda assegna i permessi in KSeF alla persona del certificato e tu salvi di nuovo il certificato nelle impostazioni di Odoo.
  • 425: qualcuno ha revocato la sessione; salva di nuovo il certificato perché Odoo acceda di nuovo.
  • 480: segui le indicazioni di KSeF e contatta il Ministero delle Finanze tramite il suo modulo; ripetere l'accesso non serve.
  • 500 o 550: riprova.

Il nostro modulo, Poland KSeF 2.0 Validator, tiene un elenco dei certificati e dei token KSeF con le relative date di scadenza, ma non accede a KSeF e non vede questi stati.

Continua a leggere

Accesso a KSeF con certificato: codice 460 ed errori di firma XAdESCodice 460 di KSeF ed eccezioni 9101-9105, 21111, 21115, 21117, 21217, 21401 e 21406 all'accesso con certificato. Cosa non mostra Odoo 18, 19 e 20 e cosa controllare.Codice 450 di KSeF: «Błąd weryfikacji semantyki dokumentu faktury»Il codice 450 di KSeF respinge una fattura FA(3) dopo averne controllato il contenuto. Dove sta il motivo reale, cosa non mostra Odoo 18, 19 e 20 e come reinviarla.Codici 410 e 415 di KSeF: permessi del venditore e allegatiIl 410 «Nieprawidłowy zakres uprawnień» e il 415 per le fatture con allegato: cosa li causa nei test del Ministero e cosa controllare in Odoo 18, 19 e 20.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti