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.

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.

«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:

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

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
Verificado no código do módulo (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_mirakl_provider_bricodepot 20.0 (bd199f4d): README.md
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_provider_bricodepot
- apps.odoo.com/apps/modules/17.0/flexigobe_mirakl_provider_bricodepot
- apps.odoo.com/apps/modules/18.0/flexigobe_mirakl_provider_bricodepot
- apps.odoo.com/apps/modules/19.0/flexigobe_mirakl_provider_bricodepot
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
