A cada 15 minutos, só o que mudou
A tarefa de encomendas corre a cada 15 minutos e pede ao Billbee só as encomendas que mudaram desde a última passagem, com uma hora de sobreposição. Nunca pede o histórico inteiro. Cada passagem lê no máximo 20 páginas de 50 encomendas, ou 60 segundos de trabalho, e se sobrar alguma coisa a tarefa corre de novo logo a seguir em vez de esperar mais 15 minutos.
Uma encomenda nova que falha não trava as outras. Vai para o registo como erro e o marcador da conta não passa à frente dela, por isso a passagem seguinte volta a pedi-la.
Se quiser que as encomendas novas não esperem pela tarefa, registe o aviso com Registar Webhook no Billbee (melhor esforço), na conta. Com o aviso registado, cada encomenda nova no Billbee 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.

Billbee › Painel: encomendas de hoje e pendentes, erros de envio de stock, envios e devoluções pendentes e atividade recente.O cliente e o endereço de entrega
O Odoo procura o cliente pelo e-mail do endereço de faturação, na empresa da conta ou entre os contactos sem empresa. Se não encontrar nenhum, cria um no idioma da encomenda Billbee. Se o endereço de entrega for diferente (compara rua, código postal e localidade), entra como endereço de entrega sob o cliente.
As encomendas para uma Packstation da DHL trazem a palavra Packstation e o seu número na rua, e o Postnummer na segunda linha da morada. O Odoo reconhece isto e preenche Packstation DHL, Número da Packstation e Postnummer da Packstation no contacto. Esta parte segue a convenção da DHL e não fez parte dos nossos testes com uma conta Billbee.
As linhas, ligadas por SKU
A ordem de venda fica com o número da encomenda Billbee como referência do cliente e, como data, o dia em que a encomenda foi criada no Billbee. O registo da encomenda Billbee no Odoo guarda também a referência do marketplace.
Cada linha liga-se a um produto por SKU. O Odoo vê primeiro a ligação que já guardou; se não houver, procura um produto com essa referência interna na empresa da conta e guarda a ligação. Uma linha cujo SKU não está no Odoo não se perde: entra com o produto genérico Importação Billbee (SKU não correspondido).
Se a mesma encomenda chegar outra vez, o Odoo atualiza o seu estado Billbee. Não cria outra ordem de venda nem linhas novas.

Billbee › Produtos: cada produto com o seu SKU do Billbee e o seu estado.O preço, com IVA incluído
O Billbee envia o valor de cada linha com IVA incluído. Se o imposto do Odoo não estiver definido como incluído no preço, o conector tira o IVA ao preço unitário para que o Odoo não o cobre duas vezes. Com o imposto incluído, o preço entra tal como vem.
O imposto da linha é o imposto de venda da empresa com a mesma percentagem. Se não houver, a linha fica sem imposto.
Um exemplo: uma linha Billbee de 2 unidades por 59,80 €, com IVA de 19% incluído. Com o imposto do Odoo não incluído, o preço unitário passa a 25,13 € (29,90 / 1,19) e, com os 19% que o Odoo acrescenta, a linha volta a cerca de 59,80 €, no máximo um cêntimo de diferença por arredondamento. Se o IVA não fosse retirado, ficaria em 59,80 + 11,36 = 71,16 €.
O que decide: a automação
Na conta, em Billbee › Configuração › Contas, há três passos: Confirmar encomenda de venda automaticamente, Criar fatura automaticamente e Validar entrega automaticamente. Correm por essa ordem, a fatura e a entrega só com a ordem de venda confirmada, e os três vêm desligados.
Com Faturar só quando o Billbee confirmar o pagamento, ativo por omissão, a fatura é criada quando a encomenda Billbee está paga, enviada, fechada, embalada ou em preparação. Enquanto ainda estiver encomendada, confirmada ou tiver um lembrete de pagamento, a fatura espera. Quando a encomenda chega outra vez com o pagamento já marcado no Billbee, a automação corre de novo e fatura-a, mas nunca confirma a ordem de venda uma segunda vez.
A automação só confirma encomendas criadas no Billbee desde a data em Automatizar pedidos criados desde, o dia em que a conta foi configurada. As mais antigas entram como orçamentos. Se a automação de uma encomenda nova falhar, a encomenda também fica como orçamento e o erro vai para o registo.
As unidades das encomendas ainda por confirmar saem do stock enviado ao Billbee: veja o stock do Odoo no Billbee. O que acontece quando valida a entrega está em os envios do Billbee a partir do Odoo.
Testámos com uma conta Billbee
A 17-11-2026, com uma conta de teste de comerciante do Billbee e o Odoo 20, o produto foi ligado por SKU e as encomendas chegaram a Vendas, 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. No Odoo 17, 18 e 20, uma encomenda criada depois no Billbee entrou no Odoo.
Perguntas sobre as encomendas Billbee no Odoo
O que acontece se um SKU do Billbee não estiver no Odoo?
A linha entra com o produto genérico Importação Billbee (SKU não correspondido) e o resto da encomenda chega como sempre. Para que se ligue sozinha da próxima vez, o produto do Odoo precisa desse SKU como referência interna.
O Odoo confirma e fatura as encomendas sozinho?
Só se o ativar na conta: os três passos vêm desligados. Para a fatura, o Odoo espera por omissão até o Billbee marcar a encomenda como paga.
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): data/billbee_cron_data.xml:8
- 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_order.py:640
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:127
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:158
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:241
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:169
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:296
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:183
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:385
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:351
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:415
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:427
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:413
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:166
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:111
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:206
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:217
- Código do módulo: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
- hilfe.billbee.io/article/1477-bestellstatus-in-billbee
- 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
