Saltar para o conteúdo principal
Mirakl

Importar Mensagens no Mirakl Connector: o que faz o botão passo a passo

O botão Importar Mensagens (Import Messages) pede ao marketplace as mensagens da instância, processa-as e conta-te o resultado com um aviso de sucesso ou de advertência. Vê-se sempre no ecrã Instâncias Mirakl, e a tarefa agendada faz uma importação semelhante a cada 30 minutos se a ativares.

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

O que é o botão e quando o vês

O botão Importar Mensagens está no ecrã Instâncias Mirakl (Mirakl Instances), que se abre a partir do menu Mirakl › Configuração › Marketplaces. Vê-se sempre, no Odoo 17, 18, 19 e 20: nenhuma condição da vista o esconde. Trabalha sobre a instância que tens aberta.

Esquema feito com código do menu Mirakl › Configuration › Marketplaces e do botão Import Messages, com os rótulos em inglês
Esquema feito com código (não é uma captura do Odoo): o menu e o botão, com os rótulos em inglês do texto original do módulo. O botão existe nas quatro versões publicadas.

O rótulo do botão muda conforme o idioma do teu Odoo: com o Odoo em castelhano é Importar mensajes; em alemão, Nachrichten importieren; em francês, Importer les messages; em italiano, Importa messaggi; em português, Importar Mensagens.

Esquema feito com código a partir dos ficheiros de tradução do módulo, com o rótulo do botão em castelhano, alemão, francês, italiano e português
Esquema feito com código (não é uma captura do Odoo): o rótulo do botão Import Messages conforme o idioma do Odoo.

Se ainda não verificaste que a ligação ao marketplace funciona, o artigo sobre o botão Testar ligação explica o que faz esse outro botã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)

Passo a passo

  1. Deixa que o Odoo o faça sozinho. A tarefa agendada Mirakl - Sincronizar Mensagens (Mirakl - Sync Messages) lança a importação de mensagens a cada 30 minutos, mas vem desativada ao instalar. Percorre as instâncias ativas que têm a sincronização de mensagens ativada, e só um administrador a pode executar. Esse é o caminho normal; o botão serve para lançar a importação manualmente.
  2. Abre a instância. Entra em Mirakl › Configuração › Marketplaces e abre a ficha da instância.
  3. Revê a janela de dias. No separador Faturas e Mensagens (Invoices and Messages), grupo Mensagens (Messages), está Dias de Sincronização Inicial de Mensagens (Initial Message Sync Days). A sua ajuda diz: «Janela histórica (dias) para sincronização manual de mensagens.» O valor por defeito é 30. O botão passa esse valor à importação.
  4. Carrega em Importar Mensagens. O módulo consulta o marketplace (detalhe na secção seguinte) e, quando termina, deixa um aviso.
  5. Lê o aviso. Com mensagens processadas verás uma notificação de sucesso: Importação de Mensagens concluída: … mensagens processadas. (em vez das reticências, a quantidade). Se não se processou nenhuma, uma de advertência: Importação de Mensagens concluída: 0 registos. O operador pode não suportar este endpoint.
  6. Se aparecer a advertência, olha para o campo só de leitura. No mesmo separador e grupo, Endpoint de Mensagens Indisponível (Messages Endpoint Unavailable) diz-te se o módulo marcou que o marketplace não expõe /messages.

O que faz o botão por dentro, por ordem

  • Passa por cima do campo Endpoint de Mensagens Indisponível. Com o botão, o módulo faz a consulta mesmo que esse campo esteja marcado. A tarefa agendada, pelo contrário, salta o endpoint até que se tente de novo manualmente, como diz a ajuda do campo.
  • Lê por páginas. Pede as mensagens com um pedido de leitura ao endpoint /messages (ou ao que a instância tenha indicado), página a página, com um limite de páginas definido pela própria instância.
  • Processa cada mensagem. Cada mensagem recebida passa pelo modelo de mensagens do Mirakl, e o módulo soma um por cada registo que resulta. Essa contagem é a que vês no aviso.
  • Limpa a marca se a leitura correr bem. Se um pedido tem sucesso e Endpoint de Mensagens Indisponível estava marcado, o módulo esvazia-o. Por isso carregar no botão é a forma de tentar de novo.
  • Deixa registo e avisa. Publica o mesmo texto do aviso como mensagem na própria instância e mostra uma notificação com o título Mirakl. Não é um aviso fixo no ecrã.

Erros e avisos que pode dar

O botão não mostra os erros de leitura como uma mensagem de erro: regista-os no log da API do Mirakl e termina com o aviso de «0 registos» se não se processou nada. Por isso essa advertência não prova por si só que algo falhe: também aparece se o marketplace não tinha mensagens para devolver.

SituaçãoO que aconteceO que fazer
Processam-se mensagensAviso de sucesso com a quantidadeNada: verifica as mensagens importadas
O marketplace responde 410 ou 404O módulo marca Endpoint de Mensagens Indisponível, regista um aviso no log e pára; o aviso no ecrã conta o processado até esse momentoSe for 0, o operador pode não expor /messages; revê o campo e volta a carregar apenas se algo tiver mudado
Outro erro do pedidoRegista-se um erro no log e deixa-se de ler; conta-se o que já foi processadoRevê o log da API e volta a carregar
Resposta com uma forma que o conector não reconheceNão se toma por uma página vazia: regista-se um erro e deixa-se de lerGuarda o conteúdo registado no log e consulta a FlexigoTech
O FlexigoTech Cloud não deixa passar a chamada (sem subscrição ou serviço em pausa)A importação é cortada, não se marca nada e não se chega ao aviso de concluídoRevê a tua subscrição do plano Conector

Botão ou tarefa agendada

Botão Importar MensagensTarefa Mirakl - Sincronizar Mensagens
Quando correQuando o carregasA cada 30 minutos, se a ativares (vem desativada)
Com o endpoint marcado como indisponívelConsulta na mesmaOmite-o até que se tente de novo manualmente

O que precisas e como a FlexigoTech te ajuda

O Mirakl Connector é um módulo de pagamento único por versão, publicado no Odoo Apps para 17, 18, 19 e 20 (ficha, página do módulo), e precisa da subscrição do FlexigoTech Cloud com o plano Conector: 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma. Sem subscrição, ou com o serviço suspenso, pára o que a subscrição proporciona; os dados ficam no teu Odoo.

Se estás a implementar o Odoo e queres que o conector fique afinado com os teus marketplaces, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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