Leroy Merlin for Mirakl no Odoo: o que cobre, o que precisa antes e em que versão

O que o Leroy Merlin for Mirakl acrescenta ao conector de Mirakl

Este módulo apoia-se noutro. Segundo o seu README, o seu papel é acrescentar Leroy Merlin como opção de fornecedor dentro do conector genérico de Mirakl. O seu nome técnico é flexigobe_mirakl_provider_leroy_merlin e nas suas notas técnicas figura como requisito flexigobe_mirakl_connector. O que traz, segundo a secção «Why This Module»:

• Pré-carrega os URL de Mirakl da ADEO e da Leroy e os valores por defeito do fornecedor.
• Melhora a autodeteção da plataforma durante os testes de ligação.
• Adapta a sincronização de atributos do catálogo a fluxos CSV ao estilo da Leroy.
• Ajusta o comportamento de dicionários e listas de valores às estruturas de catálogo da Leroy.
• Preenche certos atributos da Leroy do tipo booleano com valores por defeito seguros.
• Mantém a importação de devoluções da Leroy, conservando o recurso aos reembolsos do pedido.
• Ativa o fluxo avançado de seguimento que usa o núcleo genérico de Mirakl.

Os valores que deixa configurados

O README detalha o que o módulo traz de série: o valor de fornecedor Leroy Merlin, o código de perfil de marketplace leroy_merlin, o URL base https://adeo-marketplace.mirakl.net e o URL da API https://adeo-marketplace.mirakl.net/api. O modo de impostos das ofertas fica em include_sales_taxes e o catálogo e as ofertas usam valores por defeito com formato de operador. Para detetar a plataforma usa as assinaturas adeo-marketplace e leroy merlin.

Na parte do catálogo, o módulo coloca os dicionários em modo de sincronização de atributos por CSV, usa um tamanho de lote de dicionário maior nas importações da Leroy, desativa o recurso em massa de listas de valores e a pré-carga onde os fluxos da Leroy saem a ganhar, e aplica False/NO por defeito em certos atributos do catálogo.

Em encomendas, devoluções e envios, o módulo também:

• Deixa ativada a sincronização de devoluções, com recurso aos reembolsos que aparecem nos dados das encomendas.
• Ativa os hooks avançados de seguimento de envios por cima do núcleo genérico de Mirakl.
• Ativa a reparação do endereço de entrega antes da validação em armazém quando é necessário.

O que continua nas mãos do núcleo genérico de Mirakl

Para decidir convém ter claro que parte resolve o conector genérico em que este módulo se apoia. As notas operacionais do README dizem-no assim:

• Os catálogos reais de transportadoras da ADEO são cobertos pelo fluxo SH21 do conector genérico de Mirakl.
• As árvores de categorias da Leroy são geridas com a pesquisa de hierarquias do conector genérico.
• Se o operador não expõe /returns, o núcleo genérico pode, mesmo assim, criar os registos de devolução a partir dos reembolsos que vêm nas encomendas importadas.

O README também nomeia os modelos mirakl.instance e mirakl.product.binding. A decisão de fundo, portanto, é se vai trabalhar com o conector genérico de Mirakl, porque este módulo o declara como requisito.

O que precisa antes de instalar

Duas peças: o conector genérico de Mirakl e a subscrição do FlexigoTech Cloud que esse conector pede. O manifesto do Mirakl Connector di-lo tal e qual: «Needs FlexigoTech Cloud subscription (from 49 EUR/month, VAT excl.)». A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar; se a plataforma mudar a sua API, adaptam-se o módulo e o serviço.

Sem a subscrição, ou com o serviço suspenso, pára aquilo que a subscrição dá; os dados ficam no seu Odoo.

Em que versões do Odoo está publicado e quanto custa

O Leroy Merlin for Mirakl é um complemento gratuito: os 9 € sem IVA que a sua ficha indica são o preço do Mirakl Connector, do qual depende, em pagamento único por versão do Odoo, igual no 17, 18, 19 e 20. A isto soma-se a subscrição do plano Conector do FlexigoTech Cloud: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma (Pro: 98 €/mês ou 980 €/ano, até 10).

O que muda ao subir de versão do Odoo

Se comprou o módulo em flexigotech.com e tem a subscrição, o módulo para as versões novas do Odoo está incluído. Se o comprou na Odoo App Store, cada versão do Odoo compra-se lá. Antes de migrar, confirme que na versão de destino tem também flexigobe_mirakl_connector, porque é o seu requisito.

Critérios para decidir se lhe serve

• Se vende na Leroy Merlin através do Mirakl e já tem o conector genérico com a sua subscrição, convém-lhe: o módulo acrescenta o perfil leroy_merlin com os seus URL e valores por defeito.
• Se ainda não tem o conector genérico de Mirakl, primeiro precisa desse e da subscrição do FlexigoTech Cloud.
• Se o seu trabalho com a Leroy passa por dicionários de catálogo e listas de valores, os ajustes de CSV, tamanho de lote e False/NO são a parte do módulo que trabalha sobre isso.
• Se importa devoluções da Leroy, o módulo deixa ativada a sua sincronização com recurso aos reembolsos das encomendas.
• Se precisa de transportadoras da ADEO ou de árvores de categorias da Leroy, conte com que são geridas a partir do núcleo genérico (fluxo SH21 e pesquisa de hierarquias).
• Se vende em marketplaces fora do Mirakl, este módulo não é para isso. Se é o seu caso com a Shopee, veja como funciona por dentro o conector da Shopee.

Como experimentar antes de pôr em marcha

Uma base de testes na sua versão do Odoo chega para ver se lhe serve:

1. Ative a subscrição do FlexigoTech Cloud que o Mirakl Connector pede.
2. Instale o conector genérico flexigobe_mirakl_connector.
3. Instale flexigobe_mirakl_provider_leroy_merlin.
4. Crie a instância de Mirakl, escolha Leroy Merlin como fornecedor e confirme que o URL base e o da API são os que o módulo pré-carrega.
5. Lance o teste de ligação, que é onde o módulo aplica a sua autodeteção de plataforma.
6. Reveja os atributos, o mapeamento de categorias e as categorias de Mirakl com os seus dados.

Como o FlexigoTech o ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Tem os detalhes do módulo em a sua página em flexigotech.com e em a ficha do Odoo Apps. Se o seu caso com a Leroy Merlin ou com outro operador de Mirakl pedir algo mais, vemo-lo como desenvolvimento à medida.

Continue a ler

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

Fontes

• Código do módulo: flexigobe_mirakl_provider_leroy_merlin 20.0 (f3f10df8): README.md
• Código do módulo: flexigobe_mirakl_provider_leroy_merlin 20.0 (f3f10df8): README.md:45-46
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_provider_leroy_merlin
• apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_provider_leroy_merlin
• flexigotech.com/en/services.html
• flexigotech.com/precios.html