Saltar para o conteúdo principal
Mirakl

Mirakl Connector: «Recusado o contacto com …», quando aparece e como se resolve

Aparece ao clicar em Importar Encomendas ou Importar Devoluções quando o endereço que o módulo vai contactar não tem o mesmo esquema e servidor que a API Base URL da instância, ou quando esse URL base está vazio ou sem servidor. Resolve-se revendo a API Base URL da instância; a mensagem pede ainda que o endpoint seja um caminho, por exemplo /orders.

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
4 min

Quando aparece e o que diz

Em que momento aparece a mensagem?

Ao clicar em Importar Encomendas (Import Orders) ou Importar Devoluções (Import Returns) na vista da instância da Mirakl. Ambos os botões chegam à mesma verificação e, se a condição se cumprir, lançam este texto: «Recusado o contacto com …: a chave de API da Mirakl de … só vai para o seu URL Base da API (…). Escreva o endpoint como um caminho, por exemplo /orders.» (Refusing to contact …: the Mirakl API key of … only goes to its API Base URL (…). Write the endpoint as a path, such as /orders.). Os dois botões vêem-se sempre, no Odoo 17, 18, 19 e 20.

Esquema feito com código: os botões Import Orders e Import Returns e, por baixo, a mensagem de recusa
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: os botões que levam à verificação e a mensagem que lança.

O que são os espaços com reticências?

São valores que o módulo preenche ao lançar a mensagem: primeiro o endereço que ia contactar, depois o nome da instância cuja chave ia usar e, no fim, o URL base da API dessa instância. Se o URL base estiver vazio, aparece em seu lugar um hífen (-). As traduções publicadas do módulo trazem este mesmo texto em castelhano, alemão, francês, italiano e português, como mostra o esquema.

Esquema feito com código com a mensagem de recusa 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: a mesma mensagem em cada idioma.
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)

O que verifica o código

Com que condição exata é lançada?

No código do Odoo 20, o módulo compara dois endereços: a API Base URL da instância (sem a barra final, se a tiver) e o endereço que vai contactar. De cada um olha apenas para o esquema (http ou https) e para o servidor, sem distinguir maiúsculas no servidor; o caminho não conta. Se coincidirem e o URL base tiver servidor, a verificação passa. Em qualquer outro caso é lançada a mensagem: esquema diferente, servidor diferente, um URL base vazio ou sem servidor, ou um endereço a contactar vazio.

Porque se recusa o módulo a contactar?

Porque a chave de API da Mirakl só deve ir para o servidor de API do próprio marketplace. O comentário do código explica-o: um endereço absoluto escrito como endpoint é usado tal qual, e os campos de endpoint da instância podem ser escritos por qualquer Mirakl User, que não pode ler a chave. Se um endpoint apontasse para outro servidor, ter-lhe-ia entregado a chave na sincronização seguinte. A verificação fecha esse caminho.

O que acontece ao que a ação estava a fazer?

Pára: a mensagem corta a ação nesse ponto e não se contacta esse endereço.

Como se resolve

O que faço passo a passo?

Lê a mensagem e compara o primeiro endereço que aparece com o URL base da API que vem entre parênteses no fim. Se em vez do URL base aparecer um hífen, está vazio: preenche a API Base URL da instância. Se estiver preenchido mas não corresponder ao servidor de API do marketplace, corrige-o, porque é para esse servidor que vai a chave. Depois volta a clicar no mesmo botão e, para confirmar, clica também no outro: se a mensagem já não aparecer, a verificação passou. Se o URL base estiver correto e a mensagem continuar a aparecer com um endereço de outro servidor, a mensagem pede que o endpoint seja escrito como um caminho, por exemplo /orders: escreve-nos com o texto completo da mensagem e revemos. Para saber o que significa cada campo da instância, consulta os campos de Instância da Mirakl.

Uma morada completa é recusada se for do mesmo servidor?

Segundo o código do Odoo 20, a verificação passa quando o esquema e o servidor do endereço coincidem com os do URL base, pelo que um endereço completo do mesmo servidor não é recusado neste ponto. A mensagem, isso sim, pede que o endpoint seja escrito como um caminho, por exemplo /orders.

Muda entre versões do Odoo?

A mensagem está no código publicado do Odoo 17, 18, 19 e 20; a verificação aqui descrita é a do código do Odoo 20.

O que preciso para usar o módulo?

É um módulo de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud. O plano Conector custa 49 €/mês ou 490 €/ano, sem IVA, para até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas. O módulo está publicado no Odoo Apps para Odoo 17, 18, 19 e 20; o preço de cada versão está na ficha do Odoo Apps e na página do módulo.

Se precisar de ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se, depois de rever a API Base URL, a mensagem continuar a aparecer, escreva-nos com o texto completo da mensagem e a versão do Odoo que utiliza.

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