Saltar para o conteúdo principal
Portugal e-Invoice Files: CIUS-PT XML, ATCUD and QR

Mensagens de erro do Portugal e-Invoice Files no Odoo: quando surgem e o que fazer

Os avisos do Portugal e-Invoice Files dividem-se em quatro grupos: faturas emitidas e séries, SAF-T, registo de auditoria e pedidos de dados (DSAR). Quase todos dizem no próprio texto o que falta ou que caminho seguir: corrigir com nota de crédito ou débito, emitir apenas rascunhos, preencher o código de registo da série ou arquivar antes de apagar. Aqui tem cada mensagem literal, quando surge segundo o seu texto e o que pode fazer.

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

O essencial

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
5 min

Faturas emitidas, séries e SAF-T

Porque não consigo alterar nem apagar uma fatura já emitida?

O módulo bloqueia-o com três mensagens: Invoice immutable; correct via credit/debit note, Invoice immutable; cannot modify {illegal_fields} e Cannot delete issued invoice; use credit/debit note for corrections. As três dizem o mesmo: a fatura emitida não se edita nem se elimina. Se houver algo a corrigir, a própria mensagem indica o caminho: uma nota de crédito ou uma nota de débito. Na segunda mensagem, {illegal_fields} é a parte variável do texto tal como está escrita no código do módulo.

O que significa Only draft invoices can be issued?

Este aviso surge em duas formas, Only draft invoices can be issued e Only draft invoices can be issued, e o texto é direto: só se podem emitir faturas em rascunho. Se lhe aparecer, verifique o estado da fatura com que está a trabalhar antes de tentar novamente.

O que faço com os avisos sobre as séries de faturação?

Há quatro mensagens relacionadas com as séries:

  • No invoice series configured: não há nenhuma série de faturação configurada. Crie uma antes de continuar.
  • Series {record.series_code} not registered with AT; registration code missing: a série indicada na mensagem não está registada na AT porque lhe falta o código de registo. Preencha-o na série.
  • Invalid AT validation code: {validation_code}: o código de validação da AT introduzido não é válido. Reveja o código que escreveu.
  • Series sequence cannot go below 1: a sequência da série não pode ficar abaixo de 1. Corrija o valor da sequência.

As séries estão na lista Invoicing › Invoice Series, com as colunas Company, Series Code, AT Validation Code e Active, entre outras.

Lista Invoice Series da Faturação do Odoo com as colunas Company, Series Code, AT Validation Code e Active
A lista Invoice Series, ainda sem registos: aqui vê-se o código da série e o código de validação da AT.

O módulo também acrescenta a lista do modelo eif.payment.terms, com as colunas Invoice, Payment Terms, Due Date, Early Payment e Discount.

Lista do modelo eif.payment.terms com as colunas Invoice, Payment Terms, Due Date, Early Payment e Discount
A lista de eif.payment.terms, ainda sem registos.

Porque não gera nem envia o SAF-T?

Porque, segundo as suas próprias mensagens, essas funções ainda não existem no módulo: Not generated: SAF-T PT XML generation is not available in this module yet. e Not sent: submitting SAF-T to Portal das Finanças is not available in this module yet. Não é uma falha da sua configuração: o XML do SAF-T PT e o seu envio para o Portal das Finanças têm de ser tratados fora deste módulo. Outro aviso diferente é Select a SAF-T filing first, que surge em dois pontos do código e pede que selecione primeiro uma declaração SAF-T.

Registo de auditoria (Audit Trail)

O que significam os avisos do registo de auditoria?

São três. Audit trail is immutable and cannot be modified e Audit trail is immutable and cannot be deleted dizem que os registos de auditoria não podem ser alterados nem apagados. O terceiro, Audit trail tampering detected!, indica que o módulo detetou uma manipulação do registo. Se lhe aparecer, não tente refazer o registo à mão (as outras duas mensagens já dizem que não é possível) e reveja a lista Audit Trail com quem administra o seu Odoo.

Lista Audit Trail da Faturação no Odoo com as colunas Invoice, Timestamp (UTC), User, Action Type e Hash Signature
A lista Audit Trail, ainda sem registos: fatura, data e hora em UTC, utilizador, tipo de ação e assinatura hash.

Pedidos de dados pessoais (DSAR)

Porque me pede para verificar, avaliar ou responder primeiro?

Os pedidos de dados têm passos e o módulo avisa quando falta um: DSAR must be verified first (falta verificá-lo), DSAR must be assessed first (falta avaliá-lo, e surge em dois pontos do código) e DSAR must be responded first (falta responder-lhe). Se tentar verificar um que já está verificado, surge DSAR already verified. Faça o passo que a mensagem indica e tente novamente.

O que faço com Customer not found?

A mensagem completa é Customer not found for {record.identifier_type}={record.identifier_value}. O módulo não encontra um cliente com o tipo e o valor de identificador do pedido. Reveja esses dois dados no pedido.

Porque é que a resposta aparece como Not delivered?

Há dois casos. Not delivered: this module only delivers the response by email and this request has no email address. Send the response to the data subject yourself. O módulo só entrega a resposta por e-mail e o pedido não tem endereço de e-mail: terá de ser você a enviar a resposta ao titular dos dados. O outro é Not delivered: the email to %(email)s could not be sent (%(reason)s)., que diz que o e-mail não pôde ser enviado e inclui o endereço e o motivo; comece por esse motivo.

Porque não consigo apagar um pedido?

Por causa de Cannot delete active DSAR request; must be archived first: um pedido ativo não se apaga. Arquive-o primeiro.

Sequência de listas da Faturação: Data Subject Requests, Electronic Invoices, eif.payment.terms e Audit Trail
A lista Data Subject Requests com um pedido de teste no estado Pending, e depois as listas Electronic Invoices (com colunas como ATCUD, SAF-T Filing Status e State), eif.payment.terms e Audit Trail, sem registos.

Como a FlexigoTech o ajuda

Se quiser perceber que menus o módulo acrescenta antes de lidar com os avisos, explicamos isso em como funciona o Portugal e-Invoice Files por dentro. O módulo está na Odoo Apps para Odoo 17, 18, 19 e 20 a 9 € por versão do Odoo, pagamento único, sem IVA. Se o comprar em flexigotech.com com a subscrição, o módulo para as novas versões do Odoo está incluído; na Odoo App Store, cada versão é comprada lá. Além disso, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, caso precise de algo que o módulo ainda não cubra.

Continue a ler

Como funciona o Portugal e-Invoice Files no Odoo: menus, modelos e assistentesGlossário do Portugal e-Invoice Files no Odoo: o menu Invoicing › e-Fatura, as suas secções, os modelos eif e os assistentes de ATCUD, QR, SAF-T e RGPD.Como funciona o Peru SUNAT SIRE RVIE/RCE Reconciliation por dentro do OdooQue menus o Peru SUNAT SIRE RVIE/RCE Reconciliation acrescenta ao Odoo, que ações agendadas executa e que modelos o módulo define, em perguntas.Erros do Peru SUNAT SIRE RVIE/RCE Reconciliation: o que a ficha não contaAs mensagens de erro do Peru SUNAT SIRE RVIE/RCE Reconciliation no Odoo com o texto literal: o que diz cada uma e o que verificar antes de tentar de novo.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes