Saltar para o conteúdo principal
KSeF 2.0 · autenticação

Estados de autenticação do KSeF: 415, 425, 450, 470 e 480

O início de sessão no KSeF termina com um estado que se consulta à parte do envio. Além dos erros de certificado (código 460) há estados que indicam permissões, uma sessão revogada, um token e um bloqueio. O código 450 significa aqui outra coisa do que numa fatura (450 da fatura).

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
KSeF 2.0
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
3 min

O que significa cada estado

415
«Uwierzytelnianie zakończone niepowodzeniem» (autenticação falhada), details «Brak przypisanych uprawnień» (sem permissões atribuídas): a pessoa ou entidade do certificado não tem nenhuma permissão no contexto desse NIF.
425
«Uwierzytelnienie unieważnione» (autenticação revogada), details «Uwierzytelnienie i powiązane refresh tokeny zostały unieważnione przez użytkownika»: alguém encerrou essa sessão.
450
«Uwierzytelnianie zakończone niepowodzeniem z powodu błędnego tokenu» (falhada por token errado), com details como «Token unieważniony», «Token nieaktywny», «Nieprawidłowy czas tokena» ou «Token nie może być użyty w kontekście {contextIdentifier}»: refere-se ao início de sessão com token KSeF.
470
«Uwierzytelnianie zakończone niepowodzeniem», details «Próba wykorzystania metod autoryzacyjnych osoby zmarłej» (tentativa de usar as credenciais de uma pessoa falecida).
480
«Uwierzytelnienie zablokowane» (autenticação bloqueada), details «Podejrzenie incydentu bezpieczeństwa. Skontaktuj się z Ministerstwem Finansów przez formularz zgłoszeniowy.» (suspeita de incidente de segurança; contacte o Ministério através do seu formulário).
500 e 550
«Nieznany błąd» (erro desconhecido) e «Operacja została anulowana przez system» (anulada pelo sistema), com details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (processamento interrompido por causas internas; tente novamente).
Cartão dos estados de autenticação do KSeF
O estado 415 com a respetiva descrição da API e os restantes estados do início de sessão: 425, 450, 470 e 480, mais os códigos 21301 e 21304.

Tokens KSeF e Odoo

O Odoo 18, 19 e 20 têm no seu código uma função para iniciar sessão com um token KSeF, mas nada a chama: só iniciam sessão com o certificado. Por isso um 450 no início de sessão não vem do Odoo. Se o vir, vem de outro programa que usa um token, como o de um gabinete de contabilidade. O KSeF revoga os tokens automaticamente quando o seu titular perde as permissões.

Com os restantes estados, o Odoo mostra «KSeF Authentication failed with status …: …» com a descrição e sem os details. No 415 e no 470 a descrição é a mesma, por isso só o campo details os distingue.

Tokens de acesso, de refrescamento e códigos 21301 e 21304

ElementoKSeFOdoo 18, 19 e 20
accessTokenVale uns poucos minutos («kilkanaście», diz a documentação), os que indicar o seu campo expApós um HTTP 401 refresca-o e repete o pedido uma vez.
refreshTokenAté 7 diasA ação agendada «Refresh KSeF tokens» volta a iniciar sessão com o certificado a cada 6 dias.
21301 «Brak autoryzacji.» (sem autorização)Ao trocar ou refrescar tokens, por exemplo «Token KSeF został unieważniony.» (token KSeF revogado)Vê «Failed to refresh KSeF access token. You may need to re-authenticate manually. Error: 400 Client Error…», sem o código.
21304 «Brak uwierzytelnienia.» (sem autenticação)«Operacja uwierzytelniania o numerze referencyjnym {referenceNumber} nie została znaleziona.»Igual: o código não chega ao ecrã.
Esquema: o que o KSeF devolve com os estados de início de sessão 415-480 e o que o Odoo 20 mostra
Esquema feito a partir do código de l10n_pl_edi do Odoo 20 e da especificação da API do KSeF 2.9.0; o riscado é o que o Odoo não guarda ou não faz.

O que fazer

  • 415, ou 21301 após retirar permissões: o proprietário da empresa concede permissões no KSeF à pessoa do certificado e volta a guardar o certificado nas definições do Odoo.
  • 425: alguém revogou a sessão; volte a guardar o certificado para que o Odoo inicie sessão de novo.
  • 480: faça o que o KSeF indica e contacte o Ministério das Finanças através do seu formulário; repetir o início de sessão não ajuda.
  • 500 ou 550: tente novamente.

O nosso módulo, Poland KSeF 2.0 Validator, mantém uma lista de certificados e tokens KSeF com as respetivas datas de validade, mas não inicia sessão no KSeF e não vê estes estados.

Continue a ler

Início de sessão no KSeF com certificado: código 460 e erros de assinatura XAdESCódigo 460 do KSeF e exceções 9101-9105, 21111, 21115, 21117, 21217, 21401 e 21406 ao iniciar sessão com certificado. O que o Odoo 18, 19 e 20 não mostram.Código 450 do KSeF: «Błąd weryfikacji semantyki dokumentu faktury»O código 450 do KSeF rejeita uma fatura FA(3) após rever o seu conteúdo. Onde está o motivo real, o que o Odoo 18, 19 e 20 não mostra e como voltar a enviá-la.Códigos 410 e 415 do KSeF: permissões do vendedor e anexosO 410 «Nieprawidłowy zakres uprawnień» e o 415 em faturas com anexo: o que os causa nos testes do Ministério e o que rever no Odoo 18, 19 e 20.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes