Saltar para o conteúdo principal
Mirakl

Vendedores Mirakl que ainda não usam Odoo: o que muda com o Odoo como ERP

Se vende em um ou mais marketplaces que funcionam com Mirakl e hoje os gere a partir do painel de cada operador ou com folhas de cálculo, passá-los para o Odoo com o Conector Mirakl dá-lhe uma ligação por operador, com o seu endereço de API e a sua chave de loja. Encomendas, ofertas e devoluções ficam num único menu, a ação agendada Mirakl - Aceitar Encomendas corre a cada 10 minutos e as liquidações e faturas do operador têm menu próprio.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 10 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
7 min

O que muda nos seus marketplaces Mirakl com o Odoo como ERP

Segundo a documentação da Mirakl, cada marketplace tem o seu próprio endereço, que deve ser substituído pelo URL da sua instância Mirakl, e a API de vendedor autentica-se com a chave da loja, enviada no cabeçalho Authorization. Ou seja, cada operador em que vende tem o seu endereço e a sua chave.

Com o Conector Mirakl, cada operador passa a ser uma instância Mirakl dentro do Odoo, criada com o URL base real do operador, o URL Base da API e a chave de API. Segundo a sua ficha, o módulo liga o Odoo a qualquer marketplace Mirakl: publica produtos, preços e stock, e traz encomendas, devoluções, liquidações e mensagens. Tudo pendura de um único menu Mirakl, com Painel, Operações, Catálogo, Finanças e Configuração.

Cada chave de loja fica com o seu operador: o módulo só a envia para o URL Base da API da sua instância. Se lhe pedirem para contactar outro endereço, para com esta mensagem: Recusado o contacto com …: a chave de API da Mirakl de … só vai para o seu URL Base da API (…). Escreva o endpoint como um caminho, por exemplo /orders.

Um registo de marketplace Mirakl no Odoo 20 com o endereço de API do operador e a ligação ao FlexigoTech Cloud
Um registo de marketplace no Odoo 20, com dados de demonstração e ainda sem ligação: o endereço de API do operador, a ligação ao FlexigoTech Cloud e os botões de importação.
How to stop copy-pasting between apps (Odoo)
Vídeo: How to stop copy-pasting between apps (Odoo) (vídeo em inglês)

Operador a operador hoje face à Mirakl dentro do Odoo

Esta é a comparação tarefa a tarefa do que faz com cada marketplace e de onde fica no Odoo com o conector.

TarefaHoje, operador a operadorNo Odoo com o Conector Mirakl
Ligar cada marketplaceCada marketplace tem o seu endereço e entra-se com a chave da lojaUma instância por operador, com o URL base do operador, o URL Base da API e a chave de API
Ler novas encomendasA Mirakl recomenda consultar a lista de encomendas (OR11) a cada 5 minutos e, no máximo, uma vez por minutoAção agendada Mirakl - Sincronizar Encomendas, a cada 10 minutos; lista em Mirakl › Operações › Encomendas
Aceitar encomendasAs linhas em WAITING_ACCEPTANCE aceitam-se ou recusam-se com OR21Ação agendada Mirakl - Aceitar Encomendas, a cada 10 minutos
Ofertas e stockEm cada marketplace, no seu próprio endereçoMirakl › Operações › Ofertas; ações agendadas Mirakl - Exportar Ofertas (a cada 5 minutos), Mirakl - Exportar Preços (PRI01) (a cada 15 minutos) e Mirakl - Exportar Stock (STO01) (a cada 10 minutos)
DevoluçõesEm cada marketplace, no seu próprio endereçoMirakl › Operações › Devoluções; ação agendada Mirakl - Sincronizar Devoluções, a cada 30 minutos
Liquidações do operadorEm cada marketplace, no seu próprio endereçoMirakl › Finanças › Liquidações e Faturas e, no mesmo menu, Análise Financeira (P&L)

