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.


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.
| Tarefa | Hoje, operador a operador | No Odoo com o Conector Mirakl |
|---|---|---|
| Ligar cada marketplace | Cada marketplace tem o seu endereço e entra-se com a chave da loja | Uma instância por operador, com o URL base do operador, o URL Base da API e a chave de API |
| Ler novas encomendas | A Mirakl recomenda consultar a lista de encomendas (OR11) a cada 5 minutos e, no máximo, uma vez por minuto | Ação agendada Mirakl - Sincronizar Encomendas, a cada 10 minutos; lista em Mirakl › Operações › Encomendas |
| Aceitar encomendas | As linhas em WAITING_ACCEPTANCE aceitam-se ou recusam-se com OR21 | Ação agendada Mirakl - Aceitar Encomendas, a cada 10 minutos |
| Ofertas e stock | Em cada marketplace, no seu próprio endereço | Mirakl › 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ções | Em cada marketplace, no seu próprio endereço | Mirakl › Operações › Devoluções; ação agendada Mirakl - Sincronizar Devoluções, a cada 30 minutos |
| Liquidações do operador | Em cada marketplace, no seu próprio endereço | Mirakl › 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.


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.
- 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.
- Instale o Conector Mirakl na sua versão e ligue-o à sua subscrição do FlexigoTech Cloud no plano Conector.
- Crie uma instância Mirakl por operador com o URL base real do operador, o
URL Base da APIe a chave de API da sua loja. EmMirakl › ConfiguraçãotemMarketplaceseRegistos. O que significa cada campo da instância está em os campos da instância Mirakl. - Espere pela primeira encomenda. A ação agendada
Mirakl - Sincronizar Encomendascorre a cada 10 minutos e as encomendas aparecem emMirakl › Operações › Encomendas. A ação só traz as encomendas das instâncias com a caixaSincronizaçã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 emWAITING_ACCEPTANCE. - Reveja as suas encomendas em
Mirakl › Operações › Encomendas: a lista mostra o seu estado e a sua aceitação. A ação agendadaMirakl - Aceitar Encomendascorre a cada 10 minutos e está ativa na instalação. Só aceita encomendas nas instâncias com a caixaAceitar Encomendas Automaticamente(Auto Accept Orders) marcada, que vem desmarcada por omissão. - 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 comSincronização de Ofertas Ativada(Sync Offers Enabled), os preços comExportação Automática de Preços Ativada(Auto Export Prices Enabled) e o stock comExportação Automática de Stock Ativada(Auto Export Stock Enabled). As três vêm desmarcadas por omissão. - Abra a primeira liquidação em
Mirakl › Finanças › Liquidações e Faturase vejaAná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
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or11.md
- developer.mirakl.com/content/product/mmp/rest/seller/openapi3/orders/or21.md
- www.mirakl.com/products/connect/pricing/
- www.mirakl.com/
- apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_connector
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- Código do módulo: flexigobe_mirakl_connector 20.0 (2766034c): __manifest__.py
- Código do módulo: flexigobe_mirakl_connector 20.0 (2766034c): views/menu_views.xml
- Código do módulo: flexigobe_mirakl_connector 20.0 (2766034c): data/ir_cron_data.xml
- flexigotech.com/pt/conector-mirakl-odoo.html
- flexigotech.com/pt/precios.html
- Código do módulo: flexigobe_mirakl_connector 20.0 (2766034c): models/mirakl_api_mixin.py
- Código do módulo: flexigobe_mirakl_connector 20.0 (2766034c): README.md
