O caso: uma encomenda, duas entregas
Uma encomenda Billbee entra no Odoo com dois produtos, e só um está em armazém. Valida a entrega com o que há e deixa o resto numa entrega pendente, que sai quando chegar a mercadoria. A ordem de venda fica com duas entregas de saída, cada uma com a sua transportadora e o seu número de rastreamento.
Na sua ajuda, em alemão, o Billbee explica que, se não enviar a partir do Billbee mas, por exemplo, através de um operador logístico, este pode enviar-lhe os dados do envio pela API. Com o conector, esse papel é do Odoo.
A primeira entrega
Ao validá-la, o Odoo cria o seu envio Billbee com a transportadora e o número de rastreamento da entrega. Com número de rastreamento, o envio fica Envio Pendente e, com Enviar automaticamente o rastreio para o Billbee, ligado por omissão, segue para o Billbee nesse momento. Não importa quem valida a entrega: o envio sai mesmo que essa pessoa não tenha permissões do Billbee no Odoo.
O Billbee recebe o número de rastreamento e, no comentário, o nome da transportadora do Odoo. A transportadora do Billbee só vai se o nome da do Odoo contiver uma que o Billbee conhece, como DHL, DPD, GLS, UPS, Hermes, Deutsche Post ou FedEx. A transportadora e o número de rastreamento são campos da entrega que vêm do módulo de transportadoras do Odoo, do qual o conector depende desde a versão 1.2.11.
A ordem de venda ainda tem a segunda entrega aberta. O Billbee já tem o primeiro envio com o seu rastreamento, mas o estado da encomenda no Billbee não muda.

Billbee › Envios: o envio de uma entrega, com a sua encomenda, a sua transferência, a transportadora, o número de rastreamento e o seu estado.A segunda entrega fecha a encomenda
Quando chega a mercadoria e valida a segunda entrega, o Odoo envia o seu envio com o seu próprio número de rastreamento. Já não fica nenhuma entrega aberta, por isso o Odoo passa a encomenda a enviada no Billbee (o seu estado 4), se lá continuava por enviar.
Se o Billbee recusar essa mudança de estado, o Odoo regista-a no registo e não repete o envio, porque o Billbee ficaria com ele duas vezes. Uma entrega cujo envio já foi enviado também não volta a ser enviada.

Billbee › Envios: um envio por entrega, com a sua encomenda, a sua transferência e o seu estado.Se o Billbee não responder
Uma falha ao enviar o envio nunca impede validar a entrega. Se o Billbee o recusar, o envio fica com erro e a falha vai para o registo. Se o Billbee não responder a tempo, fica em Envio Pendente. Nos dois casos, um administrador pode voltar a enviá-lo com Enviar para o Billbee, no próprio envio. Esse botão aparece em todos os envios que ainda não foram enviados.
A etiqueta, pedida a partir do Odoo
Se é o Billbee que faz a etiqueta, pede-a a partir da entrega, no menu Ação, com Pedir Etiqueta de Envio Billbee e o fornecedor e o produto de envio do Billbee. O botão Pedir Etiqueta do assistente é só para administradores e só serve para entregas de encomendas que já estão no Billbee.
Com a etiqueta feita, o Odoo guarda no envio o número de rastreamento que o Billbee devolve, já como enviado. O Odoo não traz o PDF da etiqueta. Como no caso acima, a encomenda passa a enviada no Billbee só se for a última entrega aberta.
Se a sua conta Billbee ainda não tiver nenhum fornecedor de envio, o assistente diz isso mesmo: o Billbee não criou a etiqueta, é preciso adicionar um no Billbee e nada é marcado como enviado.
O aviso ao comprador
Com Notificar automaticamente o comprador no envio, desligado por omissão, o Odoo pede ao Billbee que mande o seu aviso ao comprador depois de enviar cada envio. Pedir a etiqueta a partir do Odoo não aciona esse aviso.
Como a encomenda chega ao Odoo está em as encomendas Billbee no Odoo.
Testámos com uma conta Billbee
A 17-11-2026, com uma conta de teste de comerciante do Billbee e o Odoo 20, validámos uma entrega com o seu número de rastreamento e a encomenda ficou no Billbee no estado 4, com o seu envio. A 18-11-2026 repetimos esse teste com a versão 1.2.11 no Odoo 17, 18, 19 e 20, com o mesmo resultado.
Perguntas sobre os envios Billbee a partir do Odoo
O Billbee marca a encomenda como enviada logo com a primeira entrega?
Não. O Odoo muda o estado quando a ordem de venda já não tem nenhuma entrega de saída aberta. Até lá, o Billbee recebe o envio de cada entrega com o seu rastreamento.
E se a minha transportadora não for uma das que o Billbee conhece?
O envio segue na mesma, com o número de rastreamento e o nome da transportadora no comentário, mas sem a transportadora do Billbee.
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_shipment.py:139
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_shipment.py:157
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/stock_picking.py:89
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_shipment.py:220
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_shipment.py:101
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): views/billbee_shipment_views.xml:27
- 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_shipment.py:194
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): wizard/billbee_shipping_label_wizard.py:119
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): wizard/billbee_shipping_label_wizard.py:61
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): wizard/billbee_shipping_label_wizard.py:134
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): __manifest__.py:47
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:99
- hilfe.billbee.io/article/1487-best-practice-sendungsnummern-per-api-an-billbee-ubermitteln
- www.billbee.io/
- www.billbee.io/en
- Teste real da FlexigoTech com uma conta de teste Billbee (17 e 18-11-2026)
- flexigotech.com/pt/conector-billbee-odoo.html
