O que o Billbee pede
Segundo o seu centro de ajuda, em alemão, a API do Billbee precisa da chave de API da aplicação e, além disso, do seu nome de utilizador do Billbee e de uma palavra-passe da API especial que o identifica como comerciante. Essa palavra-passe tem de ter pelo menos 12 caracteres e não pode conter dois pontos. O Billbee acrescenta que o acesso à API não tem restrições de acesso.
Desde 1 de novembro de 2025, segundo a sua página sobre o preço da API, as primeiras 100.000 chamadas por mês continuam gratuitas para cada ligação ou ferramenta. Cada ferramenta tem exatamente uma chave de API, e a fatura vai sempre para o titular da ligação.
A chave é da FlexigoTech e as suas credenciais vão para a FlexigoTech Cloud
Como o Billbee emite uma chave por ferramenta, a chave do conector é da FlexigoTech. Cada chamada do seu Odoo ao Billbee passa pela FlexigoTech Cloud, nos nossos servidores na Alemanha, que acrescenta o seu nome de utilizador e a sua palavra-passe da API, guardados cifrados, juntamente com essa chave. Uma chamada só sai se houver um período de teste ou uma subscrição da FlexigoTech Cloud ativos.
O campo Palavra-passe API é só de escrita e não fica guardado no Odoo. Quando o guarda na conta em Billbee › Configuração › Contas, o seu nome de utilizador, que fica no registo, e a palavra-passe seguem juntos para a FlexigoTech Cloud. Antes disso, marca que aceita que a FlexigoTech Cloud guarde as suas credenciais do Billbee e que as chamadas passem por ela. A ajuda do campo lembra que é a palavra-passe da API, separada da de acesso, com pelo menos 12 caracteres e sem dois pontos.

Billbee › Configuração › Contas: a conta ligada, com as credenciais guardadas na FlexigoTech Cloud e a data do último teste.Testar a ligação
Testar Ligação lê uma página com uma única encomenda do Billbee. Se o Billbee responder, a conta passa a Ligado, guarda a data do teste e o registo recarrega-se sozinho. Se responder 401 ou 403, a conta passa a Erro de autenticação e pede-lhe que verifique o nome de utilizador e a palavra-passe da API.
Só um administrador do Odoo pode chamar o Billbee com essas credenciais. As tarefas agendadas, o aviso de encomendas e o envio que sai ao validar uma entrega chamam como sistema. Se arquivar a conta, o Odoo deixa de chamar o Billbee com ela: é o interruptor que para tudo.
A quota de chamadas: pedir só o que mudou
Para gastar poucas chamadas, cada passagem de encomendas pede só as encomendas que mudaram desde a anterior, e a tarefa de stock envia só os produtos cujo número mudou, até 100 por chamada. O conector não conta as chamadas: a chamada de consumo do Billbee está no seu código, mas nenhum ecrã nem nenhuma tarefa a usa. As chamadas ficam mesmo assim escritas em Billbee › Registo de Sincronização, com o método, o caminho, o código de resposta e os milissegundos.
Quando algo falha
Se o Billbee responder 429, demasiadas chamadas, o Odoo tenta de novo até 5 vezes, esperando o que o Billbee pedir ou um tempo que duplica em cada tentativa, no máximo 300 segundos de cada vez. Um erro 5xx do Billbee é repetido até 3 vezes. Uma pausa da FlexigoTech Cloud não é repetida.
O Odoo não segue redirecionamentos: se o Billbee respondesse com um, a chamada é recusada com um erro, para que as credenciais não vão parar a outro sítio.
Cada erro no registo cria uma atividade para o responsável da conta (se não houver, para quem estava a trabalhar). A limpeza diária apaga as linhas do registo com mais de 90 dias.

O aviso de encomendas
Com Registar Webhook no Billbee (melhor esforço), na conta, o Odoo regista no Billbee o aviso de novas encomendas. Antes de o aceitar, o Billbee verifica o endereço, e o Odoo só responde com o mesmo texto se o endereço levar o segredo da conta. A partir daí, cada aviso faz o Odoo ler essa encomenda ou, se não a encontrar, lançar logo a passagem de encomendas. Mesmo que o aviso não esteja registado, as encomendas chegam com a tarefa a cada 15 minutos.
O que cada passagem faz com as encomendas está em encomendas do Billbee no Odoo, e o vocabulário do Billbee em o que é o Billbee.
Testámos com uma conta Billbee
A 17-11-2026, com uma conta de teste de comerciante do Billbee e o serviço de teste da FlexigoTech Cloud, testámos de ponta a ponta a ligação, o stock, as encomendas e o envio no Odoo 20, sem erros. A 18-11-2026, com a versão 1.2.11 no Odoo 17, 18, 19 e 20, registámos o aviso de encomendas, e o Billbee verificou primeiro o endereço. No Odoo 17, 18 e 20, uma encomenda criada depois no Billbee entrou no Odoo.
Perguntas sobre a API do Billbee e o Odoo
Preciso de uma chave de API do Billbee própria?
Não. A chave é da integração, e é da FlexigoTech. Introduz o seu nome de utilizador do Billbee e uma palavra-passe da API, que cria no Billbee à parte da palavra-passe de acesso.
Onde fica guardada a minha palavra-passe da API?
Na FlexigoTech Cloud, cifrada. No seu Odoo o campo é só de escrita: pode alterá-la, mas não lê-la.
Quanto custa?
O módulo custa 9 € por versão do Odoo na Odoo Apps. Funciona com a FlexigoTech Cloud, a partir de 49 €/mês: plano Conector Standard a 49 €/mês ou 490 €/ano, ou Pro a 98 €/mês ou 980 €/ano, sem IVA. O período de teste é de 14 dias, grátis e sem cartão. Inclui 2 meses de suporte para o pôr a funcionar e, enquanto mantiver a subscrição, as atualizações e o suporte, segundo as condições de venda 2.2. Está tudo na página do conector Billbee.
Em que versões do Odoo funciona?
No Odoo 17, 18, 19 e 20, no Odoo.sh ou no seu próprio servidor. Não funciona no Odoo Online. A sua conta Billbee, com o nome de utilizador e uma palavra-passe de API, e o respetivo plano são à parte.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:342
- hilfe.billbee.io/article/1505-nutzung-der-billbee-api
- hilfe.billbee.io/article/1506-preisgestaltung-der-billbee-api
- Teste real da FlexigoTech com uma conta de teste Billbee (17 e 18-11-2026)
- flexigotech.com/pt/conector-billbee-odoo.html
- www.billbee.io/
- www.billbee.io/en