Todas as ações agendadas da tabela ficam ativas assim que o módulo é instalado. Mas cada uma só trabalha com as instâncias que têm a sua caixa marcada, e essas caixas vêm desmarcadas por omissão. Hoje, cada linha faz-se em cada marketplace, no seu próprio endereço; no Odoo, cada linha é um menu ou uma ação agendada do módulo. O que o módulo acrescenta à ordem de vendas do Odoo, campo a campo, está em o que o Conector Mirakl acrescenta às Vendas.

O catálogo e as mensagens ficam fora da tabela. Em Mirakl › Catálogo tem Categorias, Atributos, Listas de valores, Mapeamento de Categorias e Mapeamento de Transportadoras, com as ações agendadas Mirakl - Exportar Catálogo (a cada 30 minutos) e Mirakl - Sincronizar Dicionário de Catálogo (a cada 60 minutos). As mensagens têm menu próprio em Mirakl › Operações › Mensagens.

Lista de encomendas Mirakl no Odoo 20 com o seu estado, aceitação, montante e ordem de vendas
A lista de encomendas Mirakl no Odoo 20, com dados de demonstração e uma API Mirakl simulada: oito encomendas com o seu estado, a sua aceitação, o montante e a sua ordem de vendas.
Uma encomenda Mirakl em WAITING_ACCEPTANCE dentro do Odoo 20 com o bloco de aceitação
Uma encomenda em WAITING_ACCEPTANCE dentro do Odoo 20, com dados de demonstração e uma API simulada: estado pendente e o bloco de aceitação da encomenda.

Preços do Mirakl Connect e o que precisa o conector

A Mirakl publica preços para a sua ferramenta de vendedor, o Mirakl Connect, que apresenta como uma ajuda para dezenas de milhares de vendedores chegarem aos principais marketplaces do mundo. Os preços que mostra no seu site estão em dólares e escalonados por volume mensal de vendas (GMV):

  • Growth: 699 dólares por mês, para um volume de até 50 000 dólares de GMV por mês.
  • Pro: 2299 dólares por mês, para um volume de até 200 000 dólares de GMV por mês.
  • Enterprise: à medida, para quem estiver acima desse volume, isto é, mais de 200 000 dólares de GMV por mês.

Para trazer os seus marketplaces Mirakl para o Odoo com o Conector Mirakl, precisa do seguinte:

  • Odoo na versão 17, 18, 19 ou 20.
  • O Conector Mirakl instalado nessa versão.
  • Uma subscrição do FlexigoTech Cloud no plano Conector, que o módulo requer segundo a sua ficha.
  • Para cada operador, o seu URL base real, o seu URL base da API e a sua chave de loja.

Com esses dados, cada operador fica na sua própria instância dentro do Odoo e cada chave de loja só vai para o endereço de API do seu operador.

Da implementação do Odoo à primeira liquidação Mirakl, por ordem

Se ainda não usa Odoo, a ordem importa: primeiro o Odoo, depois o conector, depois cada operador.

  1. Implemente o Odoo. A FlexigoTech implementa o Odoo 17, 18, 19 e 20; pode começar por uma implementação do Odoo antes de ligar qualquer marketplace.
  2. Instale o Conector Mirakl na sua versão e ligue-o à sua subscrição do FlexigoTech Cloud no plano Conector.
  3. Crie uma instância Mirakl por operador com o URL base real do operador, o URL Base da API e a chave de API da sua loja. Em Mirakl › Configuração tem Marketplaces e Registos. O que significa cada campo da instância está em os campos da instância Mirakl.
  4. Espere pela primeira encomenda. A ação agendada Mirakl - Sincronizar Encomendas corre a cada 10 minutos e as encomendas aparecem em Mirakl › Operações › Encomendas. A ação só traz as encomendas das instâncias com a caixa Sincronização de Encomendas Ativada (Sync Orders Enabled) marcada, que vem desmarcada por omissão. Na Mirakl, as novas linhas que se aceitam ou recusam com OR21 são as que estão em WAITING_ACCEPTANCE.
  5. Reveja as suas encomendas em Mirakl › Operações › Encomendas: a lista mostra o seu estado e a sua aceitação. A ação agendada Mirakl - Aceitar Encomendas corre a cada 10 minutos e está ativa na instalação. Só aceita encomendas nas instâncias com a caixa Aceitar Encomendas Automaticamente (Auto Accept Orders) marcada, que vem desmarcada por omissão.
  6. Percorra as suas ofertas em Mirakl › Operações › Ofertas. As ações agendadas que exportam ofertas, preços e stock também estão ativas na instalação. Mas só exportam das instâncias com a caixa correspondente marcada: as ofertas com Sincronização de Ofertas Ativada (Sync Offers Enabled), os preços com Exportação Automática de Preços Ativada (Auto Export Prices Enabled) e o stock com Exportação Automática de Stock Ativada (Auto Export Stock Enabled). As três vêm desmarcadas por omissão.
  7. Abra a primeira liquidação em Mirakl › Finanças › Liquidações e Faturas e veja Análise Financeira (P&L) no mesmo menu.

Se quiser ver o conector antes de decidir, a sua página está em flexigotech.com. Além de implementar o Odoo, a FlexigoTech desenvolve conectores e integrações à medida, caso a sua forma de trabalhar com um determinado operador precise de algo mais.

Quanto custa levar a Mirakl para o Odoo: módulo e plano Conector

O Conector Mirakl custa 9 € por versão do Odoo, sem IVA, para 17, 18, 19 e 20. A sua ficha indica que requer a subscrição do FlexigoTech Cloud: o plano Conector custa 49 €/mês ou 490 €/ano sem IVA, com até 3 contas de plataforma, e o Pro custa 98 €/mês ou 980 €/ano sem IVA, com até 10. A subscrição pode ser experimentada gratuitamente, sem cartão.

A isto soma-se a implementação do Odoo, que é um trabalho à parte. O módulo e a subscrição estão na página do conector Mirakl para Odoo.

Mirakl com o Odoo como ERP: perguntas frequentes

Posso trazer vários operadores Mirakl para o mesmo Odoo?

Cada operador entra na sua própria instância Mirakl, com o seu URL base, o seu URL base da API e a sua chave. O plano Conector inclui até 3 contas de plataforma e o Pro até 10.

Com que frequência chegam as encomendas ao Odoo?

A ação agendada Mirakl - Sincronizar Encomendas corre a cada 10 minutos e está ativa na instalação. Só traz as encomendas das instâncias com a caixa Sincronização de Encomendas Ativada (Sync Orders Enabled) marcada, que vem desmarcada por omissão. A Mirakl, por sua vez, recomenda ler a lista de encomendas a cada 5 minutos e, no máximo, uma vez por minuto.

Poderia uma chave de loja ir parar a outro operador?

O módulo só envia a chave de cada instância para o seu URL Base da API. Se lhe pedirem para contactar outro endereço, para com a mensagem Recusado o contacto com …: a chave de API da Mirakl de … só vai para o seu URL Base da API (…). Escreva o endpoint como um caminho, por exemplo /orders.

Em que versões do Odoo funciona?

O Conector Mirakl está publicado no Odoo Apps para o Odoo 17, 18, 19 e 20.

Continue a ler

O que o Mirakl Connector acrescenta à encomenda de venda do Odoo (Vendas)Os campos que o Mirakl Connector acrescenta à encomenda de venda do Odoo, quando se veem e o que faz o módulo ao apagar, editar moradas ou faturar.Checklist da instância do Mirakl Connector, campo a campoChecklist para preencher a instância do Mirakl Connector no Odoo: ligação, contas de liquidação e opções, com o que diz a ajuda de cada campo.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes