Saltar para o conteúdo principal
UAE FTA E-Invoicing Connector

UAE FTA E-Invoicing Connector (PINT AE): checklist para o pôr a funcionar no Odoo

Para pôr a funcionar o UAE FTA E-Invoicing Connector (PINT AE), preenche o formulário de configuração associado à sua empresa: TIN, fase de conformidade e respetivas datas, modo de transmissão, diários ativados, credenciais do ASP e limites de alerta. Convém arrancar com Sandbox Mode ativado. Na primeira semana, acompanhe o painel de conformidade agrupado por estado, o registo de auditoria e os contadores de falhas da configuração.

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

Antes de abrir o formulário de configuração

O formulário de configuração está associado a uma empresa através do campo Company. Antes de lhe mexer, reúna os dados que lhe vão ser pedidos e tome algumas decisões. O módulo está publicado na Odoo Apps para Odoo 17, 18, 19 e 20, a 49 € sem IVA por versão, em pagamento único.

  • Tenha à mão o número de identificação fiscal da empresa: o campo UAE TIN pede o número de identificação do contribuinte dos EAU, de 10 dígitos, atribuído pela FTA.
  • Reúna os dados de acesso do seu prestador de serviços acreditado (ASP): o formulário tem uma secção ASP Credentials onde ficam guardados.
  • Decida que diários do Odoo vão transmitir faturas eletrónicas: os que registar ficam em Enabled Journals.
  • Escolha a caixa de correio que vai receber as notificações de conformidade da FTA, para o campo FTA Contact Email.
  • Verifique se a sua empresa está fora dos EAU: o formulário tem a caixa Non-UAE Company, que deve marcar ou deixar vazia conforme o seu caso.
Sequência com o painel de conformidade agrupado por estado, a fila de transmissão com faturas em vários estados, o assistente de configuração no passo do TIN e uma fatura de cliente publicada com a secção UAE E-Invoice no estado Accepted
Do painel à fila de transmissão, o assistente UAE E-Invoicing Setup Wizard no passo TIN Entry e uma fatura já aceite

Identificação e fase de conformidade

Esta parte do formulário identifica a empresa e fixa as datas que o módulo tem em conta. Não indicamos aqui essas datas: obtenha-as junto da FTA ou do seu consultor fiscal.

  • UAE TIN: introduza o TIN de 10 dígitos tal como a FTA o atribuiu.
  • Peppol Participant ID: segundo a ajuda do campo, deriva do TIN com o esquema de endereço eletrónico dos EAU 0235 (FR-015). Confirme que corresponde ao TIN que acabou de introduzir.
  • Compliance Phase: selecione a fase de conformidade que se aplica à sua empresa.
  • Mandatory Date: a ajuda do campo descreve-a como a data a partir da qual a faturação eletrónica é obrigatória para essa fase.
  • ASP Appointment Deadline: a ajuda descreve-o como o prazo para nomear um prestador de serviços acreditado.
  • Retention Period (years): a ajuda do campo descreve-o como o período mínimo de conservação de documentos da FTA e cita o Federal Decree-Law No. 8/2017, Art. 67. Confirme o valor com o seu consultor antes de o deixar fixado.
Formulário de configuração da faturação eletrónica dos EAU para YourCompany com secções de identificação, conformidade, transmissão, limites e alertas, e o separador de diários ativados com Sales
A configuração de YourCompany com dados de demonstração: diário Sales ativado e modo sandbox ligado

Transmissão, diários e credenciais

Aqui decide para onde vão as faturas, a partir de que diários e com que credenciais.

  • Sandbox Mode: use-o para os testes e verifique o seu estado antes de faturar a sério.
  • Transmission Mode: escolha o modo de transmissão na lista pendente.
  • Batch Cron: é a ação agendada para a transmissão por lotes. Veja que ação está associada ao campo.
  • Enabled Journals: cada linha associa um Journal à caixa Enabled. Se a caixa estiver desmarcada, as faturas desse diário não são transmitidas, por isso confirme que está marcada em todos os diários que devem enviar.
  • ASP Credentials: registe as credenciais do seu ASP.
  • Credential Warning Days: indique com quantos dias de antecedência quer o aviso de que um certificado de credencial vai expirar.
  • Show Verification QR on Invoice Printout: se o ativar, o módulo acrescenta um código QR de verificação (vendedor, TRN, data, totais). Imprima uma fatura de teste para ver o resultado.

