Códigos de estado e de erro do KSeF explicados
Quando o KSeF, o sistema nacional de fatura eletrónica da Polónia, não aceita uma fatura, atribui-lhe um código de estado, como 440 ou 450, ou responde ao pedido com um código de erro, como 21405. Encontre abaixo o seu código para ver o que significa, a causa habitual e o que alterar antes de enviar a fatura de novo.
Em resumo
O que significam os códigos de estado e de erro do KSeF, como 440, 450 ou 21405, por que motivo o sistema polaco não aceitou a fatura e o que alterar.
Esta lista abrange 32 códigos dos documentos oficiais indicados abaixo. 5 têm página própria; 27 são explicados apenas na tabela, por serem estados de sistema ou de transporte sem nada a corrigir na fatura.
Fora desta lista: 21111, 21115, 21117, 21217, 21301, 21304, 21308, 21401, 21406, 9101, 9102, 9103, 9105, 21164, 21165, 21175, 21181, 21182, 21183, 21418, 25001, 25002, 25003, 25004, 25005, 25006, 25007, 25008, 25009, 25010, 25011, 26001, 26002, 30001, 71001, 71002, 71004, 71005, de um processo diferente do envio de faturas.
Códigos de estado da fatura
| Código | O que significa |
|---|---|
| 405 | Processamento cancelado por erro na sessão KSeF, estado 405 da fatura: o processamento da fatura foi cancelado devido a um erro na sessão em que foi enviada. Corrija o problema indicado pelo estado da sessão e envie a fatura de novo, numa nova sessão. |
| 410 | Sem permissão para emitir esta fatura |
| 415 | Fatura com anexo não aceite |
| 430 | Ficheiro da fatura não passou na verificação |
| 435 | Não foi possível desencriptar o ficheiro da fatura KSeF, estado 435 da fatura: o KSeF não conseguiu desencriptar o ficheiro da fatura. Peça à assistência técnica do seu software que verifique a encriptação e envie depois a fatura de novo. |
| 440 | Fatura duplicada |
| 450 | Conteúdo da fatura não passou nas verificações |
| 500 | Erro desconhecido KSeF, estado 500: ocorreu um erro desconhecido enquanto o KSeF processava a fatura ou a sessão. Consulte o estado de novo mais tarde. Se continuar em 500, contacte o apoio do KSeF com o número de referência, antes de decidir se deve enviar a fatura de novo. |
| 550 | Operação cancelada pelo sistema KSeF, estado 550: o sistema cancelou a operação. Tente de novo, como aconselha a documentação do KSeF. |
Códigos de estado da sessão
| Código | O que significa |
|---|---|
| 405 | Pacote em lote não passou na verificação KSeF, estado 405 da sessão: os elementos do pacote em lote não passaram na verificação do KSeF. Peça à assistência técnica do seu software que verifique como o pacote é construído e declarado, e envie-o numa nova sessão em lote. |
| 415 | Não foi possível desencriptar a chave da sessão KSeF, estado 415 da sessão: o KSeF não conseguiu desencriptar a chave fornecida. Peça à assistência técnica do seu software que verifique a encriptação da chave e a chave pública utilizada, abra depois uma nova sessão e envie as faturas de novo. |
| 420 | Demasiadas faturas na sessão KSeF, estado 420 da sessão: a sessão excedeu o limite de faturas. Divida as faturas por várias sessões e envie-as de novo. |
| 430 | Não foi possível descomprimir o ficheiro ZIP do lote KSeF, estado de sessão 430: o KSeF não conseguiu descomprimir o ficheiro ZIP original do lote. Peça ao fornecedor do seu software que volte a criar o pacote. Depois, envie-o numa nova sessão em lote. |
| 435 | Não foi possível decifrar as partes do ficheiro do lote KSeF, estado de sessão 435: o KSeF não conseguiu decifrar as partes cifradas do ficheiro do lote. Peça ao fornecedor do seu software que verifique a cifra das partes. Depois, envie o pacote numa nova sessão em lote. |
| 440 | Sessão cancelada KSeF, estado de sessão 440: a sessão foi cancelada. Abra uma nova sessão e envie as faturas dentro do prazo permitido. |
| 445 | Nenhuma fatura válida na sessão KSeF, estado de sessão 445: a verificação não encontrou nenhuma fatura válida na sessão. Corrija os erros indicados nas faturas e confirme que o envio inclui faturas válidas. Depois, envie-as novamente. |
Códigos de erro no envio
| Código | O que significa |
|---|---|
| 21001 | Conteúdo ilegível KSeF, erro 21001: o KSeF não conseguiu ler o conteúdo do pedido. Peça ao fornecedor do seu software que verifique o pedido com base nos detalhes. Depois, envie-o novamente. |
| 21155 | Demasiadas faturas na sessão KSeF, erro 21155: a sessão atingiu o limite de faturas permitido. Feche a sessão e envie as faturas restantes numa nova sessão. |
| 21157 | Tamanho incorreto de uma parte do pacote KSeF, erro 21157: o tamanho de uma parte do pacote do lote não é válido. Volte a criar o pacote, de modo que cada parte respeite o limite e corresponda ao tamanho declarado. Depois, envie-o numa nova sessão em lote. |
| 21161 | Demasiadas partes no pacote KSeF, erro 21161: o pacote do lote tem mais partes do que o KSeF permite. Divida as faturas por várias sessões em lote e envie-as novamente. |
| 21166 | Correção técnica não disponível KSeF, erro 21166: não é possível enviar uma correção técnica, porque a fatura já tem uma correção técnica que o KSeF processou corretamente. Consulte o estado da correção técnica anterior, em vez de enviar outra. |
| 21167 | O estado da fatura não permite correção técnica KSeF, erro 21167: foi enviada uma correção técnica para uma fatura que o KSeF processou corretamente. Verifique se hashOfCorrectedInvoice contém o hash da fatura offline rejeitada, e não o de uma fatura aceite. |
| 21173 | Sessão não encontrada KSeF, erro 21173: não existe nenhuma sessão com o número de referência indicado. Utilize o número de referência correto da sessão e envie o pedido novamente. |
| 21178 | UPO não encontrado KSeF, erro 21178: o KSeF não encontrou nenhum UPO, o comprovativo oficial de receção, para os critérios indicados. Corrija os números e peça novamente o UPO. |
| 21180 | O estado da sessão não permite a operação KSeF 21180 significa que o estado da sessão não permite a operação pedida, por exemplo enviar faturas ou fechar a sessão. Verifique o estado da sessão e abra uma nova sessão para enviar as restantes faturas. |
| 21184 | Sessão temporariamente indisponível KSeF 21184 significa que a sessão está temporariamente indisponível devido a trabalhos de manutenção. Tente novamente mais tarde ou abra uma nova sessão para enviar as restantes faturas, conforme indicam os detalhes. |
| 21205 | Pacote vazio, falta uma parte declarada KSeF 21205 significa que o pacote não pode estar vazio: não foi enviada uma das partes declaradas. Envie a parte em falta identificada nos detalhes e confirme que todas as partes declaradas foram enviadas. |
| 21208 | Tempo de envio excedido KSeF 21208 significa que o tempo permitido para os pedidos upload ou finish foi excedido e a sessão foi cancelada. Abra uma nova sessão em lote e envie as partes dentro do tempo permitido. |
| 21402 | Tamanho do ficheiro incorreto KSeF 21402 significa que o tamanho do conteúdo enviado não corresponde ao tamanho declarado do ficheiro. Peça ao prestador do seu software de faturação que verifique se o tamanho declarado é o do ficheiro enviado e envie-o novamente. |
| 21403 | Hash do ficheiro incorreto KSeF 21403 significa que o hash do conteúdo enviado não corresponde ao hash declarado do ficheiro. Peça ao prestador do seu software de faturação que verifique se o hash declarado é calculado a partir do ficheiro enviado e envie-o novamente. |
| 21405 | Falha na verificação dos dados do pedido KSeF 21405 significa que os dados do pedido não passaram na verificação. Corrija o que os detalhes indicam e envie o pedido novamente. |
| 21470 | Chave desconhecida ou retirada KSeF 21470 significa que o identificador de chave enviado é desconhecido ou aponta para uma chave retirada. Peça ao prestador do seu software de faturação que use um identificador de chave suportado e envie o pedido novamente. |
Ler o documento oficial
- KSeF API 2.0, specyfikacja OpenAPI (open-api.json) Fonte: KSeF API 2.0, specyfikacja OpenAPI (open-api.json), versão 2.9.0, publicada por Ministerstwo Finansów, consultada em 8 de novembro de 2026. Texto oficial na língua original, de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, ao abrigo de MIT License.
- Weryfikacja faktury Fonte: Weryfikacja faktury, versão 09.04.2026, publicada por Ministerstwo Finansów, consultada em 8 de novembro de 2026. Texto oficial na língua original, de Ministerstwo Finansów, KSeF 2.0 Przewodnik dla Integratorów (github.com/CIRFMF/ksef-api), Copyright (c) 2025 Ministerstwo Finansów, ao abrigo de MIT License.
Perguntas frequentes
Onde posso ver o estado KSeF de uma fatura?
O seu programa de faturação lê-o no KSeF depois do envio: cada fatura de uma sessão recebe um código de estado, uma descrição e, quando o KSeF os fornece, detalhes. O estado 200 significa sucesso, e os estados 100 e 150 significam que o KSeF ainda está a processar a fatura.
Porque aparece o mesmo número duas vezes?
O KSeF usa os mesmos números para o estado de uma fatura e para o estado de uma sessão, com significados diferentes. Para uma fatura, 440 significa duplicado; para uma sessão, significa que a sessão foi cancelada. Verifique qual dos dois o seu programa mostra.
Que códigos não estão listados?
Os estados que indicam progresso ou sucesso, e os códigos de erro de início de sessão, certificados, tokens, permissões e transferência de faturas, que dizem respeito a um processo diferente do envio de uma fatura.
De onde vêm os códigos?
Da documentação da API KSeF 2.0 do Ministério das Finanças, publicada sob a licença MIT. Cada página de código cita o texto oficial em polaco e tem uma ligação para a fonte.