Saltar para o conteúdo principal
Billbee

A API do Billbee a partir do Odoo: a chave, a sua palavra-passe da API, a quota e os erros

Para falar com a API do Billbee são precisas três coisas: a chave da integração, o seu nome de utilizador do Billbee e uma palavra-passe da API. Com o conector do Odoo, a FlexigoTech fornece a chave, e o seu nome de utilizador e a sua palavra-passe seguem uma única vez, cifrados, para a FlexigoTech Cloud.

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

O essencial

Módulo
Billbee
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 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.

A conta Billbee no Odoo
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 Odoo ligado à FlexigoTech Cloud
A secção FlexigoTech Cloud das definições do Odoo: a base de dados ligada e o conector Billbee em período de teste.

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

Encomendas Billbee no Odoo: do Billbee a Vendas, com cliente, linhas por SKU e IVA certoComo o conector traz as encomendas Billbee para Vendas no Odoo: a cada 15 minutos, com cliente e entrega, linhas por SKU, IVA incluído e automação.O stock do Odoo no Billbee: o número que chega, com que frequência e o que acontece quando não coincidemQue stock o conector do Odoo envia para o Billbee, porque desconta as encomendas Billbee ainda não confirmadas e o que faz a comparação de seis em seis horas.Billbee e os envios a partir do Odoo: uma encomenda que sai em duas entregas e o que o Billbee vê em cada umaO que o Odoo envia ao Billbee ao validar cada entrega de uma encomenda: o número de rastreamento, a transportadora, o estado enviado só no fim e a etiqueta.O que é o Billbee e o que é no Odoo cada uma das suas palavrasO que é o Billbee, quem o usa e o que querem dizer as suas palavras (estado, reclamação, Freier Provider, palavra-passe da API) ao ligá-lo ao Odoo.
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