Saltar para o conteúdo principal

Mirakl

Uma encomenda da Mirakl no Odoo, da compra ao pagamento

Uma encomenda de um marketplace que funciona com Mirakl passa por sete paragens no Odoo: chega, é aceite, prepara-se, sai com seguimento, fatura-se, é paga na liquidação e, por vezes, volta como devolução. Esta cronologia diz-lhe o que o conector faz em cada paragem e com que frequência.

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

O essencial

Módulo: Mirakl
Versões: Odoo 17, 18, 19 e 20
Verificado: no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura: 3 min

A Leroy Merlin, a Decathlon ou a Bricodepot funcionam com Mirakl por baixo. Para o Odoo, o operador não importa: o conector, publicado para o Odoo 17, 18, 19 e 20, fala com a API Mirakl de cada marketplace que configurar e segue sempre o mesmo calendário.

O percurso

Quando o cliente compra A encomenda nasce no marketplace à espera de aceitação. O Odoo ainda não sabe nada.
Nos 10 minutos seguintes A tarefa Mirakl - Sync Orders trá-la para o Odoo. Aparece em Mirakl › Operations › Orders com o estado de aceitação pendente.
Na execução seguinte de aceitação Mirakl - Accept Orders também corre a cada 10 minutos e aceita o que tiver definido para aceitar automaticamente. Se o marketplace não exigir aceitação, o estado passa a não necessária; se algo falhar, a erro, à vista.
Ao aceitar Cria-se a ordem de venda do Odoo com as suas linhas e o cliente. O stock fica comprometido para os outros canais.
Quando a entrega é preparada e validada O seguimento da transportadora vai para o marketplace. O estado de seguimento da encomenda passa de pendente a sincronizado, ou a erro se a Mirakl o rejeitar.
Ao faturar A fatura de cliente é lançada no Odoo e depois enviada para a Mirakl. A ordem importa: uma fatura em rascunho não se envia.
Quando chega a liquidação Settlements & Invoices reúne os pagamentos do operador com o seu estado: pendente, em processamento, transferido ou pago. Cada documento leva também o seu estado contabilístico: não lançado, lançado ou conciliado.
Se houver uma devolução As devoluções sincronizam-se a cada 30 minutos e aparecem em Operations › Returns. O reembolso tem o seu próprio estado: pendente, parcial, reembolsado ou erro.

Lista de encomendas da Mirakl no Odoo com o estado de aceitação e de envio — Encomendas de um marketplace Mirakl dentro do Odoo, cada uma com o seu estado. Captura do Odoo com dados de demonstração.

Same stock on every Mirakl marketplace, sent from Odoo — Vídeo: Same stock on every Mirakl marketplace, sent from Odoo (vídeo em inglês)

Entretanto, stock e preço

Enquanto a encomenda avança, outras três tarefas mantêm a montra atualizada. As ofertas saem a cada 5 minutos. O stock segue pelo fluxo STO01 a cada 10 minutos e os preços pelo PRI01 a cada 15. Assim, quando uma encomenda aceite reserva unidades, os outros marketplaces veem-no em poucos minutos.

Ordem de venda do Odoo criada a partir de uma encomenda da Mirakl — A ordem de venda que o conector cria ao aceitar. Tudo o resto começa aqui: entrega, fatura e devolução. Captura do Odoo com dados de demonstração.

Os dois avisos que mais se veem

Ao enviar a fatura podem aparecer duas mensagens. Post the invoice before sending it to Mirakl. significa que a fatura ainda está em rascunho: lance-a e envie de novo. This invoice is not linked to a Mirakl order. aparece quando a fatura não vem de uma encomenda do marketplace, por exemplo se a criou à mão. A solução é faturar a partir da própria ordem de venda.

Entrega validada de uma encomenda da Mirakl com o seguimento já enviado — Entrega validada: o seguimento já seguiu para o marketplace. Captura do Odoo com dados de demonstração.

O que não corre sozinho

A sincronização de faturas da Mirakl, que corre uma vez por dia, fica desligada após a instalação: ative-a se o seu operador a usar. As mensagens dos clientes também não se ligam automaticamente. Assim, não chega ao Odoo informação para a qual ninguém vai olhar.

Ver o vídeo no YouTube — Vídeo de demonstração do conector da Mirakl no Odoo, com a API da Mirakl simulada.

Se a sua dúvida é porque é que uma encomenda está parada, veja primeiro o estado de aceitação e o estado de seguimento na lista. Quase sempre um dos dois está em erro, e a mensagem diz-lhe porquê.

Continue a ler

Como mapear categorias e atributos da Mirakl no Odoo, passo a passoComo preparar no Odoo o catálogo de um marketplace Mirakl: dicionário de categorias, atributos, listas de valores, mapeamento e exportação, com os erros habituais.Exemplo: um fabricante que vende em vários marketplaces Mirakl com folhas de cálculoCaso de exemplo de um fabricante que vende em vários marketplaces Mirakl com folhas de cálculo, e o que muda quando tudo passa para o Odoo com o conector.

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): data/ir_cron_data.xml
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_finance.py
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_invoice.py
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): models/mirakl_order.py
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): models/stock_picking.py
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): models/account_move.py
Código do módulo: flexigobe_mirakl_connector 20.0 (83e54909): views/menu_views.xml
apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
youtube.com/shorts/nbJU8l2bbCM