Saltar para o conteúdo principal
Mirakl

O que faz o botão «Enviar Seguimento Mirakl», passo a passo

O botão Enviar Seguimento Mirakl (Push Mirakl Tracking) está na guia de remessa de uma encomenda Mirakl que já está em Concluído (Done) e comunica ao Mirakl o número de seguimento da transportadora. Antes de enviar, o módulo verifica o estado, a ligação à encomenda Mirakl, o número de seguimento e a instância; se uma dessas verificações falhar, a ação pára antes de tentar o envio. Com a definição adequada da instância, o Odoo faz esse mesmo envio sozinho ao validar a entrega.

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

Quando aparece o botão na guia de remessa

O botão está na guia de remessa (movimento de Inventário) e existe nos ramos 17.0, 18.0, 19.0 e 20.0 do módulo. Fica oculto quando a guia de remessa não é de uma encomenda Mirakl ou quando o seu estado não é Concluído. Dito pela positiva: só o vês numa guia de remessa Mirakl já validada. A parte de «encomenda Mirakl» depende de um dado interno, É Encomenda Mirakl (Is Mirakl Order), que não aparece em nenhuma vista.

Esquema feito com código do botão Push Mirakl Tracking, presente no Odoo 17, 18, 19 e 20, com o rótulo em inglês do código do módulo
Esquema feito com código a partir do código publicado do módulo, não é um ecrã do Odoo: o botão Push Mirakl Tracking no Odoo 17.0, 18.0, 19.0 e 20.0.

O rótulo depende do idioma do teu Odoo: em espanhol é Enviar seguimiento a Mirakl, em alemão Mirakl-Tracking übertragen, em francês Envoyer le suivi à Mirakl, em italiano Invia tracciamento Mirakl e em português Enviar Seguimento Mirakl.

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.
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)

Um caso do princípio ao fim

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

Imagina uma loja inventada, Almenara Hogar, que vende num marketplace Mirakl com o conector. Vejamos três entregas, com o que faz o código do Odoo 20.0.

Primeira entrega: o caminho automático

Na instância Mirakl da Almenara Hogar está ativada a definição de enviar o seguimento ao validar a entrega. O armazém deixa o número da transportadora na guia de remessa e valida. Quando a validação termina, o Odoo verifica que a guia de remessa está em Concluído, que é de uma encomenda Mirakl, que a instância tem essa definição ativa e que existe número de seguimento. Depois envia o seguimento ao Mirakl sem que ninguém carregue em nada. Este é o caminho normal: o botão não é necessário.

Se, nesse caminho, o envio falhar, a validação da entrega não é interrompida: o módulo deixa na guia de remessa uma nota com o motivo da falha.

Segunda entrega: sem número de seguimento

O armazém valida outra guia de remessa sem número da transportadora. Como a definição está ativa, o módulo não envia nada e deixa na guia de remessa uma nota que explica que falta o número de seguimento e que é preciso acrescentá-lo à entrega e carregar em Enviar Seguimento Mirakl.

O armazém acrescenta o número da transportadora à entrega e carrega no botão. Este é o uso do botão como exceção: repetir manualmente um envio que não saiu sozinho.

Terceira entrega: o envio falha ao carregar

Noutra guia de remessa, ao carregar no botão, a chamada ao Mirakl falha. O módulo deixa na guia de remessa uma nota com o motivo da falha e o botão mostra-te o erro no ecrã. No caminho automático, pelo contrário, a nota fica na guia de remessa e a validação segue em frente.

O que verifica o botão e por que ordem

  1. Que a guia de remessa esteja em Concluído.
  2. Que a guia de remessa dependa de uma encomenda de venda que tenha encomenda Mirakl.
  3. Que exista número de seguimento. O módulo lê-o da referência de seguimento da transportadora da guia de remessa (fornecida pelo módulo opcional stock_delivery; se não estiver instalado, o conector não falha). Se a referência tiver várias linhas, usa a primeira e, dela, o que vem antes da primeira vírgula ou ponto e vírgula.
  4. Que a encomenda de venda tenha uma instância Mirakl associada.
  5. Se estiver tudo em ordem, envia o seguimento ao Mirakl através dessa instância.
  6. Se o envio correr bem, deixa uma nota na guia de remessa com o texto Rastreio Mirakl enviado com sucesso. Se falhar, vês o erro no ecrã.

Se alguma das quatro primeiras verificações falhar, a ação pára com um aviso antes de tentar o envio do passo cinco.

O que acontece se faltar a subscrição

Quando o marketplace passa pelo FlexigoTech Cloud e esta base de dados não tem o serviço do conector, a validação da entrega segue o seu curso normal no Odoo e nada vai para o Mirakl: o seguimento e a fatura ficam pendentes de envio mais tarde. Se carregares no botão nesse estado, o seguimento fica pendente, sem marcar nada como enviado, e a ação é interrompida.

O que acontece na mesma validação

Na mesma validação, o módulo também pode criar a fatura se a instância tiver ativa a caixa Criar fatura automaticamente na validação da entrega (Auto-create invoice on delivery validation). Está na ficha de Instâncias Mirakl (Mirakl Instances), separador Encomendas e Devoluções (Orders and Returns), grupo Ponte de Vendas (Sales Bridge), e vem desativada por defeito. É algo diferente do seguimento. Se te interessa a fatura, vê a mensagem sobre lançar a fatura antes de a enviar ao Mirakl; e se precisas de desfazer uma encomenda, o botão «Cancelar no Mirakl».

O que aprender com o caso

  • O envio do seguimento é automático ao validar se a instância o tiver ativado; o botão serve para repetir manualmente.
  • O botão só aparece com a guia de remessa em Concluído e de uma encomenda Mirakl.
  • Sem número de seguimento não há envio: acrescenta o número da transportadora à entrega e carrega de novo.
  • Depois de carregar, se o envio correr bem fica uma nota na guia de remessa; se falhar, vês o erro no ecrã.

Custo e ajuda

O Mirakl Connector é um módulo de pagamento único por versão do Odoo (publicado na Odoo Apps para 17.0, 18.0, 19.0 e 20.0) e precisa da subscrição do FlexigoTech Cloud: plano Conector, 49 €/mês ou 490 €/ano sem IVA, até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas 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 fornece; os dados ficam no teu Odoo. Tens a ficha na Odoo Apps e a página do módulo.

Se estás a implementar o Odoo e queres deixar a logística e o seguimento bem ligados, a FlexigoTech implementa o 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 20.0) e nas fontes indicadas

Fontes