Saltar para o conteúdo principal
Mirakl

O erro de marketplace.mirakl.net no Mirakl Connector: quando aparece e como se corrige

O erro sobre marketplace.mirakl.net pode aparecer ao clicar em Testar Ligação quando URL Base ou URL Base da API têm como valor o endereço de exemplo de marketplace.mirakl.net; corrige-se escrevendo nesses dois campos os URL reais do teu operador Mirakl.

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

O essencial

Módulo
Mirakl
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 erro, tal como o vês

Com o Odoo em português de Portugal, a mensagem diz: 'marketplace.mirakl.net' é apenas um marcador de posição e não um anfitrião real de operador Mirakl. Configure o URL real do operador a partir da documentação ou do suporte do operador do marketplace. Exemplo para ADEO/Leroy: https://adeo-marketplace.mirakl.net e https://adeo-marketplace.mirakl.net/api ('marketplace.mirakl.net' is only a placeholder and not a real Mirakl operator host. Configure the actual operator URL from the marketplace operator documentation or support. Example for ADEO/Leroy: https://adeo-marketplace.mirakl.net and https://adeo-marketplace.mirakl.net/api). É um erro: a ação é interrompida.

Em poucas palavras: URL Base ou URL Base da API tem exatamente o endereço de exemplo (https://marketplace.mirakl.net, ou o mesmo com /api), que o módulo não aceita como host real de um operador Mirakl.

Esquema feito com código, não um ecrã do Odoo: de cima para baixo, o menu das instâncias, o botão de testar a ligação, os campos de URL e a mensagem sobre marketplace.mirakl.net
Esquema a partir do código publicado do módulo (não é uma captura do Odoo) com o menu, o botão, os campos e a mensagem, para Odoo 17, 18, 19 e 20. As legendas do esquema são o texto original do código do módulo.

A mesma mensagem aparece no idioma do teu Odoo. O esquema seguinte mostra-a em castelhano, alemão, francês, italiano e português.

Esquema feito com código, não um ecrã do Odoo: a mesma mensagem sobre marketplace.mirakl.net em castelhano, alemão, francês, italiano e português
Esquema a partir das traduções publicadas do módulo (não é uma captura do Odoo): a mensagem tal como o utilizador a vê consoante o idioma do seu Odoo.
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)

Detalhes que não se veem na ficha

Pode aparecer ao clicar em Testar Ligação

O botão Testar Ligação (Test Connection) está na vista da instância e vê-se sempre, no Odoo 17, 18, 19 e 20. Ao clicar nele, o módulo chega à verificação da configuração da ligação e, se se cumprir a condição que se segue, lança este erro. As ffichas de Instâncias Mirakl (Mirakl Instances) abrem-se a partir do menu Mirakl › Configuração › Marketplaces.

O valor tem de ser igual a um endereço de exemplo

O módulo compara o valor de URL Base (Base Url) e o de URL Base da API (API Base URL) com alguns endereços concretos, e lança o erro se qualquer um dos dois coincidir exatamente:

  • URL Base é https://marketplace.mirakl.net ou http://marketplace.mirakl.net.
  • URL Base da API é https://marketplace.mirakl.net/api ou http://marketplace.mirakl.net/api.

Basta que um dos dois seja um desses endereços para o erro aparecer, mesmo que o outro esteja correto.

Um URL real que leva esse texto no interior não dá o erro

O módulo não procura o texto marketplace.mirakl.net dentro do campo: compara o valor completo com a lista acima. Um endereço como https://adeo-marketplace.mirakl.net termina nessas mesmas palavras, mas não é igual a nenhum endereço de exemplo, pelo que não ativa esta mensagem. Por isso não é preciso mexer num URL de operador que já esteja bem colocado.

As barras finais e o protocolo não mudam nada

Antes de comparar, o módulo remove as barras finais de cada endereço. Por isso https://marketplace.mirakl.net/ conta como o de exemplo, tal como o que não leva barra. Além disso, a lista de endereços de exemplo inclui tanto a versão com https como a versão com http, pelo que mudar o protocolo não contorna a verificação.

Não existe um host comum para todos os marketplaces

A ajuda de URL Base di-lo assim: Host real do operador Mirakl. O Mirakl não fornece um host universal partilhado por todos os marketplaces. Exemplo: https://adeo-marketplace.mirakl.net (preenchido automaticamente para operadores conhecidos; caso contrário, introduza-o a partir da sua conta de vendedor). Obrigatório antes de poder Testar Ligação ou sincronizar.

Ou seja: segundo essa ajuda, nos operadores conhecidos o campo preenche-se sozinho; nos restantes, o endereço és tu quem o introduz a partir da tua conta de vendedor, ou o obténs da documentação ou do suporte do operador, como indica a própria mensagem. E como a ajuda o marca como obrigatório antes de testar a ligação ou sincronizar, convém deixá-lo bem colocado desde o princípio.

O endereço da API tem a sua própria ajuda

A ajuda de URL Base da API diz: URL base real da API Mirakl para o operador selecionado. Normalmente é o Base Url + /api. Exemplo: https://adeo-marketplace.mirakl.net/api. Os dois campos estão na mesma ficha, no separador Ligação, grupo Acesso.

Como resolver

  1. Abre Mirakl › Configuração › Marketplaces e entra na ficha da instância.
  2. Vai ao separador Ligação e ao grupo Acesso: aí estão URL Base e URL Base da API.
  3. Vê qual dos dois é exatamente um dos endereços de exemplo da lista anterior (pode ser só um ou os dois). Deixa como estão os que já tenham o URL do teu operador.
  4. Em URL Base, se for o de exemplo, escreve o host real do teu operador. Para ADEO/Leroy, o exemplo da própria mensagem é https://adeo-marketplace.mirakl.net. Se o teu operador for outro, a mensagem remete para a documentação ou para o suporte do operador do marketplace, e a ajuda do campo, para a tua conta de vendedor.
  5. Em URL Base da API, se for o de exemplo, escreve o URL real da API do operador. Para ADEO/Leroy, o exemplo é https://adeo-marketplace.mirakl.net/api.
  6. Com os endereços alterados, clica de novo em Testar Ligação.

O que verificar depois

Confirma que nenhum dos dois endereços é já https://marketplace.mirakl.net nem https://marketplace.mirakl.net/api, com ou sem barra final e com https ou http. Confirma também que URL Base da API corresponde ao mesmo operador que URL Base, tal como indica a sua ajuda ao dar o exemplo de ADEO/Leroy. Se quiseres rever os restantes campos da instância, explicamo-los em os campos de Instância Mirakl.

Está em todas as versões publicadas

No Odoo 20.0, o módulo faz a verificação tal como se explica acima. A mensagem está no código publicado dos quatro ramos, 17.0, 18.0, 19.0 e 20.0, e o módulo está publicado no Odoo Apps para essas mesmas versões.

Se preferires que to configurem

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiseres que alguém deixe contigo a instância Mirakl ligada, vê a página do módulo ou a ficha no Odoo Apps.

Continue a ler

Checklist da instância do Mirakl Connector, campo a campoChecklist para preencher a instância do Mirakl Connector no Odoo: ligação, contas de liquidação e opções, com o que diz a ajuda de cada campo.Campos da Instância Mirakl no Mirakl Connector: o que significam e o que pôrGuia comparado dos campos da ficha Instâncias Mirakl no Mirakl Connector para Odoo: o que diz cada ajuda, o valor por defeito e o que preencher.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes