Saltar para o conteúdo principal
Singapore InvoiceNow

Singapore InvoiceNow sem Odoo: checklist para passar a faturação Peppol para o Odoo

Se já fatura pelo Singapore InvoiceNow e ainda não usa Odoo, o passo útil é reunir num só sítio a fatura, o seu envio por Peppol, a receção das faturas de fornecedores e o acompanhamento de cada estado. Com o Odoo e o conector Singapore InvoiceNow, tudo isso fica dentro do ERP: o módulo gera o XML UBL 2.1 e acrescenta um botão na fatura para a enviar. Esta checklist organiza o que rever antes da implementação, ao ligar e durante a primeira semana.

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 conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

O que anotar sobre a forma como faz hoje

Antes de falar de Odoo, faça um inventário do seu processo atual. Não precisa de ser bonito: basta saber quem faz cada tarefa, com que ferramenta e onde fica o registo. As caixas seguem o que o módulo cobre, para depois poder comparar uma a uma.

  • Anote onde gera hoje cada documento que envia pelo InvoiceNow e se é uma fatura ou uma nota de crédito.
  • Reúna o Peppol ID de cada empresa que fatura. O módulo valida o formato 0192:SGUEN[NNNN], por isso convém tê-los escritos exatamente assim.
  • Se trabalha com várias empresas, anote qual usa o seu próprio Peppol ID: o módulo admite configurações multiempresa com um Peppol ID por empresa.
  • Separe os seus casos de GST: cenários com e sem registo de GST, fornecimentos à taxa zero, faturas isentas e faturas de customer accounting.
  • Anote como recebe hoje as faturas de fornecedores e como evita registar duas vezes a mesma.
  • Identifique o seu fornecedor de Access Point. O módulo admite a CrimsonLogic e uma opção Generic/Custom.
  • Anote como sabe hoje que um Peppol ID vai expirar ou foi revogado.
How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

O que o Odoo reúne com o Singapore InvoiceNow

Com o módulo instalado, estas tarefas passam a fazer-se a partir do Odoo. Segundo o README, é isto que faz:

  • Regista automaticamente a empresa como participante Peppol.
  • Gera documentos XML UBL 2.1 em conformidade com o InvoiceNow, com suporte para o PINT-SG 1.4.0 e para o 1.3.0 legado.
  • Verifica os campos obrigatórios: identificadores fiscais do comprador e do vendedor, data da fatura e linhas.
  • Aplica as regras do GST de Singapura e limpa o texto escrito pelo utilizador para evitar injeção no XML.
  • Acrescenta o botão Send via InvoiceNow ao formulário da fatura e preenche automaticamente os campos Peppol a partir das fichas de contacto.
  • Envia faturas e notas de crédito pela rede Peppol e recebe as que chegam consultando o Access Point (polling) ou por webhooks.
  • Elimina duplicados das faturas recebidas pelo identificador único da mensagem e guarda um registo de tudo o que foi enviado e recebido.
  • Acompanha cada documento por estados: Draft, Queued, Sent, Delivered, Failed, Rejected e Quarantine.
Lista de perfis PINT-SG com PINT-SG 1.4.0 e PINT-SG 1.3.0 Legacy, depois a lista vazia de Access Points e a lista vazia de Inbound Errors
Percurso pela app InvoiceNow SG: os perfis PINT-SG 1.4.0 e 1.3.0 Legacy e as listas de Access Points e Inbound Errors, ainda sem registos.

O README descreve ainda seis padrões de recuperação de erros, com tarefas agendadas para novas tentativas, reconciliação e monitorização, e mensagens de erro pensadas para o utilizador:

  • Falhas temporárias do Access Point: nova tentativa com espera exponencial (30s → 2min → 10min).
  • Rejeições permanentes: revisão e correção manual.
  • Envio correto mas falha no Odoo: tarefa agendada de reconciliação.
  • Falhas ao processar documentos recebidos: mapeamento parcial e quarentena.
  • Expiração de credenciais: aviso a todo o sistema e rotação automática de credenciais.
  • Documentos recebidos duplicados: deduplicação automática.
Lista Inbound Errors do InvoiceNow SG com as colunas Move, Field Name, Raw Value e Reason, sem registos
A lista de Inbound Errors do módulo, ainda sem nenhum registo.

Checklist ao implementar o Odoo e ligar

O módulo está publicado na Odoo Apps para Odoo 17, 18, 19 e 20, a 9 € sem IVA, pagamento único por versão do Odoo. A ligação passa pela FlexigoTech Cloud com o plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma (Pro: 98 €/mês ou 980 €/ano, até 10).

  • Escolha a versão do Odoo da sua implementação entre 17, 18, 19 e 20.
  • Registe cada empresa com o seu Peppol ID e confirme que passa a validação de formato.
  • Complete os dados Peppol nas fichas dos seus contactos: o módulo preenche automaticamente os campos Peppol a partir delas.
  • Tenha à mão os dados do seu fornecedor de Access Point (CrimsonLogic ou Generic/Custom).
  • Decida se vai receber as faturas por polling ou por webhooks.
  • Veja que perfil PINT-SG precisa: o módulo valida contra o 1.4.0 e mantém suporte para o 1.3.0.

Checklist de dados e segurança

  • Credenciais: o módulo guarda-as cifradas em ir.config_parameter do Odoo.
  • Ligação: o módulo exige TLS 1.2+ com validação do certificado TLS.
  • Multiempresa: cada empresa fica isolada com controlos de acesso por registo.
  • Dados pessoais: o README agrupa sob o PDPA (Personal Data Protection Act) a minimização de dados (só transmite os campos exigidos) e a exportação DSAR com acesso limitado ao contacto.
Diálogo PDPA Data Export com os campos Partner, Date From e Date To vazios e os botões Generate Export e Close
O assistente PDPA Data Export, com todos os campos ainda por preencher.

Checklist da primeira semana

  • Envie uma fatura real com Send via InvoiceNow e veja em que estado fica.
  • Procure documentos em Failed ou Rejected. As rejeições permanentes pedem revisão e correção manual.
  • Verifique se há documentos em Quarantine.
  • Abra a lista de Inbound Errors e veja se tem registos.
  • Confirme que recebe os avisos de expiração e revogação do Peppol ID.
  • Reveja o registo de transações do que foi enviado e recebido.

Se algo não bater certo, os textos literais de cada aviso estão em as mensagens de erro do Singapore InvoiceNow, e as definições de arranque em a configuração inicial do módulo.

O que acontece com a ligação e a subscrição

A FlexigoTech Cloud guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar; se a plataforma mudar a sua API, o módulo e o serviço são adaptados. Sem subscrição, ou com o serviço suspenso, para o que a subscrição fornece, e os dados ficam no seu Odoo.

Com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá.

Como a FlexigoTech ajuda

Se ainda não tem Odoo, a ordem lógica é primeiro a implementação e depois o conector. A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida, por isso podemos montar o seu Odoo com a faturação e deixar o Singapore InvoiceNow ligado ao seu Access Point. Tem os detalhes na página do módulo e na sua ficha da Odoo Apps.

Continue a ler

Como funciona o Singapore InvoiceNow no Odoo: menus, ações agendadas e modelosMenus, ações agendadas e modelos que o Singapore InvoiceNow acrescenta ao Odoo 17, 18, 19 e 20, comparados em tabelas para saber o que corre e onde ver.Erros e avisos do Singapore InvoiceNow no Odoo: quando surgem e o que fazerAs mensagens de erro do Singapore InvoiceNow no Odoo com o texto literal: quando surgem, o que significam e o que fazer com perfis, Access Point e chaves.Configuração do Singapore InvoiceNow no Odoo: definições, campos e estadosComo pôr a funcionar o Singapore InvoiceNow no Odoo: Access Points, credencial, capacidades B2B e IRAS, estados de cada registo e o que rever na primeira semana.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes