Saltar para o conteúdo principal
Billbee

Encomendas Billbee no Odoo: do Billbee a Vendas, com cliente, linhas por SKU e IVA certo

No seu site, o Billbee apresenta-se como o ponto central do seu comércio multicanal. Com o conector, cada encomenda Billbee chega a Vendas no Odoo como ordem de venda, com o seu cliente, o seu endereço de entrega e as suas linhas ligadas por SKU. Se o Odoo a confirma, fatura e valida a entrega é decisão sua, na conta.

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
6 min

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.

Painel do Billbee no Odoo
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.

Produtos do Odoo ligados ao Billbee
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

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.A API do Billbee a partir do Odoo: a chave, a sua palavra-passe da API, a quota e os errosO que a API do Billbee pede, como o conector do Odoo a usa através da FlexigoTech Cloud e o que faz com a quota de 100.000 chamadas por mês por ferramenta.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): 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