Saltar para o conteúdo principal
VeriFactu

Erros 4120 a 4133 do VeriFactu: o cabeçalho da remessa voluntária e do requerimento

Há duas maneiras de enviar registos à AEAT: por iniciativa própria, como sistema VERI*FACTU, ou quando a AEAT os pede num requerimento, como sistema No VERI*FACTU. Cada uma tem os seus campos no cabeçalho do envio e não se podem misturar. Dez códigos vigiam essa fronteira, e todos rejeitam o pedido completo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 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

Os campos de cada modalidade

O documento de validações da AEAT reparte assim os campos do cabeçalho:

FechaFinVeriFactu
Só em sistemas que emitem faturas verificáveis. A partir de 1 de janeiro de 2027 deve ter o formato 31-12-20XX, com o ano igual ao do sistema da AEAT ou ao anterior.
Incidencia
Só em sistemas que emitem faturas verificáveis.
RefRequerimiento
Só em sistemas que emitem faturas não verificáveis, e obrigatório neles. A referência tem de existir na AEAT.

Como tudo o que falha no cabeçalho, qualquer destes erros rejeita o envio inteiro: não entra nenhuma fatura.

Cartão dos códigos de cabeçalho por modalidade do VeriFactu
Os dez códigos do cabeçalho por modalidade, a vermelho: todos rejeitam o pedido completo.

A diferença não é só de campos. Na remessa por requerimento, segundo o ponto 4.3.2 do documento da AEAT, os erros de negócio não se corrigem: enviam-se os registos tal como foram conservados no sistema ao gerá-los, e esses erros marcam-se como admissíveis, exceto os de identificação do NIF ou do IDOtro.

Os dez códigos

CódigoO que diz a AEAT, em resumo
4120FechaFinVeriFactu incorreta: deve ser 31-12-20XX, do ano atual ou do anterior.
4121Valor incorreto em Incidencia.
4122Valor incorreto em RefRequerimiento.
4125Num envio por requerimento, RefRequerimiento é obrigatório.
4126RefRequerimiento só se informa nos envios que respondem a um requerimento.
4127A remessa voluntária só se informa em sistemas VERI*FACTU.
4129FinRequerimiento é obrigatório.
4130FinRequerimiento só se informa em sistemas No VERI*FACTU.
4131Valor incorreto em FinRequerimiento.
4133RefRequerimiento não é alfanumérico.

Que cabeçalho envia o nosso módulo

O cabeçalho que o módulo constrói leva apenas duas coisas: o obrigado a emitir, com o nome e o NIF da empresa, e o Representante quando há gabinete de contabilidade. Não leva bloco de remessa voluntária nem de requerimento, nem nenhum dos campos acima. Por isso estes dez códigos não podem sair de um envio seu.

O módulo conhece as duas modalidades: cada série de faturação tem a sua, e nos dados do sistema informático declara que não se usa só como VERI*FACTU. O que envia à AEAT são as inscrições e anulações da remessa voluntária.

Séries de faturação do VeriFactu no Odoo com a sua modalidade
As séries de faturação do VeriFactu de uma empresa, cada uma com o seu prefixo, a sua modalidade e o seu ambiente da AEAT. Captura do Odoo 20 com dados de demonstração.

O que fazer se receber um

Se vir um destes códigos, o envio não saiu do nosso módulo tal como o publicamos: ou alguém alterou a forma como se constrói o cabeçalho, ou é outro programa a enviar com o seu NIF. Nos dois casos:

  1. Veja em Envio à AEAT › Erros AEAT que envios trazem o código e de que empresa são.
  2. Guarde a resposta completa do envio, o campo Raw Response da fila.
  3. Escreva para comercial@flexigobe.com antes de reenviar seja o que for.

Os códigos desta página, com o texto da AEAT

Cada código com o seu texto literal, tal como o dá a lista de erros da AEAT:

CódigoTexto da AEAT
4120Error en la cabecera: el valor del campo FechaFinVeriFactu es incorrecto, debe ser 31-12-20XX, donde XX corresponde con el año actual o el anterior.
4121Error en la cabecera: el valor del campo Incidencia es incorrecto.
4122Error en la cabecera: el valor del campo RefRequerimiento es incorrecto.
4125Error en la cabecera: Si el envío es por requerimiento el campo RefRequerimiento es obligatorio.
4126Error en la cabecera: el campo RefRequerimiento solo debe informarse en sistemas en remisiones al endpoint del servicio a usar para la contestación a requerimientos de registros de facturación.
4127Error en la cabecera: la remisión voluntaria solo debe informarse en sistemas VERIFACTU.
4129Error en la cabecera: el campo FinRequerimiento es obligatorio.
4130Error en la cabecera: el campo FinRequerimiento solo debe informarse en sistemas No VERIFACTU.
4131Error en la cabecera: el valor del campo FinRequerimiento es incorrecto.
4133Error en la cabecera: el valor del campo RefRequerimiento no es alfanumérico.

E se a AEAT me enviar um requerimento?

O módulo publicado não responde a requerimentos por si só, porque não constrói o cabeçalho de requerimento. Se receber um, escreva-nos e vemos consigo como o tratar.

Continue a ler

Erros de VeriFactu com o NIF da sua empresa: 4104, 4107, 4109, 4115, 4116 e a família de IDEmisorFacturaOs erros de VeriFactu do NIF do emissor (4104, 4107, 4109, 4115, 4116, 1108, 1215…): o que a AEAT verifica, de que campo vem no Odoo e como reenviar.Erros 4105, 4117, 4123 e 4124 do VeriFactu: quando o gabinete envia por siErros do VeriFactu no bloco Representante (4105, 4117, 4123, 4124) quando o gabinete envia por si: o que a AEAT verifica e que campos do Odoo o preenchem.Erro 4134 do VeriFactu: «Servicio no activo», o que acontece às suas faturas e como as reenviarO que significa o erro 4134 da AEAT no VeriFactu, porque rejeita o envio inteiro e como reenviar as faturas a partir do Odoo 17, 18, 19 e 20 sem perder nenhuma.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes