Saltar para o conteúdo principal
VeriFactu

O que faz o botão Generate Export do VeriFactu Espanha no Odoo

O botão Generate Export prepara um ficheiro JSON de acordo com o Export Type que escolher e, logo a seguir, regista a exportação no livro de eventos da empresa. Vê-se sempre no ecrã Export Compliance Records; o que decide se chega lá são as suas permissões. Aqui fica o que faz com cada tipo, por que ordem e o que fica registado.

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

Onde está o botão e quem chega até ele

O assistente abre-se a partir do menu Verifactu / SIF › Reports & Exports › Export Wizard. Cada nível do menu exige permissões e, se não tiver uma delas, esse nível não aparece:

  • Reports & Exports exige Auditor (read-only) ou SIF Manager.
  • Verifactu / SIF exige Accountant, Asesoría Operator, Auditor (read-only), Privacy Officer ou SIF Manager.
Esquema do menu do assistente de exportação e do botão Generate Export
Esquema feito com código a partir do código publicado do módulo (não é uma captura do Odoo): o caminho de menu e o botão, no Odoo 17, 18, 19 e 20.

O botão Generate Export existe nos ramos 17.0, 18.0, 19.0 e 20.0 e, em todos, vê-se sempre, sem condição de estado. O comportamento descrito a seguir corresponde ao Odoo 20.0. O módulo está publicado no Odoo Apps para essas quatro versões (ficha).

Esquema do texto do botão consoante o idioma do Odoo
Esquema feito com código a partir das traduções publicadas do módulo (não é uma captura do Odoo): com o Odoo em espanhol o botão chama-se Generar Exportación; em catalão, Generar Exportació.

Passo a passo

  1. Abra o assistente a partir do menu. Verá a ficha Export Compliance Records, com os campos no grupo Parameters.
  2. Reveja Company. Por defeito aparece a empresa ativa; a exportação faz-se sobre a que figurar aí.
  3. Ajuste Date From e Date To. Por defeito, a primeira é o primeiro dia do ano em curso e a segunda é a data de hoje.
  4. Escolha Export Type. Por defeito vem Libro de Registros de Facturación; as outras opções são Libro de Eventos, Chain Integrity Report e Full Evidence Pack (Libro + Eventos + Declaración).
  5. Clique em Generate Export. O módulo executa a exportação do tipo escolhido e deixa o resultado como ficheiro JSON no próprio assistente.
  6. A seguir, o módulo regista um evento no livro de eventos da empresa (explico-o mais abaixo).
  7. A ficha volta a abrir-se numa janela emergente, sobre o mesmo assistente, com o resultado já guardado.

O que gera cada tipo

Tipo de exportaçãoO que incluiNome do ficheiro
Libro de Registros de FacturaciónOs registos da empresa com data de emissão entre Date From e Date To (ambas incluídas), ordenados por número de registo. De cada um: número de série, data de emissão, tipo de fatura, total, impressão digital e estado.Começa por libro_registros_ e leva as duas datas
Libro de EventosOs eventos da empresa desde Date From, ordenados por sequência. De cada um: sequência, tipo de evento, data e hora, descrição e impressão digital do evento.Começa por libro_eventos_ e leva as duas datas
Chain Integrity ReportO resultado da verificação de integridade da cadeia da empresa. Se a empresa ainda não tem cadeia, o relatório sai como superado, com zero registos verificados e sem primeira rutura.Começa por chain_integrity_ e leva o nome da empresa
Full Evidence Pack (Libro + Eventos + Declaración)O mesmo que o livro de registos.O do livro de registos

Três detalhes que saem do código:

  • No livro de eventos, Date To não filtra: o filtro usa apenas Date From, e a segunda data entra unicamente no nome do ficheiro.
  • O relatório de integridade não usa as datas para nada no seu conteúdo: trabalha sobre a cadeia da empresa.
  • No código do Odoo 20.0, a opção de pacote completo executa apenas a exportação do livro de registos. Se precisar também dos eventos, gere além disso o Libro de Eventos.

O evento que cada exportação deixa

Quando a exportação termina, seja de que tipo for, o módulo cria um evento de exportação de registos para a empresa. A sua descrição diz que tipo foi exportado e para que datas, e o seu contexto guarda o tipo de exportação e o formato de saída. O evento leva ainda:

  • um número de sequência próprio da empresa;
  • a marca temporal em UTC;
  • como ator, o utilizador que clicou no botão;
  • uma impressão digital SHA-256 calculada com o tipo, a marca temporal, a empresa, a descrição e o contexto.

Como o evento é criado depois de construir o ficheiro, a exportação desse mesmo clique não o inclui. Vê-lo-á no Libro de Eventos seguinte que o abranja com o seu Date From.

Outros eventos que verá no livro

O botão não é a única via que regista eventos. O módulo também pode criá-los sem que ninguém clique em Generate Export:

  • Ao guardar a ficha de uma empresa: quando muda o ambiente da AEAT, quando muda o responsável do SIF e quando muda o âmbito do Verifactu.
  • Ao cancelar uma fatura, porque o módulo amplia o botão padrão de cancelar do Odoo.
  • Com a tarefa agendada Verifactu: Clock Drift Check, que corre a cada hora e está ativa desde a instalação.

Por isso, um Libro de Eventos pode misturar eventos de exportação com outros vindos destas vias. O que o módulo acrescenta às faturas é explicado neste outro artigo.

Se algo não sair como espera

  • Não encontra o menu. Falta alguma das permissões de um nível: reveja as da lista do início.
  • O ficheiro sai com uma lista vazia. No livro de registos, nenhum registo da empresa escolhida tem data de emissão dentro do intervalo. Verifique Company, Date From e Date To.
  • O relatório de integridade sai superado com zero registos verificados. É o que o código devolve quando a empresa ainda não tem cadeia.
  • Exporta outra empresa sem querer. O assistente trabalha com a que figurar em Company: verifique esse campo antes de clicar no botão.

Como a FlexigoTech o pode ajudar

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se precisar de adaptar a forma como se obtêm estes ficheiros ou de rever quem tem acesso ao menu, conte-nos o seu caso.

Continue a ler

O que o VeriFactu España acrescenta à fatura do Odoo e quando atuaCampos que o VeriFactu España acrescenta à fatura do Odoo, quando cria o registo ao publicá-la e como verificar que atuou, passo a passo.«Only a SIF Manager can retry AEAT submissions.»: quando aparece e o que fazerO que significa o aviso «Only a SIF Manager can retry AEAT submissions.» no VeriFactu para Odoo: quando aparece, que botões o provocam e como resolver.Run Pre-flight & Create no VeriFactu: checklist passo a passoChecklist do botão «Run Pre-flight & Create» do VeriFactu Espanha para Odoo: quando aparece, o que verifica, o que altera e que erros mostra.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes