Español
English
Català
Deutsch
Français
Italiano
Nederlands
PolskiPara quem é e para quem não é, em resumo
Quando confirma uma fatura ou uma nota de crédito de cliente num diário ativado, o conector gera um XML UBL 2.1 que segue a estrutura PINT AE, verifica-o com o validador próprio do módulo e guarda-o como anexo na fatura. Fora do modo sandbox, envia esse XML para o endpoint que configurar.
Serve-lhe se quer montar esse fluxo no Odoo, testá-lo com o simulador e, se o seu fornecedor acreditado aceitar o contrato genérico do módulo, enviar-lhe as faturas. Não lhe serve, tal como está documentado, se precisa que o XML cumpra as regras do PINT AE 1.0.4, se o seu fornecedor só trabalha com a sua própria API ou se quer receber faturas de fornecedores: o módulo não as recebe.
Seis ideias erradas antes de comprar
«Se o instalar, as minhas faturas já cumprem o PINT AE»
A ficha é clara: o XML não foi validado contra as regras do PINT AE 1.0.4 e falha várias. As que enumera são estas: as notas de crédito são enviadas como faturas, faltam os indicadores de tipo de transação, as faturas em moeda estrangeira não incluem os montantes em AED e o endpoint do comprador usa o TRN de 15 dígitos em vez do TIN de 10 dígitos. O validador que verifica o XML é o do próprio módulo. Se emite notas de crédito ou faturas noutra moeda, são precisamente os casos que a ficha assinala como falhados.
«Liga-se a qualquer fornecedor acreditado (ASP)»
Não há integração com nenhum fornecedor acreditado pela FTA em concreto. A ficha explica que os fornecedores acreditados não partilham uma API padrão, por isso a opção REST só funciona com um fornecedor que aceite o contrato genérico do módulo: um POST para /invoices com um bearer token e consulta periódica do estado. A outra opção é um envelope SOAP AS4 básico, sem WS-Security nem pesquisa SMP. Antes de decidir, pergunte ao seu fornecedor se aceita algum destes dois formatos.
«Se vejo Accepted, a FTA aceitou a fatura»
O modo sandbox vem ativado por predefinição e executa um simulador de fornecedor dentro do Odoo. Em sandbox nada sai do Odoo, e os estados Accepted e os números de referência que aí vê são simulados. Serve para percorrer o fluxo completo no ecrã, não como prova de envio real.
Accepted é simulado.«O FTA Clearance ID é a autorização da FTA»
O campo chama-se FTA Clearance ID na app, mas a ficha do módulo esclarece que apenas guarda a referência devolvida pelo fornecedor. Segundo essa mesma ficha, o sistema dos EAU não tem um passo de autorização prévia (clearance): no modelo dos EAU é o fornecedor quem comunica os dados fiscais à FTA, e a FTA não autoriza as faturas antes de serem enviadas. A resposta e a referência do fornecedor ficam na fatura e num registo de auditoria que não pode ser editado nem apagado.
«Com uma credencial ativa, o módulo assina as faturas»
Com uma credencial ativa, o módulo insere um elemento de assinatura de preenchimento em vez de uma assinatura real. A ficha acrescenta que o PINT AE não pede uma assinatura dentro do documento e que esse elemento torna o XML inválido.
«O QR do PDF é exigido pela regulamentação e emitido pela FTA»
O código QR no PDF da fatura é opcional. A documentação do módulo indica que as regras dos EAU não exigem um QR nas faturas eletrónicas e que este QR não é emitido pela FTA.
O que inclui e o que precisa antes de instalar
Além de gerar e enviar o XML, o módulo inclui:
- Envio imediato ou por lotes agendados, novas tentativas com back-off, limitação de ritmo e um webhook para as respostas do fornecedor assinado com HMAC.
- Um assistente de configuração e definições por empresa: TIN, fase e respetivas datas, e diários.
- Credenciais do fornecedor cifradas com uma chave que define no ambiente do servidor (
FLEXIGO_UAE_EINVOICE_FERNET_KEY) e avisos de expiração de certificados.
- O XML anexado à fatura e um assistente que exporta num ZIP as faturas eletrónicas de um TRN.
O README indica como requisito o Odoo 20 com o módulo l10n_ae (localização dos EAU). Na Odoo Apps está publicado para 17.0, 18.0, 19.0 e 20.0, e nas quatro fichas custa 49 € sem IVA, pagamento único por versão do Odoo. Se trabalha em 17, 18 ou 19, reveja a ficha da sua versão antes de comprar.
A configuração inicial descrita no README é curta:
- Instale o módulo a partir de Apps.
- Execute o assistente de configuração.
- Entre em
Accounting > UAE E-Invoicing > Configuration > UAE E-Invoicing Settings.
- Introduza o TIN da empresa e escolha a fase.
- Mantenha o modo sandbox ativo para testar o fluxo com o simulador.
- Ative a faturação eletrónica nos diários que quiser.
O detalhe de cada campo e dos estados está na configuração do conector.
Como decidir conforme o seu caso
| Se isto se aplica a si | O que diz a documentação |
|---|---|
| Quer ver o fluxo no Odoo sem enviar nada | O sandbox vem ativo e simula fornecedor, estados e referências dentro do Odoo |
O seu fornecedor aceita POST para /invoices com bearer token, ou AS4 básico | O envio real pode apontar para o endpoint dele, mas o XML mantém as falhas que a ficha enumera |
| Precisa de um XML que passe as regras do PINT AE 1.0.4 | Não foi validado contra elas e falha várias |
| Emite notas de crédito ou faturas em moeda estrangeira | As notas de crédito saem como faturas e faltam os montantes em AED |
| Precisa de receber faturas de fornecedores | Não as recebe |
| O seu fornecedor só oferece a sua própria API | Não há integração com nenhum fornecedor acreditado concreto |
Se prefere perceber primeiro que menus acrescenta e por onde passa cada fatura, leia como funciona o conector por dentro.
Como a FlexigoTech o ajuda
A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se o seu fornecedor acreditado não aceita o contrato genérico do módulo, ou precisa de algo que a documentação deixa de fora, podemos estudar consigo um desenvolvimento à medida. Tem os detalhes do módulo na sua página em flexigotech.com e na ficha da Odoo Apps.
Continue a ler
Verificado no código do módulo (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): README.rst
- Código do módulo: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): static/description/index.html
- apps.odoo.com/apps/modules/20.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/17.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/18.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/19.0/flexigo_uae_fta_e_invoicing_connector
- flexigotech.com/en/services.html