Saltar para o conteúdo principal
Mirakl

O que faz o botão «Carregar Fatura para o Mirakl» do Mirakl Connector

O botão Carregar Fatura para o Mirakl (Upload Invoice to Mirakl) aparece na guia de remessa de uma encomenda Mirakl que já está no estado Concluído e carrega a fatura para o Mirakl manualmente. Se o carregamento correr bem, a guia de remessa guarda a data e a hora; se falhar, vês o erro e a ação é interrompida.

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 se vê o botão e o que faz o Odoo sem o premires

É preciso premir o botão para a fatura chegar ao Mirakl?

Nem sempre. O módulo amplia o botão padrão de validar da guia de remessa e, ao validar a entrega, também pode carregar a fatura sozinho, desde que a instância tenha o envio de faturas em modo automático e a guia de remessa ainda não tenha data de carregamento. O botão serve para a carregar manualmente. À parte, a caixa Criar fatura automaticamente na validação da entrega (Auto-create invoice on delivery validation) faz com que, ao validar uma entrega de uma encomenda Mirakl, seja criada a fatura de cliente a partir da respetiva ordem de venda. Encontras a caixa 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. Segundo a sua ajuda, respeita a política de faturação (encomenda ou entregue) e nunca bloqueia a entrega se a faturação falhar.

Quando aparece o botão e porque pode faltar numa guia de remessa?

Está na ficha da guia de remessa (movimento de Inventário). Fica oculto quando a guia de remessa não é de uma encomenda Mirakl ou quando o seu estado não é Concluído. Dito ao contrário: só o vês se a guia de remessa for de uma encomenda Mirakl e estiver em Concluído. O dado É Encomenda Mirakl (Is Mirakl Order) não aparece em nenhuma vista, por isso não há caixa para consultar; o que podes verificar é o estado da guia de remessa. A condição é a mesma no Odoo 17, 18, 19 e 20.

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 premi-lo, passo a passo

O que faz exatamente o botão?

O código percorre as guias de remessa sobre as quais atua e fica com as que são de encomendas Mirakl. Para cada uma procura a instância Mirakl da ordem de venda a que está ligada. Se a guia de remessa não tiver ordem de venda, não há instância e o botão passa ao lado sem fazer nada. Se houver, pede à instância que carregue a fatura; segundo o próprio código do módulo, o que se carrega é o PDF da fatura contabilizada. Se o carregamento correr bem, o módulo guarda a data e a hora do carregamento na guia de remessa e deixa lá uma nota.

Esquema com o botão Upload Invoice to Mirakl
Esquema feito com código, não é um ecrã do Odoo: o botão «Upload Invoice to Mirakl» (em português, Carregar Fatura para o Mirakl), presente no Odoo 17, 18, 19 e 20.

O que muda na guia de remessa se correr bem?

Duas coisas: ficam guardadas a data e a hora do carregamento, e aparece na guia de remessa a nota Mirakl: fatura carregada para o marketplace. O caminho automático só carrega se essa data estiver vazia.

O que acontece se o carregamento falhar?

Com o botão, o erro é lançado de novo: vês no ecrã, a ação é interrompida e não se guarda o que ia mudar, ou seja, não fica data de carregamento. Se for o FlexigoTech Cloud a não deixar passar a operação, não se carrega nada nem se marca nada, para a poder enviar mais tarde, e o botão também mostra o erro. No caminho automático, pelo contrário, o erro não é lançado de novo: perante uma falha corrente o módulo deixa na guia de remessa uma nota com o erro e a data não é marcada; se for o FlexigoTech Cloud a não passar a operação, também não se marca nada. O texto concreto do erro depende do que responder o carregamento e não é fixado pelo botão.

Posso premi-lo se a fatura já foi carregada?

Ao premi-lo, o botão não verifica por si se já existe data de carregamento, ao passo que o caminho automático exige que esteja vazia. Antes de a repetir manualmente, vê nas notas da guia de remessa se já aparece Mirakl: fatura carregada para o marketplace.

Versões, subscrição e ajuda

O botão existe na minha versão do Odoo?

Sim: o módulo está publicado no Odoo Apps para o Odoo 17, 18, 19 e 20, e o botão está na guia de remessa nos quatro ramos. O percurso passo a passo acima vem do código do Odoo 20.0. Com o Odoo em português, o botão chama-se Carregar Fatura para o Mirakl.

Esquema com o texto do botão em vários idiomas
Esquema feito com código a partir das traduções do módulo, não é um ecrã do Odoo: em espanhol, «Subir factura a Mirakl»; em alemão, «Rechnung zu Mirakl hochladen»; em francês, «Téléverser la facture vers Mirakl»; em italiano, «Carica fattura su Mirakl»; em português, «Carregar Fatura para o Mirakl».

O que precisa para funcionar e quanto custa?

O módulo é de pagamento único por versão do Odoo (o preço de cada versão está na ficha do Odoo Apps e na página do módulo) e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano sem IVA, com até 3 contas da plataforma. A ligação passa pelo FlexigoTech Cloud, que guarda as credenciais cifradas, 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. Com a subscrição, o módulo para as versões novas do Odoo vai incluído se o compraste em flexigotech.com; na Odoo App Store, cada versão compra-se lá.

Ajudam-me a pô-lo em funcionamento?

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações por 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