Saltar para o conteúdo principal
VeriFactu

Erros do VeriFactu no Odoo: como ler o que diz a AEAT e o que o seu próprio sistema trava antes

Um erro do VeriFactu pode vir de dois sítios: da AEAT, que responde a cada remessa com um estado e um código, ou do seu próprio sistema, que bloqueia a fatura antes de a enviar se faltar algo, como o certificado ou um NIF válido. Distingui-los poupa tempo, porque se corrigem em sítios diferentes. Aqui ficam os dois grupos.

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

O essencial

Módulo
VeriFactu
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 a AEAT responde

Cada remessa leva entre 1 e 1 000 registos. A resposta traz um estado para a remessa inteira (Correcto, ParcialmenteCorrecto ou Incorrecto), um estado por registo (Correcto, AceptadoConErrores ou Incorrecto) e o tempo de espera até à remessa seguinte.

A AEAT publica o seu catálogo oficial de erros, com 247 códigos, em três famílias:

FamíliaO que significaO que fazer
4xxx: remessa inteira rejeitadaNada dessa remessa foi registado.Corrija a causa e reenvie a remessa inteira.
Registo rejeitadoEsse registo não é aceite; o resto da remessa, sim.Corrija esse registo e reenvie apenas esse.
2xxx: aceite com errosO registo fica registado, mas há algo a corrigir.Não o reenvie como novo: corrija o que o código indica.

Há dois casos concretos que convém reconhecer à primeira. O código 3000 assinala um registo duplicado: se já aparece como correto ou aceite com erros, não é preciso reenviá-lo. E a impressão digital, um SHA-256 encadeado com o registo anterior, é recalculada pela AEAT: se não coincidir, o registo é aceite com um erro que tem de ser corrigido.

Lista de erros devolvidos pela AEAT dentro do Odoo
Os erros da AEAT, registo a registo e agrupados por código, dentro do Odoo. Captura do Odoo com dados de demonstração; as respostas da AEAT são simuladas.

Antes de chegar à AEAT: o certificado

A AEAT identifica o emissor pelo certificado apresentado ao ligar. Sem certificado, o seu serviço redireciona para a página de erro 4033, «certificado não detetado». Com um certificado que não valida, para a 4011. No Odoo, estes casos são travados antes:

  • No active certificate for company …: a empresa não tem nenhum certificado ativo. Carregue-o em Configuration › Certificates.
  • The certificate … of company … has expired.: expirou. Há um alerta diário de validade para não chegar a este ponto.

O que o seu sistema bloqueia antes de enviar

MensagemO que faltaSolução
Company … has no NIF for Veri*Factu.A empresa não tem NIF.Preencha-o nos dados da empresa.
Invalid NIF length: "…" (must be 9 chars)O NIF do cliente não tem 9 caracteres.Verifique o NIF no contacto.
Invalid NIF digits: "…"O NIF contém caracteres inválidos.Corrija-o no contacto.
Cannot post invoice: invalid counterparty identifier.O identificador do cliente não é válido.Corrija o identificador antes de lançar.
Record … has no tax breakdown (Desglose) to declare.A fatura não tem discriminação de impostos.Verifique os impostos nas linhas.
Record … is chained to a previous record that does not exist.A cadeia de registos está partida.Não lhe mexa à mão: verifique o estado da cadeia e escreva-nos.
The AEAT accepts at most 1000 records per request.Uma remessa com mais registos do que o permitido.A fila divide-os; se vir isto, avise-nos.
Catálogo de erros da AEAT carregado no Odoo
O catálogo de erros da AEAT dentro do Odoo, com os seus 247 códigos, para ler cada um sem sair do sistema. Captura do Odoo com dados de demonstração.

Onde ver no Odoo

A fila de remessas processa-se a cada minuto e está em AEAT Submission › Submission Queue. Os erros devolvidos pela AEAT têm a sua própria lista em AEAT Errors, e o catálogo completo de códigos em AEAT Error Catalogue. Esses três ecrãs resolvem a maioria dos casos sem abrir o documento técnico da AEAT, embora tenha a ligação abaixo caso precise dele.

Fila de remessas para a AEAT no Odoo
A fila de remessas: o que está pendente, o que foi enviado e o que falhou. Captura do Odoo com dados de demonstração; as respostas da AEAT são simuladas.

O módulo está publicado para o Odoo 17, 18, 19 e 20. Se um código não estiver no catálogo, envie-nos o texto exato da resposta: vamos encontrá-lo no documento oficial de validações.

Continue a ler

VeriFactu: os prazos de 2027, a previsão de 2028 e o que fazer entretanto no OdooO calendário do VeriFactu em novembro de 2026: prazos do RDL 15/2025, a previsão do Ministério de adiar para outubro de 2028 e o que preparar já no Odoo.VeriFactu: mitos e factos para empresas que faturam com o OdooCrenças comuns sobre o VeriFactu comparadas com a AEAT e com o próprio sistema: impressão digital, erros aceites, anulações, migrações, prazos e o módulo do Odoo.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes