Saltar para o conteúdo principal
Mirakl

A tarefa «Mirakl - Sincronizar Encomendas»: o que faz e o que verificar se não faz nada

Mirakl - Sincronizar Encomendas (Mirakl - Sync Orders) corre a cada 10 minutos desde que instalas o Mirakl Connector e, em cada passagem, importa as encomendas de cada marketplace que lhe cabe e revê as que continuam abertas. Se não faz nada, há poucas condições que a deixam de fora: quem a lança, que marketplaces entram, o intervalo próprio de cada um e a ligação ao FlexigoTech Cloud.

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 17.0 e 20.0 · nas fontes indicadas no fim
Leitura
5 min

O que faz a tarefa em cada passagem

Esquema feito com código: em cima a tarefa agendada de sincronizar encomendas, que corre a cada 10 minutos e vem ativa ao instalar, e por baixo o menu dos marketplaces, com os rótulos em inglês
Esquema feito com código a partir do código publicado do módulo, não um ecrã do Odoo: a tarefa a cada 10 minutos, ativa ao instalar (Odoo 17, 18, 19 e 20), e o menu dos marketplaces.

O que faz Mirakl - Sincronizar Encomendas em cada passagem?

Segundo o código do Odoo 20.0, uma passagem segue esta ordem. Primeiro verifica que quem a executa é administrador. Depois seleciona os marketplaces ativos que têm a sincronização de encomendas ativada e fica com os que consegue chamar (mais abaixo, quais ficam de fora). Para cada um que lhe cabe segundo o seu intervalo, importa as encomendas e, a seguir, revê as encomendas abertas que já estão no Odoo. Com isso passa ao marketplace seguinte.

De quanto em quanto tempo corre e como se chama no meu Odoo?

Corre a cada 10 minutos e vem ativa ao instalar o módulo. Está em todas as ramificações publicadas (Odoo 17, 18, 19 e 20) e no Odoo 17.0 repete-se sem fim. Com o Odoo em português de Portugal chama-se Mirakl - Sincronizar Encomendas; o esquema seguinte mostra o seu nome noutros idiomas.

Esquema feito com código com o nome da tarefa consoante o idioma: em castelhano Mirakl - Sincronizar pedidos, em alemão Mirakl - Bestellungen synchronisieren, em francês Mirakl - Synchroniser les commandes, em italiano Mirakl - Sincronizza ordini e em português Mirakl - Sincronizar Encomendas
Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: o nome da tarefa em castelhano, alemão, francês, italiano e português.

Importa todos os marketplaces em cada passagem?

Não necessariamente: depende do intervalo próprio de cada marketplace. Se não tiver intervalo (é o valor por omissão), importa em cada passagem, ou seja, a cada 10 minutos. Se tiver intervalo e já existir uma sincronização de encomendas anterior, o marketplace espera que passe esse tempo desde a última; se ainda não existir nenhuma, importa. A tarefa continua a acordar a cada 10 minutos, mas esse marketplace salta as passagens até lhe chegar a vez.

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 lê do Mirakl e o que revê depois

O que pede ao Mirakl ao importar encomendas e quando deixa de pedir?

Pede as encomendas por páginas, com um tamanho de página e um máximo de páginas por passagem, a partir de um ponto de partida temporal. Cada encomenda é guardada em separado: se uma falhar, fica uma entrada de registo de nível erro com a referência da encomenda e a passagem continua com as restantes. Deixa de pedir quando uma página traz menos encomendas do que o tamanho de página ou quando já leu o total indicado pela resposta; se se esgotar o máximo de páginas, regista uma entrada de nível aviso. E se uma página chega sem encomendas e o conector não reconhece a forma da resposta, não a trata como uma página vazia: regista um erro e deixa de pedir páginas.

Para que serve a revisão de encomendas abertas?

A importação incremental só olha para uma janela de tempo recente. Por isso, depois de importar, a tarefa relê as encomendas que já estão no Odoo e ainda não terminaram: assim, uma mudança de estado feita no marketplace muito depois de a encomenda ser criada chega ao Odoo. Só é executada se essa revisão estiver ativada no marketplace; caso contrário, não faz nada. Lê as encomendas por lotes: se um lote falhar, regista-o no log do servidor e tenta encomenda a encomenda. Ao terminar cada lote, marca todas as suas encomendas com a data da revisão, mesmo as que o marketplace não devolveu, para que uma encomenda em falta não bloqueie a rotação das restantes.

O que verificar se não faz nada

Porque aparece Só um administrador pode executar esta ação agendada.?

A primeira coisa que a tarefa faz é verificar que quem a executa é administrador. Se não for, para com essa mensagem e não processa nenhum marketplace.

Que marketplaces deixa de fora uma passagem?

Os que não estão ativos ou não têm a sincronização de encomendas ativada. Entre os que restam, vão primeiro os que não passam pelo FlexigoTech Cloud; os que passam só são chamados se tiverem uma chave guardada, porque sem ela o serviço rejeitá-los-ia, e se a permissão guardada no teu Odoo não incluir o serviço do módulo, nenhum dos que passam pelo FlexigoTech Cloud é chamado (essa verificação não usa a rede). Por fim, os que têm intervalo próprio saltam a passagem até lhes chegar a vez. As ffichas dos marketplaces abrem-se em Mirakl › Configuração › Marketplaces.

O que acontece se um marketplace der erro ou o FlexigoTech Cloud pausar a ligação?

Há dois caminhos. Se um marketplace falhar com um erro, este é escrito no log do servidor, guarda-se uma entrada de registo de nível erro com a mensagem do erro e a tarefa segue para o marketplace seguinte; como a revisão de encomendas abertas vem depois da importação dentro do mesmo bloco, esse marketplace não chega a ela nessa passagem. Se, pelo contrário, o FlexigoTech Cloud pausar a ligação, a tarefa deixa de percorrer marketplaces nessa passagem e a seguinte continua; os marketplaces diretos vão primeiro para que nenhum fique para trás. A pausa só conta no relatório de saúde do FlexigoTech Cloud, com códigos e nunca texto. Se a pausa chegar durante a revisão de encomendas abertas, o lote que estava a ser lido não é marcado; os lotes já terminados mantêm a sua data de revisão.

Preciso da subscrição do FlexigoTech Cloud?

Sim. O Mirakl Connector é de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA, até 3 contas da plataforma. Está publicado para Odoo 17, 18, 19 e 20; o preço de cada versão está na ficha e na página do módulo. A ligação passa pelo FlexigoTech Cloud: guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. 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 rever com alguém como fica esta sincronização, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

O erro «Lance a fatura antes de a enviar para o Mirakl.» no Mirakl ConnectorQuando aparece o erro «Lance a fatura antes de a enviar para o Mirakl.» no Mirakl Connector para Odoo, o que o código verifica e como o resolver.A tarefa «Mirakl - Aceitar Encomendas», passagem a passagemO que faz em cada passagem a tarefa agendada Mirakl - Aceitar Encomendas do Mirakl Connector para Odoo, de quanto em quanto tempo corre e o que rever se não…O que faz o botão «Cancelar no Mirakl» do Mirakl Connector, passo a passoO que faz o botão Cancelar no Mirakl do Mirakl Connector para Odoo: quando aparece, o que verifica, o que muda na encomenda e que erros pode dar.
Verificado no código do conector (versão 17.0 e 20.0) e nas fontes indicadas

Fontes