Saltar para o conteúdo principal
Leroy Merlin

Arrancar com o Leroy Merlin Connector no Odoo: perguntas e respostas

Para arrancar com o Leroy Merlin Connector, revê primeiro os campos de configuração: Create Sales Orders From, Fallback Customer, Manual Text Language e Mirakl Odoo Root Category. Depois percorre o catálogo que vem do Mirakl e os mapeamentos de categorias e transportadoras. Na primeira semana, acompanha o estado de seguimento, que só pode ser Pending, Synced ou Error.

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

O essencial

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

O que preencher antes da primeira sincronização

O que preciso de contratar e para que versões do Odoo está disponível?

O módulo está publicado na Odoo Apps para Odoo 17.0, 18.0, 19.0 e 20.0 e custa 9 € por versão do Odoo, pagamento único, sem IVA; se o comprares na Odoo App Store, cada versão do Odoo compra-se lá. A ligação ao Leroy Merlin precisa também do plano Conector do FlexigoTech Cloud (49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma; o plano Pro, 98 €/mês ou 980 €/ano sem IVA, chega a 10). O FlexigoTech Cloud guarda as credenciais encriptadas, acompanha a sincronização e avisa por e-mail se falhar.

Que campos de configuração tenho de rever um a um?

Estes são os que convém verificar antes de lançar qualquer coisa, com a etiqueta e o nome técnico para os encontrares:

  • Create Sales Orders From (sale_order_start_date), um campo de data e hora.
  • Fallback Customer (default_partner_id), que aponta para um cliente do Odoo.
  • Manual Text Language (text_language_code) e Effective Text Language (effective_text_language_code), dois campos de texto sobre o idioma.
  • Mirakl Odoo Root Category (mirakl_category_root_id), que aponta para uma categoria do Odoo.

Repara também que vários registos do módulo têm um campo que os liga à instância (instance_id ou leroy_mirakl_instance_id, ambos para leroy.mirakl.instance). Por isso, nas listas do conector vais ver uma coluna de instância com o valor Leroy Merlin.

Que data ponho em Create Sales Orders From?

Segundo a descrição do campo, as encomendas do Mirakl criadas antes dessa data são importadas (em Orders), mas nunca se convertem em ordens de vendas. Assim, antes de ligar, decide a partir de quando queres que as encomendas do Leroy Merlin gerem ordens de vendas no teu Odoo e coloca essa data. As encomendas anteriores continuarão a entrar como encomendas Mirakl, sem ordem de vendas.

O que ponho em Manual Text Language?

O campo guarda o código de idioma do Odoo usado no modo manual, por exemplo en_US, fr_FR ou pt_PT. Se trabalhas em modo manual, escreve aí o código do idioma tal como o Odoo o tem, no mesmo formato dos exemplos. O módulo tem ainda o campo Effective Text Language; vê-o em conjunto com o anterior quando reveres a configuração.

Para que serve Mirakl Odoo Root Category?

Segundo a sua descrição, é a categoria raiz do Odoo usada para refletir os caminhos de categorias do Mirakl nesta instância. Escolhe ou cria no Odoo a categoria que queres usar como raiz e atribui-a na instância antes de trazer o catálogo.

Lista de Categorias Mirakl no Odoo com as colunas Instancia, Camino, Código, Hoja e Activo e linhas do Leroy Merlin
A lista de Categorias Mirakl, com as categorias do Leroy Merlin e as colunas Camino, Código, Hoja e Activo
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)

Catálogo e mapeamentos: categorias, atributos e transportadoras

Onde vejo o catálogo que vem do Leroy Merlin?

O módulo guarda o catálogo do Mirakl em três modelos próprios: categorias (leroy.mirakl.catalog.category), atributos (leroy.mirakl.catalog.attribute) e valores (leroy.mirakl.catalog.value). Na lista de categorias vês o caminho de cada uma, o código e se é folha; na de atributos, o código, a etiqueta, o tipo, o código da lista de valores e se é obrigatório ou multivalor. Revê esta segunda lista com calma: as colunas requerido e multivalor dizem-te que atributos o Mirakl marca assim.

Lista de atributos Mirakl no Odoo com as colunas instância, código, etiqueta, tipo de atributo, código da lista de valores, obrigatório, multivalor e ativo
Os atributos Mirakl do Leroy Merlin, todos ativos, com as colunas de tipo, obrigatório e multivalor

Que mapeamentos tenho de preparar?

O módulo tem dois modelos de mapeamento: o de categorias (leroy.mirakl.category.map) e o de transportadoras (leroy.mirakl.carrier.map), além de uma lista de transportadoras disponíveis (leroy.mirakl.available.carrier). No mapeamento de categorias, cada linha liga uma categoria de artigo do Odoo a um código de categoria do Mirakl, à sua etiqueta e ao seu caminho. No de transportadoras, cada linha tem a transportadora, o código de operador e o nome da transportadora. Confirma que as linhas que vais usar têm a caixa Activo assinalada.

Lista de atributos Mirakl, mapeamento de transportadoras com MRW ES, MRW PT e Correos Express, mapeamento de categorias com Acoples Camlock e formulário da instância com o separador Operaciones manuales
Do catálogo aos mapeamentos: atributos, transportadoras, categorias e, no fim, o separador Operaciones manuales da instância com botões para encomendas, ofertas, catálogo, preço e stock e as datas da última sincronização e exportação

A primeira semana: estados e encomendas

Que estados tem o seguimento e qual devo vigiar?

O campo leroy_mirakl_tracking_state só admite três valores: pending (Pending), synced (Synced) e error (Error). Na primeira semana, filtra diariamente os registos em Error e não os deixes acumular; se não perceberes a mensagem que acompanha a falha, tens os textos explicados em as mensagens de erro do Leroy Merlin Connector.

O que vejo numa encomenda Mirakl importada?

Abre algumas encomendas Mirakl dos primeiros dias e revê o formulário completo: dados da encomenda, montantes, estado, a ordem de vendas ligada e a secção Aceptación. No topo aparecem os botões Cancelar e Reembolso en Mirakl. Se uma encomenda for anterior à data de Create Sales Orders From, lembra-te de que não terá ordem de vendas.

Formulário de uma encomenda Mirakl do Leroy Merlin com os botões Cancelar e Reembolso en Mirakl, montantes, estado Enviado, ordem de vendas e secção Aceptación
Uma encomenda Mirakl do Leroy Merlin no estado Enviado, com a ordem de vendas ligada e a secção Aceptación

O que acontece se a sincronização falhar ou a subscrição terminar?

Se a sincronização falhar, o FlexigoTech Cloud avisa por e-mail, e se o Leroy Merlin mudar a sua API, o módulo e o serviço são adaptados. Sem subscrição, ou com o serviço suspenso, para aquilo que a subscrição oferece, mas os dados ficam no teu Odoo.

Como a FlexigoTech te ajuda

Se preferires não fazer o arranque sozinho, na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Podemos rever contigo os campos de configuração, os mapeamentos e a primeira semana de encomendas. Se quiseres perceber antes o que o conector faz por dentro, lê como funciona o Leroy Merlin Connector.

Continue a ler

Como funciona o Leroy Merlin Connector no Odoo: menus, ações agendadas e percursoQue menus o Leroy Merlin Connector acrescenta ao Odoo, que dez ações agendadas corre e com que frequência, e o que passa pela FlexigoTech Cloud.Mensagens de erro do Leroy Merlin Connector: quando surgem e o que fazerAs mensagens de erro do Leroy Merlin Connector no Odoo com o texto literal: quando surge cada uma, o que significa e o que fazer para continuar a trabalhar.Vende no Leroy Merlin e ainda não usa Odoo: o que faz à mão e o que o Odoo centralizaSe vende no Leroy Merlin e ainda não usa Odoo: o que faz hoje à mão, o que o Odoo centraliza com o Leroy Merlin Connector e por onde começar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes