Saltar para o conteúdo principal
Mirakl

Mirakl Connector: «Defina a chave de API do Mirakl antes de testar a ligação»

Surge ao clicar em Testar Ligação quando a instância Mirakl não se liga através do FlexigoTech Cloud e a sua chave de API está vazia ou só com espaços. Resolve-se guardando a chave que a Mirakl lhe dá na sua conta de vendedor (Definições > Chave de API) e testando de novo.

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

Quando surge e o que diz

Que mensagem vê e quando aparece?

Com o Odoo em português de Portugal vê Defina a chave de API do Mirakl antes de testar a ligação. Encontra-la-á na sua conta de vendedor Mirakl (Definições > Chave de API). (Set the Mirakl API key before testing the connection. You will find it in your Mirakl seller account (Settings > API key).) Aparece ao clicar em Testar Ligação (Test Connection) na ficha de Instâncias Mirakl (Mirakl Instances), que abre a partir de Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces). O botão vê-se sempre no Odoo 17, 18, 19 e 20.

Esquema com o menu Mirakl, Configuração, Marketplaces, o botão Testar Ligação, o campo Ligação à Mirakl e a mensagem da chave de API, com os rótulos em inglês
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: menu, botão, campo e mensagem, com os rótulos em inglês do código.

O que acontece à ação quando surge?

Pára. É um erro que interrompe o que ia fazer com o botão: o teste de ligação não avança.

Qual é a condição exata?

O módulo verifica duas coisas em simultâneo, e a mensagem só surge se ambas se cumprirem. A primeira: que o campo Ligação à Mirakl (Mirakl connection) não tenha o valor FlexigoTech Cloud, ou seja, que seja Direta (chave de API guardada no Odoo) (Direct (API key stored in Odoo)). A segunda: que a chave de API guardada nessa instância esteja vazia. Antes de ver se está vazia, o código remove os espaços das extremidades, pelo que uma chave escrita só com espaços conta como vazia. Esta é a condição do código do Odoo 20.

Porque é que não me surge num marketplace ligado através do FlexigoTech Cloud?

Porque com essa ligação a verificação não é feita no Odoo. Segundo o código, a chave vive no relé do FlexigoTech Cloud e não aqui, e é esse relé que avisa se falta. A ajuda do campo Ligação à Mirakl diz que os marketplaces novos se ligam através do FlexigoTech Cloud e que a ligação direta só se mantém para os marketplaces que já existiam antes desta versão, que continuam a funcionar tal como foram comprados. O valor por defeito do campo no código é FlexigoTech Cloud.

Como verifico que ligação tem o meu marketplace?

Abra a ficha do marketplace, vá ao separador Ligação (Connection) e veja o grupo Acesso (Access): aí está Ligação à Mirakl, só de leitura, pelo que não se altera a partir desse ecrã. Se indicar Direta (chave de API guardada no Odoo), esse marketplace é dos que podem dar esta mensagem. Se indicar FlexigoTech Cloud, a condição não se cumpre e a mensagem não surge nessa instância.

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

Como resolver

O que faço para que desapareça?

Entre na sua conta de vendedor da Mirakl e copie a chave que aparece em Ajustes > Clave de API, que é precisamente para onde a própria mensagem o encaminha. Deixe-a guardada na instância do Odoo que está a testar e clique de novo em Testar Ligação. A condição do código é que essa chave não esteja vazia: quando deixa de se cumprir, a mensagem não volta a surgir.

E se acho que já a guardei?

Há duas coisas a verificar. A primeira: que está na ficha do marketplace que está a testar, porque a verificação é feita sobre a chave dessa instância e não sobre a de outro marketplace. A segunda: que o que guardou não sejam só espaços, porque conta como vazio. Com FlexigoTech Cloud em Ligação à Mirakl, esta mensagem não pode vir da chave dessa instância.

Que a mensagem desapareça significa que a chave funciona?

Não. Esta verificação só olha se há algo escrito na chave, não se está correta. É a primeira verificação da configuração: se a passar, o módulo verifica depois os URL do operador da Mirakl. Como é o botão de princípio a fim conta-se em O que faz o botão Testar Ligação.

Tenho algo a fazer se o meu marketplace se liga através do FlexigoTech Cloud?

Para esta mensagem, não: com essa ligação o módulo não verifica a chave no Odoo, e é o relé do FlexigoTech Cloud que avisa se falta. Por isso, se lhe surgir, verifique primeiro no separador Ligação, grupo Acesso, que Ligação à Mirakl indica Direta (chave de API guardada no Odoo).

Versões e ajuda

É igual no Odoo 17, 18, 19 e 20?

A mensagem está no código publicado dos quatro ramos, e o botão Testar Ligação vê-se sempre em todos. O módulo está publicado no Odoo Apps para essas quatro versões (ficha no Odoo Apps). A condição que leu acima é a do código do Odoo 20.

Onde se vê cada coisa, de relance?

O menu é Mirakl › Configuração › Marketplaces. O botão Testar Ligação está na ficha de Instâncias Mirakl. O campo Ligação à Mirakl está no separador Ligação, grupo Acesso, só de leitura. Se não vê o troço Mirakl do menu, falta-lhe a permissão que esse troço pede.

Como ajuda a FlexigoTech

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Para os marketplaces que se ligam através do FlexigoTech Cloud, o serviço guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Se está a montar o conector e quer que revejamos a configuração consigo, tem a página do módulo.

Continue a ler

Mirakl Connector: «Esta ligação não tem nenhuma instância Mirakl configurada.»Quando aparece no Mirakl Connector o aviso de ligação sem instância Mirakl configurada, que condição o provoca e o que fazer quando surge.O que faz o botão Testar Ligação do Mirakl Connector, passo a passoO que faz o botão Testar Ligação do Mirakl Connector no Odoo: quando aparece, o que verifica, o que guarda na ficha e que erros pode dar.O que faz o botão Importar Encomendas do Mirakl ConnectorO que faz o botão Importar Encomendas do Mirakl Connector: quando aparece, o que acontece ao carregar, que avisos dá e o que verificar antes e depois.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes