Saltar para o conteúdo principal
Brico Depot for Mirakl

Brico Depot for Mirakl no Odoo: o que cobre, o que não cobre e o que precisa antes

O Brico Depot for Mirakl é um complemento gratuito do Mirakl Connector: acrescenta o perfil de fornecedor Brico Depot ao conector genérico do Mirakl, que se instala primeiro e que exige a subscrição do FlexigoTech Cloud (plano Conector). Serve se vende ou vai vender no marketplace da Brico Depot (URLs ao estilo de Espanha e Portugal) e quer que encomendas, devoluções e envios se sincronizem com os valores por defeito que o módulo traz para esse operador. Está publicado para Odoo 17, 18, 19 e 20.

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

O essencial

Módulo
Brico Depot for Mirakl
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Para quem é e o que não é

Este módulo faz sentido se a sua empresa trabalha com Odoo e vende, ou vai vender, na Brico Depot através do Mirakl. No Odoo Apps chama-se Brico Depot for Mirakl e o seu README apresenta-o como Flexigobe Mirakl Provider - Brico Depot. Não é um conector independente: segundo esse README, o primeiro passo da instalação é instalar flexigobe_mirakl_connector e o segundo, este complemento. O que traz é o perfil de fornecedor Brico Depot e uma série de comportamentos que ficam ativos por defeito.

Antes de decidir, separe o que poderia supor do que diz a documentação do módulo. Estas são seis ideias que convém descartar, cada uma com o que está de facto documentado.

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)

Ideias erradas sobre o módulo e o que diz o seu README

«Com este módulo já tenho o conector do Mirakl completo»

Não. O README descreve o módulo como um fornecedor do Mirakl para a Brico Depot, e a primeira coisa que inclui é o perfil de fornecedor Brico Depot. A sincronização de encomendas e devoluções é a genérica do Mirakl, que o módulo ativa por defeito. Por isso, a ordem de instalação que a documentação indica é primeiro flexigobe_mirakl_connector e depois este complemento.

«O endereço da API da Brico Depot já vem preenchido»

Também não. A documentação diz que o módulo, de propósito, não impõe um URL base de API fixo. Ao criar a instância do Mirakl e escolher Brico Depot como fornecedor, é você que introduz o URL base real do vendedor, o URL base da API e a chave API que o operador lhe facilita. O que o módulo faz é detetar os URLs ao estilo dos marketplaces da Brico Depot Espanha e Portugal, e reconhecê-los durante a configuração do fornecedor.

Formulário de instância Mirakl Brico Depot ES em estado Active com fornecedor, URL, chave API, moeda EUR e idioma es_ES
A instância da Brico Depot ES: fornecedor, URL, chave API, moeda EUR, idioma es_ES, modo de impostos e sete opções de automatização ativadas.

«Se o operador não publicar /returns, fico sem devoluções»

O módulo contempla esse caso. Ativa um mecanismo de recurso que obtém as devoluções a partir dos reembolsos das encomendas quando o operador não expõe /returns. Segundo o README, esse recurso a partir de reembolsos continua ativo.

«Vou ter de configurar à mão como se aceitam as encomendas»

O módulo traz valores por defeito para isso: ativa a aceitação automática de encomendas e a confirmação da venda. Tenha-o presente desde o início: se na sua empresa alguém revê cada encomenda antes de a aceitar, decida como quer trabalhar antes de ativar as tarefas.

«O acompanhamento e os envios são uma lógica nova, feita só para a Brico Depot»

Segundo o README, a lógica de acompanhamento e envio reutiliza o núcleo genérico do Mirakl já validado. Sobre esse fluxo genérico de acompanhamento, o módulo ativa ganchos de automatização de envios. Além disso, ativa por defeito uma reparação dos dados de contacto de envio anterior à validação em armazém. Se o seu armazém depende desses dados, confirme-o com encomendas de teste antes de passar a produção.

«Pago a ficha do Odoo Apps uma vez e pronto, em qualquer versão»

Não. O módulo em si é um complemento gratuito (o seu manifesto não tem preço); os 9 € sem IVA que a ficha indica são o preço do Mirakl Connector, de que depende, em pagamento único por versão do Odoo, para 17, 18, 19 e 20. Além disso, o Mirakl Connector precisa da subscrição do FlexigoTech Cloud, plano Conector, de 49 €/mês ou 490 €/ano sem IVA (até 3 contas da plataforma; o plano Pro, 98 €/mês ou 980 €/ano, até 10). A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, vigia a sincronização e avisa por e-mail se falhar: sem subscrição, ou com o serviço suspenso, pára o que a subscrição assegura, pelo que a ligação com a Brico Depot não funciona, embora os dados fiquem no seu Odoo. Com a subscrição, o módulo para as versões novas do Odoo vem incluído se o comprou em flexigotech.com; no Odoo App Store, cada versão compra-se lá. Tem-no na ficha do Odoo Apps e na página do módulo.

O que deve ter pronto antes de o instalar

Se, depois do que ficou dito, o módulo serve, prepare isto antes de mexer em produção:

  • A sua versão do Odoo identificada (17, 18, 19 ou 20) e decidido onde compra: em flexigotech.com ou na ficha dessa versão no Odoo Apps.
  • A subscrição do FlexigoTech Cloud com o plano Conector, que o Mirakl Connector exige.
  • O conector base flexigobe_mirakl_connector, que se instala primeiro.
  • O URL base real do vendedor, o URL base da API e a chave API, tal como o operador lhos facilita.
  • Uma decisão tomada sobre a aceitação automática de encomendas e a confirmação da venda, que vêm ativas por defeito.

A ordem que o README indica é instalar o conector, instalar este complemento, criar a instância do Mirakl escolhendo Brico Depot como fornecedor, introduzir os URLs e a chave, e executar Test Connection para validar o contexto do marketplace antes de ativar as tarefas.

Como referência dos ecrãs do conector, assim se vê o separador de ligação de outra instância Mirakl, neste caso a da Leroy Merlin:

Formulário de instância Mirakl Leroy Merlin com o separador Conexion, URL base, chave API oculta e estado do último teste OK
Outra instância Mirakl (Leroy Merlin): botões de ligação e exportação, dados gerais e o separador Conexion com o URL base, a chave oculta e parâmetros técnicos.

E esta é a lista de categorias Mirakl, aqui com linhas da Leroy Merlin:

Lista de Categorias Mirakl no Odoo com colunas Instancia, Camino, Código, Hoja e Activo
A lista de categorias Mirakl com categorias e códigos da Leroy Merlin, pesquisa e paginação.

Como decidir se serve para si

  • Se vende na Brico Depot via Mirakl e tem ou vai ter o conector base com a respetiva subscrição, serve: acrescenta o perfil do operador e os seus valores por defeito.
  • Se não quer uma subscrição mensal ou anual, tenha em conta que, sem ela, a ligação não funciona.
  • Se o operador não lhe oferece /returns, repare no recurso de devoluções a partir de reembolsos, que vem ativo.
  • Se prefere aceitar as encomendas à mão, reveja a aceitação automática e a confirmação da venda antes de ativar as tarefas.
  • Se não vende na Brico Depot, este complemento é um perfil de fornecedor para esse operador e não é o que procura.

Como o ajuda a FlexigoTech

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se precisa de ajuda para instalar o conector base, configurar a instância da Brico Depot ou adaptar o fluxo de encomendas e envios à forma como a sua empresa trabalha, podemos fazê-lo consigo.

Continue a ler

Como funciona o Shopee Marketplace Connector (APAC) por dentro do OdooMenus, tarefas agendadas e modelos do Shopee Marketplace Connector (APAC) no Odoo 17, 18, 19 e 20: o que acrescenta a Vendas e com que frequência sincroniza.Erros do Shopee Marketplace Connector (APAC): quando aparece cada mensagem e o que fazerO que significa cada mensagem de erro do Shopee Marketplace Connector (APAC) no Odoo, quando aparece e o que fazer, com um caso inventado e os textos literais.Arranque do Shopee Marketplace Connector (APAC) no Odoo: campos, mapeamentos e primeira semanaGuia para pôr a funcionar o Shopee Marketplace Connector (APAC) no Odoo: campos da conta, mapeamentos de categorias e atributos e o que rever na primeira semana.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes