A confusão mais comum com a Mirakl é tratá-la como se fosse a Amazon. Não é. A Mirakl é a plataforma que a Decathlon, a Leroy Merlin, a Bricodepot, a GACD e dezenas de cadeias mais usam para abrir o seu próprio marketplace a vendedores externos. Para si, isso tem uma consequência muito boa e outra assim-assim.
A boa: a API é a mesma para todos. Uma integração bem feita com a Mirakl serve para o primeiro operador e para o quinto, mudando o URL do operador e a chave de API. A assim-assim: por cima dessa base comum, cada operador impõe as suas regras (a sua árvore de categorias, os seus atributos obrigatórios, os seus prazos, as suas penalizações e até que partes da API tem abertas) e essas não se partilham.
O que todos partilham
O ciclo é sempre o mesmo: publica ofertas (produto, preço, stock, prazo), o operador envia-lhe encomendas, aceita-as ou rejeita-as, expede com seguimento e recebe por liquidação. O conector da Mirakl leva esse ciclo para documentos normais do Odoo nas versões 17, 18 e 19: publica ofertas com preço, stock e prazo de expedição, importa as encomendas como encomendas de venda, aceita-as (manualmente ou de forma automática, se a ativar), envia à Mirakl a transportadora e o número de seguimento da guia de remessa e importa as liquidações para as lançar na contabilidade.
Um pormenor que surpreende: na Mirakl pode rejeitar linhas de uma encomenda. Não é uma falha, faz parte do protocolo. O nosso conector não rejeita linhas soltas: aceita a encomenda inteira. Se houver uma linha que não consegue satisfazer, rejeite-a no back office da Mirakl antes de aceitar, e tenha em conta que a aceitação automática, que vem desativada, aceita tudo o que entra.
O que muda com cada operador
A árvore de categorias e os atributos obrigatórios, que não se parecem entre uma cadeia de desporto e uma de bricolage. O prazo de aceitação, que em alguns operadores se mede em horas. E a exigência de dados do produto: há operadores que rejeitam uma oferta se faltar o EAN e outros que pedem ainda uma ficha técnica completa.
Por isso temos uma página por operador, além da do conector: Decathlon, Leroy Merlin, Brico Depot e GACD. O conector base é o mesmo e cada operador é mais uma instância, com o seu URL e a sua chave; para alguns operadores existe ainda um perfil complementar que deixa configurados o URL e os respetivos valores por defeito. O que muda de verdade é a preparação do catálogo.
O que preparar antes de pedir a adesão
Três coisas, e nenhuma é técnica. EAN em todas as referências que vá publicar: há operadores que, sem ele, não lhe aceitam a oferta. Um prazo de preparação que consiga cumprir de verdade, e não o que gostaria; prometer 24 horas e expedir em 72 paga-se na conta. E fotografias que cumpram a norma deles, que costuma ser mais exigente do que a do seu próprio site.
E um aviso por experiência própria
Auditámos o nosso próprio conector da Mirakl quando a sua suite de testes passava em verde no Odoo 19, 18 e 17, e encontrámos 18 falhas confirmadas, entre elas um registo de chamadas que nunca escrevia nada e uma sincronização que olhava para a data errada. Contamos tudo em auditar um conector herdado. Se lhe forem vender uma integração da Mirakl, pergunte o que acontece quando a API devolve um erro, não quantos testes tem.
Perguntas frequentes
Uma adesão à Mirakl abre-me todos os operadores?
Não. Cada operador aceita-o ou não em separado, com o seu próprio processo comercial. O que se reutiliza é a integração técnica, não a relação comercial.
Posso ter preços diferentes por operador?
Sim, e deve: as comissões não são iguais. No conector, cada operador é uma instância, e cada instância calcula o seu preço com a sua própria estratégia: preço de venda do produto, uma lista de preços do Odoo ou custo mais margem.
O que acontece com as liquidações?
Chegam por operador e têm de ser reconciliadas com as vendas, descontando a comissão. É a parte mais descuidada e onde mais dinheiro se perde sem que ninguém repare.
Ligações úteis dentro da FlexigoTech
O que fazemos sobre isto
Foi aceite num marketplace da Mirakl?
Diga-nos que operador e quantas referências quer publicar. Verificamos se o seu catálogo cumpre o que lhe vão pedir antes de lho rejeitarem. Escreva para comercial@flexigobe.com ou marque uma chamada.

