Código 450 do KSeF: «Błąd weryfikacji semantyki dokumentu faktury»

O que devolve o KSeF

Na especificação da API do KSeF 2.9.0, o estado 450 de uma fatura em sessão tem uma descrição fixa, «Błąd weryfikacji semantyki dokumentu faktury» (erro de verificação semântica do documento de fatura). O que falha em concreto é acrescentado pelo KSeF no campo details desse mesmo estado. O Ministério das Finanças polaco não publica a lista dessas mensagens, pelo que não existe uma tabela do género «o 450 é sempre esta falha».

O que existe são casos que o Ministério verifica nos testes da sua própria biblioteca ksef-client-csharp e nos quais espera precisamente o código 450:

• data de emissão P_1 colocada para amanhã segundo a hora polaca, porque o KSeF lê P_1 no fuso horário de Varsóvia e não aceita uma data posterior ao momento em que recebe a fatura;
• DataWytworzeniaFa anterior a 2025-09-01T00:00:00Z, o limite inferior desse campo no esquema FA(3) 1-0E.

O que vê no Odoo

As faturas chegam ao KSeF com o módulo l10n_pl_edi do Odoo, que existe no Odoo 18, 19 e 20. Quando o KSeF responde, põe «KSeF Status» em Rejected e escreve uma mensagem no histórico da fatura:

Da resposta do KSeF, o Odoo lê o código, a descrição e o número KSeF. Não guarda o campo details (apenas acrescenta a descrição do KSeF com o código 500), pelo que o Odoo, por si só, não lhe diz que parte da fatura falhou.

Onde obter o motivo

O texto de details vem na resposta do KSeF à consulta do estado da fatura. Se enviar a partir do Odoo, precisa de alguém que o leia da API ou de uma verificação do ficheiro FA(3) antes de o enviar. O Odoo 18, 19 e 20 trazem uma cópia do esquema FA(3) dentro do módulo, mas fora dos testes nada a usa: o ficheiro segue para o KSeF sem ser validado contra o esquema.

Duas coisas o Odoo vigia. Não envia uma fatura com data posterior a hoje no fuso horário do utilizador («The move was skipped because it is future-dated»). E preenche DataWytworzeniaFa com o momento em que gera o ficheiro, em UTC, pelo que o limite de 2025 não deveria vir de uma fatura emitida no Odoo.

Como voltar a enviá-la

1. Obtenha o motivo em details ou verifique o ficheiro FA(3) contra o esquema.
2. Corrija os dados no Odoo: data, cliente, linhas.
3. Repunha a fatura em rascunho. Numa fatura rejeitada, o Odoo limpa o seu estado, número, referência e sessão do KSeF.
4. Confirme-a e envie-a de novo com a opção «by KSeF (e-Faktura)». O Odoo só envia faturas sem estado KSeF, pelo que, sem o passo 3, nada sai.

Com o nosso módulo

O Poland KSeF 2.0 Validator não envia faturas ao KSeF. Com a subscrição do FlexigoTech Cloud, se carregar em «Validate FA(3) (FlexigoTech Cloud)» antes de enviar a fatura, valida o ficheiro FA(3) contra o esquema 1-0E e mostra cada falha como uma linha «[error] XSD (caminho)»: o sítio do ficheiro, sem o texto da mensagem, até 100 falhas. O resultado não trava o envio do l10n_pl_edi: uma fatura «Not valid» sai igualmente se a enviar. Não deteta o que o KSeF só verifica do seu lado, como P_1 face ao momento da receção. Quando o l10n_pl_edi envia a fatura, a validação anterior passa a Expired e o módulo revê o ficheiro que o KSeF recebeu. No Odoo 17 valida o FA(3) carregado para a fatura.

Continue a ler