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

Código 440 do KSeF: «Duplikat faktury»

O KSeF rejeita uma fatura com o estado 440 quando já tem outra do mesmo vendedor, do mesmo tipo e com o mesmo número. É o único código de rejeição para o qual o Ministério das Finanças polaco publica a regra exata, pelo que a causa se encontra sem suposições.

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

Quando o KSeF considera uma fatura duplicada

O KSeF procura duplicados em todas as faturas guardadas no sistema. Três campos decidem:

  • o NIF do vendedor, Podmiot1:NIP;
  • o tipo de fatura, RodzajFaktury;
  • o número da fatura, P_2, que segundo o esquema FA(3) tem de identificar a fatura sem ambiguidade.

A unicidade dura 10 anos completos, contados a partir do fim do ano em que a fatura foi emitida. Conta sempre o NIF do vendedor: se várias sucursais ou unidades emitirem em nome da mesma empresa, têm de acordar a numeração.

Ficha do código 440 do KSeF
O código 440 e os três campos com que o KSeF deteta um duplicado.

O que traz a resposta e o que guarda o Odoo

Na resposta do KSeF, o estado 440 tem a descrição «Duplikat faktury» (fatura duplicada) e dois campos em extensions: originalKsefNumber, o número KSeF da fatura que já está no sistema, e originalSessionReferenceNumber, a sessão em que entrou. O exemplo da documentação da API põe em details uma mensagem do tipo «Duplikat faktury. Faktura o numerze KSeF: … została już prawidłowo przesłana do systemu w sesji: …».

No Odoo 18, 19 e 20, o módulo l10n_pl_edi põe o «KSeF Status» em Rejected e acrescenta ao histórico «KSeF Status: Rejected (Code: 440). Duplicate invoice.» (em polaco na 18 e na 19: «Status KSeF: Odrzucono (Kod: 440). Powielona faktura.»). O Odoo não guarda extensions, por isso o número KSeF do original não aparece na fatura. Como P_2, o Odoo escreve o número da fatura no Odoo.

De onde surge um duplicado com faturas do Odoo

SituaçãoO que acontece
A fatura já chegou ao KSeF por outro canal e depois foi enviada a partir do OdooO original está no KSeF; o novo envio recebe 440.
O mesmo NIF emite a partir de duas bases ou empresas do Odoo com sequências idênticasDuas faturas diferentes partilham tipo e número.
As sucursais de uma empresa mantêm numerações próprias que se sobrepõemO KSeF conta o NIF do vendedor, não a sucursal.

O Odoo só envia faturas sem estado KSeF. Uma fatura em Sent ou Accepted não pode ser enviada uma segunda vez por descuido a partir do mesmo Odoo.

Como resolver

  1. Localize o original: o número KSeF de originalKsefNumber ou a fatura com esse número no KSeF.
  2. Se for a mesma fatura, enviada antes por outro canal, não a volte a enviar. Cada novo envio com esse número recebe 440.
  3. Se for outra fatura com o mesmo número, o problema está na numeração: acorde com a sua contabilidade séries separadas para cada base, empresa ou sucursal que partilhe o NIF.

A fatura está no KSeF depois de um 440?

Sim. No KSeF está a fatura original, a de originalKsefNumber. Só foi rejeitado o novo envio.

Durante quanto tempo o KSeF recorda um número de fatura?

Durante 10 anos completos a partir do fim do ano de emissão. Até lá, o mesmo NIF, tipo e número dão 440.

Esquema: o que devolve o KSeF com o código 440 e o que mostra o Odoo 20
Esquema feito a partir do código do 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.

Com o nosso módulo

O Poland KSeF 2.0 Validator não envia faturas, mas tem o botão «Mark accepted by KSeF» para uma fatura carregada no KSeF fora do Odoo, com o número KSeF atribuído pelo sistema. Se mais tarde o l10n_pl_edi também enviar essa fatura e o KSeF a rejeitar, o módulo mantém-na Accepted e acrescenta: «KSeF rejected the new sending of this invoice by l10n_pl_edi, already accepted by KSeF with KSeF number …: it stays Accepted.». Nos restantes casos, toma do l10n_pl_edi o estado Rejected, sem o código 440.

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.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.Estados técnicos da fatura no KSeF: 550, 500, 405, 430 e 435Estados da fatura no KSeF alheios ao seu conteúdo: 550 «Operacja została anulowana przez system», 500, 405, 430 e 435. O que faz o Odoo e porque o 550 fica em Sent.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes