Saltar para o conteúdo principal
Mirakl

Mirakl Connector: o operador não devolve códigos de motivo

O aviso aparece ao clicar em Obter motivos de reembolso na ficha do marketplace quando, depois de ler a resposta do operador, não resta nenhum motivo para publicar. Significa que o módulo não tem códigos para lhe mostrar e resolve-se consultando-os no portal de vendedor do marketplace, tal como diz a própria mensagem.

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

Onde aparece e o que o provoca

Abre a ficha a partir do menu Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces) e clica em Obter motivos de reembolso (Fetch Refund Reasons). Se não restar nenhum motivo para publicar, o Odoo interrompe a ação e mostra O operador não devolveu nenhum código de motivo. Consulte os códigos no seu portal de vendedor do marketplace. (The operator returned no reason codes. Check the codes in your marketplace seller portal instead.).

Esquema com três rótulos de cima para baixo: o menu de Marketplaces, o botão de motivos de reembolso e a mensagem de erro, com os textos originais em inglês do módulo
Esquema feito com código a partir do código publicado do módulo, não é um ecrã do Odoo: do menu ao botão e à mensagem, no Odoo 17, 18, 19 e 20.

Estes são os detalhes práticos que convém conhecer antes de o dar como uma falha da ligação.

O botão está sempre visível e o aviso aparece ao clicar

No Odoo 17, 18, 19 e 20, o botão Obter motivos de reembolso está sempre visível na ficha, sem condições. O aviso é dos que interrompem a ação: aparece ao clicar no botão e, como a ação é cortada aí, não se publica nada no chatter da ficha.

A condição é que a lista final fique vazia

Ao clicar, o módulo pede ao operador a sua lista de motivos. Primeiro fica com os motivos cujo tipo contém a palavra REFUND, sem distinguir maiúsculas de minúsculas. Se nenhum cumprir isso, fica com todos os motivos recebidos. Só se, depois dessa filtragem, não restar nada é que o aviso é lançado. No código, a condição é literalmente que essa lista esteja vazia.

Não haver motivos de reembolso não basta para o erro

Se o operador devolver motivos mas nenhum for do tipo reembolso, o aviso não aparece: o módulo publica todos os que tiver recebido. Por isso, se vir no chatter códigos que não parecem de reembolso, o que aconteceu foi que o operador não devolveu nenhum desse tipo e o módulo recorreu à lista completa.

Uma resposta com outra forma também conta como vazia

O módulo lê a resposta à procura de um bloco de dados que contenha uma lista de motivos. Se esse bloco ou essa lista não tiverem a forma esperada, são tomados como vazios. As entradas da lista que não sejam registos são ignoradas. O resultado é o mesmo aviso, pelo que a mensagem não lhe diz se o operador não tem códigos para si ou se a resposta chegou com outra estrutura. Se tiver dúvidas sobre a ligação, tem à parte o que faz o botão Test Connection.

O que acontece quando há códigos

Se a lista tiver conteúdo, o módulo publica no chatter da ficha uma mensagem que começa por Códigos de motivo del operador (usa el CÓDIGO en 'Código de motivo de reembolso'): (Operator reason codes (use the CODE in 'Refund Reason Code'):) e continua com uma linha por código: o código, a sua etiqueta e o tipo entre parênteses, com um hífen se o tipo vier vazio.

Além disso, o Odoo mostra uma notificação intitulada Mirakl com o texto … códigos de motivo publicados no chatter. (… reason codes posted to the chatter.), onde o módulo coloca o número de códigos. A notificação não fica fixa no ecrã.

O que fazer quando aparece

Faça o que a mensagem pede: abra o portal de vendedor do seu marketplace e consulte aí os códigos de motivo do operador. Segundo o próprio código do módulo, o botão existe para que saiba que código usar como motivo de reembolso, porque o Mirakl rejeita os reembolsos sem um código válido do operador. Enquanto não tiver a lista no chatter, o portal é a sua fonte.

Depois, o botão continua visível, pelo que pode voltar a clicar nele sempre que quiser verificar se o operador já devolve a lista. Se a resposta incluir motivos, verá-os publicados no chatter da ficha e poderá copiar daí o código.

É o mesmo aviso nas quatro versões publicadas

A mensagem está no código do Odoo 17, 18, 19 e 20, e o módulo está publicado no Odoo Apps para essas quatro versões. O segundo esquema reúne o mesmo texto em castelhano, alemão, francês, italiano e português.

Esquema com a mesma mensagem de erro escrita 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 é um ecrã do 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)

Se precisar de ajuda com o conector

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiser ver o módulo, tem a sua ficha no Odoo Apps e a sua página em flexigotech.com.

Se o aviso se repetir e não tiver claro se o problema está nos códigos do operador ou na resposta que chega ao Odoo, diga-nos que marketplace utiliza e o que vê no chatter da ficha, e revemos consigo.

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.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.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes