Saltar para o conteúdo principal
Mirakl

Esta fatura não está associada a uma encomenda Mirakl: o que fazer

A mensagem Esta fatura não está associada a uma encomenda Mirakl. (This invoice is not linked to a Mirakl order.) aparece ao carregar em Enviar para o Mirakl (Send to Mirakl) quando o módulo não encontra uma instância do Mirakl para essa fatura; a ação pára e não se envia nada.

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 a mensagem

Aparece ao carregar em Enviar para o Mirakl numa fatura. A primeira coisa que o módulo faz é procurar a instância do Mirakl associada a essa fatura. Se não encontrar nenhuma (o resultado está vazio), lança Esta fatura não está associada a uma encomenda Mirakl. e a ação pára: não se envia nada ao Mirakl e não se guarda nenhuma alteração dessa ação.

Esquema feito com código, não um ecrã do Odoo: em cima o botão «Send to Mirakl» e por baixo a mensagem «This invoice is not linked to a Mirakl order.», com os textos originais do código do módulo
Esquema feito com código a partir do código publicado do módulo: o botão e a mensagem a que conduz, no Odoo 17, 18, 19 e 20.

É a primeira verificação do botão: faz-se antes de ver se a fatura está contabilizada. Por isso a mensagem não fala do estado da fatura, só da sua ligação ao Mirakl.

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 significa

Para o módulo, essa fatura não tem uma instância do Mirakl, e sem instância o envio não segue. Não é uma falha da ligação nem do PDF: a ação é cortada antes de tentar fosse o que fosse.

A mensagem indica que o módulo não conseguiu relacionar essa fatura com o Mirakl, e é isso que convém esclarecer antes de voltar a carregar.

Quando vê o botão

O botão Enviar para o Mirakl fica oculto quando a fatura não é de cliente (Fatura de Cliente), quando o campo Fatura Mirakl (Mirakl invoice) não está ativo ou quando a fatura não está no estado Publicada. Essa condição é a mesma no Odoo 17, 18, 19 e 20.

O campo Fatura Mirakl não se vê em nenhuma vista, pelo que não o pode consultar nem alterar a partir do ecrã.

Ver o botão não garante que a verificação da instância passe: a visibilidade do botão depende desse campo, e a mensagem depende de o módulo encontrar a instância do Mirakl da fatura. São duas condições distintas.

O mesmo texto num segundo ponto

O código publicado lança esta mesma mensagem noutro sítio: o método que carrega o PDF da fatura para o Mirakl. Aí aparece quando a fatura não tem identificador de encomenda do Mirakl (fica vazio). A partir do botão, esse ponto só é alcançado depois de ultrapassadas a verificação da instância e a de que a fatura está contabilizada. Para si o texto é o mesmo, por isso, se o vir, a leitura é a mesma: o módulo não conseguiu relacionar a fatura com uma encomenda do Mirakl.

Lista de verificação

Antes de carregar no botão

  • Confirme que a fatura é de cliente (Fatura de Cliente) e está no estado Publicada: com outro tipo ou estado o botão Enviar para o Mirakl está oculto e não há clique que possa dar esta mensagem.
  • Confirme que a fatura corresponde a uma encomenda que veio do Mirakl. Se não for assim, a mensagem está correta: o módulo não a tem associada ao Mirakl e não a envia com este botão.
  • Não procure o campo Fatura Mirakl no ecrã: não se vê em nenhuma vista, pelo que não é algo que possa alterar à mão a partir daí.

Ao ver a mensagem

  • Anote qual era a fatura (o seu número ou referência) para poder falar dela com quem administra o conector.
  • Lembre-se de que a ação parou: não se enviou nada ao Mirakl com esse clique.
  • Se a fatura vem de facto de uma encomenda do Mirakl e a mensagem continua a aparecer, o módulo não está a encontrar a sua instância do Mirakl. É um caso a rever com quem implementou o conector (mais abaixo, como a FlexigoTech o ajuda).
Esquema feito com código, não um ecrã do Odoo: a mesma mensagem em espanhol, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo: o texto da mensagem em cinco idiomas.
IdiomaTexto da mensagem
EspanholEsta factura no está vinculada a un pedido de Mirakl.
AlemãoDiese Rechnung ist nicht mit einer Mirakl-Bestellung verknüpft.
FrancêsCette facture n'est pas liée à une commande Mirakl.
ItalianoQuesta fattura non è collegata a un ordine Mirakl.
PortuguêsEsta fatura não está associada a uma encomenda Mirakl.

Quando o módulo já encontrar a instância

  • Volte a abrir a fatura, confirme que continua no estado Publicada e carregue em Enviar para o Mirakl.
  • Tenha em conta o que o módulo faz quando a instância existe: gera o PDF da fatura e carrega-o na encomenda do Mirakl para substituir a fatura anterior do mesmo tipo, de modo que o Mirakl conserve uma só fatura, a atual.
  • Se agora aparecer outra mensagem, é outra verificação distinta: leia-a inteira antes de mexer em seja o que for.

Se o envio não chega a sair

  • Lembre-se de que a ligação passa pela FlexigoTech Cloud, que guarda cifradas as credenciais e vigia a sincronização. Se o serviço não deixar passar o pedido (sem subscrição ou com o serviço em pausa), o código relança o erro e não marca nada.
  • Sem subscrição, ou com o serviço suspenso, pára aquilo que a subscrição proporciona; os dados ficam no seu Odoo.

Versões

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

Como a FlexigoTech o ajuda

Se está a implementar o Odoo e as faturas das suas encomendas do Mirakl não chegam a associar-se, ou precisa de uma integração à medida, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Tem os detalhes do módulo na sua página e na ficha do Odoo Apps.

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