Limites e alertas

Dois campos definem quando dispara um aviso. Dê-lhes um valor que faça sentido para o seu volume de faturas.

  • Alert Threshold (invoices): número de faturas pendentes a partir do qual é disparado um alerta de conformidade.
  • Failure Threshold: número de falhas consecutivas antes de ser enviado um alerta de episódio de falha.

No mesmo formulário estão Consecutive Failures, Failure Episode Active e Last Failure Notification Sent. Não os preenche ao configurar, mas convém saber onde estão, porque vai consultá-los na revisão da primeira semana.

Os estados que vai ver no painel

O painel de conformidade agrupa as faturas por estado. Na captura aparecem Accepted, Not Transmitted, Queued, Rejected e Transmitted, com o montante sem impostos, o total de cada grupo e uma linha de totais. Se quiser saber o percurso interno de uma fatura, explicamos em como funciona o conector por dentro.

Lista Compliance Dashboard da Faturação agrupada por estado com os grupos Accepted, Not Transmitted, Queued, Rejected e Transmitted, colunas de montante sem impostos e total, e linha de totais
O painel de conformidade agrupado por estado, em Invoicing › Compliance Dashboard

O que rever na primeira semana

  • Abra o painel de conformidade agrupado por estado e reveja o grupo Rejected todos os dias.
  • Veja também o grupo Not Transmitted e, se houver faturas de um diário concreto, confirme em Enabled Journals que esse diário tem a caixa Enabled marcada.
  • Consulte o registo de auditoria: cada linha mostra a data e hora, a fatura, a empresa, o estado, o protocolo, o ID de validação da FTA e o código de resposta do ASP.
  • Na configuração, reveja Consecutive Failures e Failure Episode Active, e a data de Last Failure Notification Sent.
  • Confirme que a caixa de correio de FTA Contact Email recebe as notificações de conformidade.
  • Confirme o valor de Sandbox Mode: se já fatura a sério, verifique que não continua ativado.
  • Compare as datas de expiração das suas ASP Credentials com o que definiu em Credential Warning Days.
Lista do registo de auditoria de faturas eletrónicas dos EAU com data e hora, fatura, empresa, estado, protocolo, ID de validação FTA e código de resposta ASP
O registo de auditoria, em Invoicing › UAE E-Invoicing › UAE E-Invoice Audit Log

Se no registo ou numa fatura aparecer uma mensagem que não entende, procure-a em os erros e avisos do conector, com os textos literais do módulo.

Como a FlexigoTech o ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser que alguém reveja esta lista consigo antes de sair do sandbox, ou precisar de encaixar o conector noutros desenvolvimentos do seu Odoo, encontra os detalhes na página do módulo e na respetiva ficha da Odoo Apps.

Continue a ler

Como funciona o UAE FTA E-Invoicing Connector (PINT AE) no Odoo: menus, tarefas e registosMenus, ações agendadas e modelos do UAE FTA E-Invoicing Connector (PINT AE) no Odoo: o que acrescenta, com que frequência corre cada tarefa e o que surge na fatura.Erros do UAE FTA E-Invoicing Connector (PINT AE): um caso de exemplo do início ao fimAs mensagens de erro do UAE FTA E-Invoicing Connector (PINT AE) no Odoo, com o texto literal, quando surgem e o que fazer, num caso de exemplo completo.UAE FTA E-Invoicing Connector (PINT AE): o que cobre, o que não cobre e se serve ao seu OdooO que cobre e o que não cobre o conector UAE FTA E-Invoicing (PINT AE) para Odoo segundo a documentação, o que precisa antes de o instalar e em que versões existe.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes