Saltar para o conteúdo principal
B2Brouter

B2Brouter API a partir do Odoo: ambientes, chaves, versão e webhooks

A API da B2Brouter trabalha com uma chave por ambiente e com uma versão datada em cada chamada. Se fatura com o Odoo, o conector da B2Brouter já traz isto resolvido: escolhe o ambiente, cola a chave e o Odoo envia as faturas e recebe os avisos. Aqui fica o que a API pede e onde o vê dentro do Odoo.

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 a API da B2Brouter pede

Para usar a API da B2Brouter precisa de uma conta B2Brouter e da respetiva chave API. A chave copia-se do separador Developers do mesmo ambiente B2Brouter em que vai trabalhar. Uma chave de testes não serve em produção, e o inverso também não.

Cada chamada leva também a versão da API. O conector fixa-a em todos os pedidos: «X-B2B-API-Version: 2026-06-26». Se alterar esse valor no Odoo, tem de ser uma data no formato AAAA-MM-DD. Com outro formato, o Odoo não o guarda.

Os três ambientes e os seus endereços

A B2Brouter tem três ambientes. Produção e sandbox usam o mesmo endereço, https://api.b2brouter.net. O que decide onde chega a chamada é o prefixo da chave. O staging tem um endereço próprio, https://api-staging.b2brouter.net.

O conector verifica o prefixo quando guarda a chave e outra vez antes de cada pedido:

  • Em produção aceita chaves que começam por prod_ e as antigas sem prefixo.
  • Em sandbox só aceita chaves que começam por test_.
  • Em staging aceita stag_ e test_.

A razão é simples. Uma chave de produção colada em sandbox enviaria faturas reais sem que ninguém desse por isso. O conector trava isso antes.

Em sandbox os envios são simulados, os pagamentos estão desativados e as pré-visualizações em PDF levam a marca «test invoice». É o sítio para testar a configuração sem enviar nada a sério.

Como o Odoo se liga à API

O conector traz um assistente em B2Brouter › Ligar ao B2Brouter. Os passos são Boas-vindas, Ambiente, Obtenha a sua chave API, Ligar e Concluído.

  1. Instale o conector no Odoo 17, 18, 19 ou 20 e ative a subscrição FlexigoTech Cloud. O conector precisa dela para funcionar.
  2. Escolha o ambiente: produção, sandbox ou staging.
  3. Copie a chave API do separador Developers desse mesmo ambiente e cole-a.
  4. Como administrador, dê o seu consentimento. A FlexigoTech Cloud guarda a chave cifrada e só a recebe depois desse consentimento.
  5. Teste a ligação. Se faltar a chave, o Odoo avisa antes de chamar a B2Brouter.
Ligação do B2Brouter no Odoo através do FlexigoTech Cloud
A ligação através do FlexigoTech Cloud: ambiente, conta, consentimento e a chave guardada na nuvem (dados de demonstração).

Webhooks assinados e tarefas agendadas

A B2Brouter avisa das alterações com webhooks. O conector recebe-os num endereço próprio de cada registo, com um token que não se consegue adivinhar. Verifica também a assinatura HMAC-SHA256 de cada aviso com o segredo desse registo. O que chega aparece em B2Brouter › Documentos › Eventos de webhook.

Os webhooks não substituem as verificações periódicas. O conector executa estas tarefas:

  • Enviar a fila de documentos, a cada 5 minutos.
  • Processar os eventos de webhook, a cada 5 minutos.
  • Consultar o estado das faturas, a cada 15 minutos.
  • Atualizar as listas de códigos, todas as semanas.

As listas de códigos vêm da própria API: esquemas, tipos de documento, países, moedas, estados de fatura, idiomas e tipos de transporte.

Quando algo falha: o ID do pedido

Cada resposta da B2Brouter traz um identificador de pedido. O conector guarda o último no campo Último ID de pedido da ligação. Se abrir um pedido de suporte na B2Brouter, indique esse valor. Assim encontram a sua chamada sem ter de reproduzir o erro.

Assistente de ligação do B2Brouter no Odoo
O assistente de ligação no fim: a conta associada ao seu NIF, a utilização do plano e os passos seguintes (dados de demonstração).

O que precisa e o que não está incluído

Precisa da sua própria conta B2Brouter e da respetiva chave API. As tarifas da B2Brouter não estão incluídas. O conector está no Odoo Apps para Odoo 17, 18, 19 e 20 e funciona com a subscrição FlexigoTech Cloud. Os detalhes da integração estão na página do conector.

Posso testar a API da B2Brouter sem enviar faturas reais?

Sim. Escolha o ambiente sandbox e use uma chave que comece por test_. Os envios são simulados e os PDF levam a marca de fatura de teste.

Onde está a especificação da API?

O conector trabalha com a versão 2026-06-26. A especificação OpenAPI está publicada em app.b2brouter.net.

O Odoo guarda a minha chave da B2Brouter?

Quem a guarda é a FlexigoTech Cloud, cifrada, e só depois de um administrador dar o seu consentimento nessa ligação.

Tenho de programar alguma coisa para usar a API?

Não. O conector faz as chamadas, com assinatura e versão incluídas. Só escolhe o ambiente e cola a chave.

Continue a ler

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): static/description/index.html
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): README.md
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
  • Código do módulo: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml