Saltar para o conteúdo principal
Mirakl

Mirakl Connector: «Esta ligação não tem nenhuma instância Mirakl configurada.»

A mensagem Esta ligação não tem nenhuma instância Mirakl configurada. (This binding has no Mirakl instance configured.) aparece ao clicar em Pesquisar (Search) na pesquisa de categorias Mirakl quando o campo Instância (Instance) está vazio; a ação para antes de pesquisar o que quer que seja, e repetir a pesquisa com o campo vazio dá o mesmo resultado.

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

Onde aparece e o que significa

A janela de pesquisa de categorias Mirakl chama-se Pesquisar Categoria Mirakl (Search Mirakl Category) quando o módulo a volta a abrir depois de uma pesquisa. Nela está o botão Pesquisar, que, segundo o código publicado, se vê sempre, no Odoo 17, 18, 19 e 20. Como o botão se vê sempre, podes clicar nele com o campo Instância vazio, e é nessa altura que surge a mensagem.

Esquema feito com código do botão Search, do campo Instance e da mensagem This binding has no Mirakl instance configured.
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: o botão e o campo e, por baixo, a mensagem, com as etiquetas em inglês do código original (Odoo 17, 18, 19 e 20).

O que significa: a janela não tem nenhuma instância Mirakl associada. A pesquisa trabalha a partir dessa instância, tanto quando procura entre as categorias já sincronizadas como quando consulta o Mirakl, e sem ela a ação para. O campo Instância vê-se na janela, mas só de leitura: não se corrige escrevendo aí.

O mesmo texto pode também surgir a partir do método de exportação do catálogo da ligação.

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)

A condição exata, por palavras

No código do Odoo 20.0, a primeira coisa que a pesquisa faz é verificar que trabalha com um único registo e, logo a seguir, ver se Instância está vazio. Se estiver, lança a mensagem e a ação para. Por isso, quando a vês:

  • Não se pesquisou entre as categorias sincronizadas.
  • Não se consultou o Mirakl.
  • Não se guardou nada do que a pesquisa ia escrever na janela.

A condição é só essa: instância vazia. A mensagem está no código publicado de 17.0, 18.0, 19.0 e 20.0; a verificação descrita é a do código do Odoo 20.0.

Esquema feito com código com a mensagem de falta de instância em castelhano, 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.

Com o Odoo em castelhano vês o texto de cima; noutros idiomas publicados, estes:

IdiomaTexto
CastelhanoEste vínculo no tiene ninguna instancia de Mirakl configurada.
AlemãoFür diese Verknüpfung ist keine Mirakl-Instanz konfiguriert.
FrancêsCette liaison n'a aucune instance Mirakl configurée.
ItalianoQuesto collegamento non ha alcuna istanza Mirakl configurata.
PortuguêsEsta ligação não tem nenhuma instância Mirakl configurada.

Caso: uma pesquisa de categoria que não arranca

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

Imagina a Lúcia, responsável de catálogo na Hogar Ribera, uma empresa inventada que está a preparar o seu catálogo para um marketplace Mirakl. Abre a janela de pesquisa de categorias a partir de uma ligação e clica em Pesquisar. Em vez de resultados, o Odoo mostra Esta ligação não tem nenhuma instância Mirakl configurada. e a janela fica como estava.

Repara na janela: Instância está vazio e é só de leitura, pelo que não há nada para escrever aí. Clica em Pesquisar uma segunda vez, por se ter tratado de algo pontual, e a mensagem é a mesma, porque a condição continua a cumprir-se.

A Lúcia percebe então o que a mensagem lhe está a dizer: a pesquisa nem chegou a começar, e o que falta não se resolve a partir dessa janela. Fecha a janela, anota em que ligação estava e pede que revejam a configuração dessa ligação a quem administra o seu Odoo ou à FlexigoTech.

O que aprender com o caso: a mensagem é uma verificação prévia, não o resultado de uma pesquisa que não encontrou nada, e não se resolve repetindo o clique.

O que fazer quando aparece

  1. Fecha a janela de pesquisa. Desse clique não se guardou nada.
  2. Volta a abri-la e vê o campo Instância: se estiver vazio, essa é a causa.
  3. Não tentes preenchê-lo na janela: o campo é só de leitura. Enquanto continuar vazio, Pesquisar dará a mesma mensagem.
  4. Pede que revejam a configuração da ligação a partir da qual abriste a pesquisa, a quem administra o teu Odoo ou à FlexigoTech.
  5. Quando Instância já não estiver vazio, abre a pesquisa de novo e clica em Pesquisar. Se aparecer outra mensagem, é outra causa distinta.

O que faz a pesquisa quando há instância

Passada a verificação, o módulo procura primeiro entre as categorias Mirakl que já estão sincronizadas com essa instância. Se encontrar correspondências, preenche a lista de resultados da janela e volta a abri-la. Se não encontrar nenhuma, consulta o Mirakl através da instância e a janela abre-se de novo com os resultados ou com um texto que conta o que aconteceu.

Essa consulta ao Mirakl passa pelo FlexigoTech Cloud. Se o serviço não deixar passar o pedido (sem subscrição ou com uma pausa do serviço), a pesquisa é interrompida e não se marca nada. É uma situação distinta da desta mensagem.

Versões e custo

O Mirakl Connector está publicado no Odoo Apps para Odoo 17, 18, 19 e 20 (ficha). É um módulo de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA (o plano Pro é de 98 €/mês ou 980 €/ano). Com a subscrição, o módulo para as versões novas do Odoo vem incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão compra-se lá. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá, e os dados ficam no teu Odoo. Mais detalhes na página do módulo.

Como pode a FlexigoTech ajudar-te

Se estás a implementar o Odoo e queres rever a configuração do Mirakl desde o princípio, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Conta-nos o que está a falhar e vemos contigo.

Continue a ler

Mirakl Connector: «Defina a chave de API do Mirakl antes de testar a ligação»Quando surge o erro de chave de API vazia no Mirakl Connector para Odoo, que condição o provoca e como o resolver ao clicar em Testar Ligação.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