Saltar para o conteúdo principal
KSeF 2.0 · estado da fatura

Estados técnicos da fatura no KSeF: 550, 500, 405, 430 e 435

Cinco estados da fatura indicam um problema no processamento e não nos dados da fatura. O Odoo trata-os de forma diferente: quatro acabam em Rejected e num novo envio, enquanto o 550, que o Odoo não reconhece, deixa a fatura em Sent.

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 diz o KSeF

CódigoTexto do KSeFEstado no Odoo 18, 19 e 20
550«Operacja została anulowana przez system» (anulada pelo sistema), details «Przetwarzanie zostało przerwane z przyczyn wewnętrznych systemu. Spróbuj ponownie» (interrompida por causas internas; tente novamente)Fica em Sent (In Progress)
500«Nieznany błąd ({statusCode})» (erro desconhecido)Rejected, com a descrição do KSeF
405«Przetwarzanie anulowane z powodu błędu sesji» (processo anulado por um erro da sessão)Rejected
430«Błąd weryfikacji pliku faktury» (erro ao verificar o ficheiro da fatura)Rejected
435«Błąd odszyfrowania pliku» (erro ao decifrar o ficheiro)Rejected
Cartão dos estados técnicos da fatura no KSeF
O estado 550 com o seu texto da API e os restantes estados técnicos: 500, 405, 430 e 435.

550: a fatura fica presa em Sent

O Odoo só traduz para os seus estados os códigos 100, 150, 200, 405, 410, 415, 430, 435, 440, 450 e 500. Qualquer outro, incluindo o 550, acaba na mensagem «Unknown status received from KSeF (Code: 550): …» (em polaco na 18 e na 19: «Otrzymano nieznany status od KSeF (kod: 550): …») e não altera o «KSeF Status». A fatura fica em Sent (In Progress) e o Odoo não mostra nela o botão para voltar a rascunho.

O KSeF diz «tente novamente», mas o Odoo não o consegue fazer a partir da fatura: só envia faturas sem estado KSeF. O botão «Check Sending» e a ação agendada apenas voltam a perguntar pelo estado, que continuará a ser 550.

Sair deste estado exige uma alteração fora da interface do Odoo, por isso avise o seu parceiro ou quem mantém o seu Odoo. Isto decorre do código do Odoo 18, 19 e 20; não o testámos contra o KSeF de produção.

500, 405, 430 e 435: rejeitadas, prontas a reenviar

Com estes quatro, o Odoo põe o estado em Rejected. Com o 500 acrescenta a descrição do KSeF; com os restantes mostra o seu texto fixo. A documentação do KSeF não indica uma lista de causas para eles além do que o nome diz:

  • 405: o processo foi anulado por um erro na sessão em que a fatura foi enviada;
  • 430: o KSeF não conseguiu verificar o próprio ficheiro da fatura;
  • 435: o KSeF não conseguiu decifrar o ficheiro, que o programa de envio cifra com AES-256-CBC e com a chave passada ao abrir a sessão.

O Odoo gera e cifra o ficheiro por si, pelo que um 430 ou um 435 que se repete aponta para o programa de envio e não para os dados da fatura.

Esquema: o que o KSeF devolve com o estado 550 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

  1. Nos casos 500, 405, 430 e 435, repõe a fatura em rascunho (o Odoo limpa então o seu estado e número KSeF), confirme-a e envie-a de novo.
  2. No caso do 550, volte a consultar o estado com «Check Sending». Se continuar em 550, o processo foi interrompido e a fatura tem de ser enviada de novo.
  3. Passe-a então a quem mantém o seu Odoo para que a envie novamente. Se a enviar por outro canal, ficará em Sent no Odoo.

O nosso módulo, Poland KSeF 2.0 Validator, toma o estado apenas do l10n_pl_edi: com um 550 a fatura também fica em Submitted no módulo.

Continue a ler

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.Exceções do KSeF ao enviar uma fatura: 21405, 21180, 21184 e as restantesExceções do KSeF ao enviar uma fatura: 21405, 21001, 21155, 21166, 21167, 21173, 21180, 21184, 21402 e 21403. O que significam e como aparecem no Odoo.KSeF HTTP 429, 403 e 401: limites de pedidos e acesso negadoKSeF 2.0 responde 429 Too Many Requests ao ultrapassar o limite, 403 com reasonCode sem acesso e 401 com o token expirado. Limites e o que fazem Odoo 18, 19 e 20.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes