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.
- Instale o conector no Odoo 17, 18, 19 ou 20 e ative a subscrição FlexigoTech Cloud. O conector precisa dela para funcionar.
- Escolha o ambiente: produção, sandbox ou staging.
- Copie a chave API do separador Developers desse mesmo ambiente e cole-a.
- Como administrador, dê o seu consentimento. A FlexigoTech Cloud guarda a chave cifrada e só a recebe depois desse consentimento.
- Teste a ligação. Se faltar a chave, o Odoo avisa antes de chamar a B2Brouter.

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.

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
