Saltar para o conteúdo principal
B2Brouter

B2Brouter Peppol a partir do Odoo: dados do cliente, diretório e envio

Para usar o B2Brouter Peppol a partir do Odoo, o conector da FlexigoTech pede a cada cliente um esquema EAS e um ponto de acesso Peppol, ou pelo menos um NIF. Com o botão Verificar acessibilidade (Peppol) na ficha do contacto, procuras o cliente no diretório Peppol e o conector diz-te se o encontrou. Sem ponto de acesso nem NIF, a fatura não sai e o conector explica porquê. As faturas de fornecedor chegam como rascunhos.

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

O essencial

Módulo
B2Brouter
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0
Leitura
4 min

O que o Peppol precisa de cada cliente no conector B2Brouter

O conector acrescenta dois campos ao contacto: Esquema Peppol (EAS) e Ponto de acesso Peppol (B2Brouter). O primeiro guarda o esquema EAS e o segundo guarda o valor do identificador. A rota Peppol trata-os como um par: esquema mais valor.

A ajuda do campo do esquema pede o código do esquema EAS com zeros à esquerda, por exemplo 0208. Avisa também que o esquema é validado contra os esquemas em cache no momento do envio.

  1. Abre a ficha de contacto do cliente.
  1. Confirma que tem país e NIF.
  1. Se o cliente te deu o respetivo identificador Peppol, introduz o código do esquema em Esquema Peppol (EAS).
  1. Introduz o valor do identificador em Ponto de acesso Peppol (B2Brouter).
  1. Guarda o contacto.

Verificar se o cliente está no diretório Peppol

Na ficha de contacto, os utilizadores do B2Brouter veem o botão Verificar acessibilidade (Peppol). Ao clicar nele, o conector procura o destinatário no diretório Peppol. Estas são as mensagens que te pode dar:

  • Destinatário encontrado no diretório Peppol.
  • Não encontrado no diretório Peppol (nem no Annuaire francês).
  • Defina primeiro o país e o NIF (ou o ponto de acesso Peppol). Aparece quando o contacto não tem país ou não tem NIF. Preenche-o e volta a clicar no botão.
  • `O identificador … não é válido para o esquema … no país

….` Onde estão as reticências, o módulo coloca o identificador, o esquema e o país. Revê esses dados no contacto.

  • `O Ponto de Acesso Peppol do destinatário publica dados incompletos (…).

Contacte o destinatário.` Os parênteses contêm um código, e a própria mensagem pede-te que contactes o destinatário.

Quando a verificação termina, o conector escreve o resultado em Acessível via Peppol?, com a data e o erro, se o houver. Quando há mensagem, deixa também uma nota no histórico do contacto. Esse estado pode ser Desconhecido, A verificar…, Acessível, Não acessível, Identificador inválido ou um estado de erro. O conector inclui ainda a ação agendada B2Brouter: continuar consultas ao diretório, que corre a cada 5 minutos e está ativa desde a instalação.

Enviar a fatura pela rota Peppol do B2Brouter

Quando uma fatura segue pela rota Peppol, o conector precisa do ponto de acesso Peppol do cliente (esquema e valor) ou do respetivo NIF. Se não tiver nenhum dos dois, a fatura não sai e o envio fica bloqueado com este motivo: A rota Peppol precisa de um ponto de acesso Peppol (esquema + valor) ou do NIF do cliente. No momento do envio, o esquema EAS do contacto é também validado contra os esquemas em cache.

  1. Antes de enviar, abre o cliente e confirma que tem esquema e ponto de acesso Peppol, ou um NIF.
  1. Se queres saber de antemão se o cliente está no diretório Peppol, clica em Verificar acessibilidade (Peppol) na ficha de contacto.
  1. Envia a fatura pela rota Peppol.
  1. Se aparecer o motivo de bloqueio, completa a ficha de contacto e volta a enviar.
Lista de faturas de cliente com a respetiva fase B2Brouter no Odoo 20
Faturas de cliente com a respetiva fase B2Brouter, com dados de demonstração.

Receber faturas de fornecedor do B2Brouter

As faturas que recebes através do B2Brouter entram no Odoo como faturas de fornecedor em rascunho, e alguém as aprova no Odoo. O conector inclui a ação agendada B2Brouter: consultar pendentes de criação de faturas recebidas, que corre a cada 15 minutos e está ativa desde a instalação.

Para os webhooks, o conector tem o menu B2Brouter › Documentos › Eventos de webhook e a ação agendada B2Brouter: processar eventos de webhook, a cada 5 minutos. A chave e os webhooks tratamo-los em API do B2Brouter a partir do Odoo: ambientes, chaves, versão e webhooks.

  1. Abre a fatura de fornecedor em rascunho que chegou através do B2Brouter.
  1. Revê-a.
  1. Aprova-a no Odoo quando estiver correta.
Fatura de fornecedor em rascunho recebida através do B2Brouter, com as suas linhas, no Odoo 20
Uma fatura de fornecedor recebida através do B2Brouter, em rascunho e com as suas linhas, com dados de demonstração.

Perguntas sobre o B2Brouter e o Peppol no Odoo

O que introduzo no esquema EAS?

O código do esquema com zeros à esquerda, como 0208, segundo a ajuda do campo Esquema Peppol (EAS). É validado no momento do envio contra os esquemas em cache.

Posso enviar por Peppol só com o NIF do cliente?

O motivo de bloqueio pede um ponto de acesso Peppol (esquema e valor) ou o NIF do cliente. Com o NIF, a rota Peppol não fica bloqueada por esse motivo.

O que faço se o destinatário publica dados incompletos?

O que diz a mensagem: contacta o destinatário. Os parênteses contêm o código que o módulo lá coloca.

Precisa da subscrição FlexigoTech Cloud?

Sim. O conector precisa da subscrição FlexigoTech Cloud (plano Conector), e o envio e a receção de e-faturas com o B2Brouter funcionam sobre o FlexigoTech Cloud. Vê o Conector B2Brouter Odoo no Odoo Apps e compra-o na página do conector em flexigotech.com.

Continue a ler

B2Brouter API a partir do Odoo: ambientes, chaves, versão e webhooksO que a API da B2Brouter pede para ligar o Odoo: ambiente, prefixo da chave, versão fixa, webhooks assinados e tarefas. E o que o conector já resolve.
Verificado no código do conector (versão 20.0)

Fontes

  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): models/res_partner.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): views/res_partner_views.xml
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): models/account_move.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml