Saltar para o conteúdo principal
Mirakl

O que faz o botão «Obter motivos de reembolso» do Mirakl Connector

O botão Obter motivos de reembolso (Fetch Refund Reasons) pede ao Mirakl a lista de códigos de motivo do operador e deixa-a escrita no chatter da instância. Vê-se sempre no ecrã da instância, no Odoo 17, 18, 19 e 20. Aqui tem o que verifica, o que muda e que mensagens pode dar.

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 está o botão e quando se vê

Onde está o botão e como se chama?

Chega-se lá pelo menu Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces), que abre o ecrã Instâncias Mirakl (Mirakl Instances). O separador Mirakl do menu só é visível para os utilizadores internos do Odoo: se não for um, não vê esse separador. Com o Odoo em português o botão chama-se Obter motivos de reembolso; noutros idiomas o rótulo muda, como mostra o segundo esquema.

Esquema feito com código do menu Mirakl › Configuration › Marketplaces e do botão Fetch Refund Reasons, com as mensagens que o podem travar de um lado
Esquema feito com código a partir do código publicado do módulo (não é um ecrã do Odoo): o menu, o botão no Odoo 17, 18, 19 e 20, e as mensagens de um lado, com os rótulos em inglês do código original.
Esquema feito com código com o texto do botão em 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 é um ecrã do Odoo): em espanhol, o botão que o módulo chama Obtener motivos de reembolso na versão portuguesa; em alemão Erstattungsgründe abrufen, em francês Récupérer les motifs de remboursement, em italiano Recupera motivi di rimborso e em português Obter motivos de reembolso.

Quando aparece?

O botão vê-se sempre no ecrã Instâncias Mirakl, e existe no Odoo 17, 18, 19 e 20. Não depende de nenhum estado nem de nenhuma caixa da ficha.

Para que serve?

Segundo o próprio código do módulo, lista os códigos de motivo de reembolso do operador e publica-os no chatter da instância, para saber o que colocar em Código de motivo de reembolso. O mesmo código lembra que o Mirakl rejeita os reembolsos que não levam um código válido do operador.

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 faz ao carregar

O que faz passo a passo?

Trabalha com a instância que tem aberta. Primeiro pede ao Mirakl os motivos do operador. Depois fica com os motivos que lhe chegam e converte-os numa linha por motivo: código, etiqueta e, entre parênteses, o tipo (um hífen se o motivo não trouxer tipo). Por fim escreve uma nota no chatter e mostra um aviso.

Que motivos inclui a lista?

Primeiro filtra os motivos cujo tipo contém a palavra REFUND, sem distinguir maiúsculas de minúsculas. Se nenhum a contiver, publica todos os motivos que tenha recebido. Se não restar nenhum motivo para publicar, o botão pára com um erro (mais abaixo).

O que muda no Odoo no fim?

No chatter da instância aparece uma nota 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 as linhas, uma por motivo. Além disso surge um aviso intitulado Mirakl com o texto … códigos de motivo publicados no chatter. (… reason codes posted to the chatter.), onde as reticências são o número de linhas publicadas; o aviso não fica fixo no ecrã. Cada vez que carrega faz uma consulta nova e acrescenta outra nota, por isso pode voltar a carregar sempre que quiser atualizar a lista.

Como verifico que funcionou?

Abra o chatter da instância: lá fica a nota com uma linha por motivo. Essa linha leva o código, que é o que o próprio código do módulo indica usar em Código de motivo de reembolso.

Erros e requisitos

O que acontece se o operador não devolver códigos?

A ação pára com a mensagem 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.) Não se publica nenhuma nota. O que há a fazer é o que diz a própria mensagem: consultar os códigos no seu portal de vendedor do marketplace.

E se falhar a ligação ao Mirakl?

Ao carregar no botão podem aparecer Erro de ligação ao chamar o Mirakl: … (Connection error calling Mirakl: …) e O pedido Mirakl falhou após novas tentativas. (Mirakl request failed after retries.) Estas mensagens vêm do pedido ao Mirakl, que o módulo repete perante algumas respostas temporárias do servidor antes de desistir. Nesse caso a ação pára antes de escrever a nota no chatter. Como cada vez que carrega faz uma consulta nova, pode voltar a carregar no botão.

Quanto custa e o que precisa?

O Mirakl Connector é um módulo de pagamento único por versão, publicado no Odoo Apps para Odoo 17, 18, 19 e 20; o preço de cada versão está na sua ficha e a compra direta, na página do módulo. Além disso precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma (o plano Pro, 98 €/mês ou 980 €/ano, até 10). A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais e avisa por e-mail se a sincronização falhar. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição oferece; os dados ficam no seu Odoo.

Outras chamadas ao Mirakl e como o ajudamos

Este botão é a consulta de motivos de reembolso. O módulo também chama o Mirakl noutros momentos, com outros pedidos: ao validar uma guia de remessa pode chamar o Mirakl para ler a encomenda ou enviar o acompanhamento, e a tarefa agendada Mirakl - Sincronizar Encomendas (Mirakl - Sync Orders) corre a cada dez minutos e está ativa ao instalar.

Se está a implementar o Odoo e quer ligar um marketplace Mirakl, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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