Saltar para o conteúdo principal
Mirakl

O erro «Lance a fatura antes de a enviar para o Mirakl.» no Mirakl Connector

A mensagem é lançada pelo botão Enviar para o Mirakl (Send to Mirakl) quando, ao carregar nele, a fatura não está no estado Publicada. Como o botão só aparece em faturas lançadas, resolve-se lançando a fatura; até lá não é enviado nada para o Mirakl.

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 significa a mensagem e quando aparece

Que diz exatamente a mensagem e o que quer dizer?

Com o Odoo em português de Portugal vês Lance a fatura antes de a enviar para o Mirakl. (Post the invoice before sending it to Mirakl.). É um erro: a ação pára e não se guarda nada do que essa ação ia alterar. Quer dizer que a fatura sobre a qual pediste o envio não está no estado Publicada (lançada), e o envio para o Mirakl só avança com faturas nesse estado.

Esquema feito com código do texto do erro consoante o idioma do Odoo
Esquema feito com código a partir das traduções publicadas do módulo, não é uma captura do Odoo. O mesmo texto consoante o idioma: em castelhano, «Contabiliza la factura antes de enviarla a Mirakl.»; em alemão, «Buchen Sie die Rechnung, bevor Sie sie an Mirakl senden.»; em francês, «Comptabilisez la facture avant de l'envoyer à Mirakl.»; em italiano, «Conferma la fattura prima di inviarla a Mirakl.»; em português, «Lance a fatura antes de a enviar para o Mirakl.».

Quando aparece exatamente?

Aparece ao carregar no botão Enviar para o Mirakl. O método desse botão percorre as faturas que recebe, uma a uma, e para cada uma verifica o estado: se for diferente de Publicada, lança a mensagem Lance a fatura antes de a enviar para o Mirakl. e a ação pára. O estado é verificado no momento de carregar no botão, não antes.

Esquema feito com código: o botão «Send to Mirakl» e por baixo a mensagem de erro «Post the invoice before sending it to Mirakl.»
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo. De cima para baixo: o botão e a mensagem, com os rótulos em inglês do texto original, para Odoo 17, 18, 19 e 20.

Porque não vejo o botão numa fatura por lançar?

Porque a vista o oculta quando se verifica qualquer uma destas condições: a fatura não é do tipo Fatura de Cliente, não é uma fatura do Mirakl ou o seu estado não é Publicada. O indicador de fatura do Mirakl é o campo Fatura Mirakl (Mirakl invoice), que não se vê em nenhuma vista. Dito ao contrário: o botão só se vê numa fatura de cliente, do Mirakl e lançada. Esta condição da vista é a mesma no Odoo 17, 18, 19 e 20. Ainda assim, o método do botão verifica o estado por si, e é dessa verificação que sai a mensagem.

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)

Como resolver

O que faço para o erro desaparecer?

Lança a fatura, que é precisamente o que a mensagem pede. Quando a fatura está em Publicada e cumpre as outras duas condições da vista, o botão Enviar para o Mirakl aparece nela e podes carregar nele.

E se a fatura já está lançada e continuo sem ver o botão?

Então a causa está noutra das condições da vista, que oculta o botão quando a fatura não é do tipo Fatura de Cliente ou quando não é uma fatura do Mirakl, mesmo estando lançada. A primeira coisa que podes ver na ficha é o tipo de fatura, porque o seu valor aparece como Fatura de Cliente. Como o campo Fatura Mirakl não se vê em nenhuma vista, não há uma caixa para rever: se a fatura é de cliente, está lançada e o botão não aparece, a vista trata-a como uma fatura que não é do Mirakl.

Foi enviado algo para o Mirakl quando aparece o erro?

Não. A verificação do estado vem antes de gerar o PDF da fatura e antes de comunicar com o Mirakl. Se o estado não for Publicada, o método pára aí e essa ação não carrega nada na encomenda.

O que acontece com uma fatura lançada e o que precisa o conector

O que faz o envio com uma fatura lançada e que outras falhas pode haver?

Gera o PDF da fatura e carrega-o na encomenda do Mirakl a que pertence, substituindo a fatura enviada antes para essa encomenda. Se o FlexigoTech Cloud não deixar passar o pedido (por falta de subscrição ou por uma pausa do relé), o erro é lançado de novo e não se marca nada. Qualquer outra falha durante o envio também é lançada de novo para que a vejas, e serão erros diferentes deste. Se te interessam outras ações e mensagens do módulo, tens o botão «Cancelar no Mirakl», passo a passo e a mensagem sobre o desconto de marketplace.

Aparece igual em todas as versões do Odoo?

A mensagem está no código publicado dos ramos 17, 18, 19 e 20, e a condição que oculta o botão é a mesma nos quatro. O módulo está publicado no Odoo Apps para essas versões.

O que preciso para o botão enviar a fatura para o Mirakl?

A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. O plano Conector custa 49 €/mês ou 490 €/ano, sem IVA, para até 3 contas da plataforma (o plano Pro, 98 €/mês ou 980 €/ano, sem IVA, para até 10). Sem subscrição, ou com o serviço suspenso, pára o que a subscrição dá; 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 do Odoo compra-se lá.

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se estás a montar a faturação das tuas encomendas do Mirakl, podes ver a página do módulo ou a sua ficha no Odoo Apps.

Continue a ler

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.O erro de desconto de marketplace fora do intervalo no Mirakl ConnectorO que significa o erro do desconto de marketplace fora do intervalo no Mirakl Connector, quando surge ao guardar a ficha e como o corrigir passo a passo.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes