Saltar para o conteúdo principal
Mirakl

Aceitar encomendas pendentes no Mirakl Connector: o que faz o botão

O botão Aceitar Encomendas Pendentes (Accept Pending Orders) tenta aceitar as encomendas dessa instância do Mirakl que requerem aceitação e estão pendentes ou com erro, começando pela mais antiga, e diz-te quantas aceitou e quantas deram erro. É a forma manual: o Odoo pode fazer o mesmo sozinho, com duas caixas da ficha e duas tarefas agendadas.

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
6 min

Um caso para ver como funciona: encomendas à espera de aceitação

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

Almazara Home é uma loja inventada que vende artigos para a casa num marketplace Mirakl e tem a sua conta ligada ao Mirakl Connector. Numa manhã, a pessoa que trata das encomendas pergunta-se se o Odoo aceita sozinho as encomendas que o exigem ou se tem de ser ela a fazê-lo. Este é o seu percurso: primeiro vê o que o Odoo faz por conta própria e, depois, prime o botão.

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)

Primeiro, o que o Odoo faz sem que prima nada

O botão não é o único caminho. O método que aceita as encomendas é também chamado por duas tarefas agendadas, e ambas correm sem que ninguém prima nada:

  • A tarefa Mirakl - Sincronizar Encomendas (Mirakl - Sync Orders) corre a cada dez minutos e está ativa ao instalar. Quando termina de importar encomendas, se na instância estiverem marcadas as duas caixas Aceitar Encomendas Automaticamente (Auto Accept Orders) e Aceitar Pendentes na Importação (Accept Pending On Import), tenta aceitar as encomendas pendentes, com o limite de tentativas dessa instância.
  • A tarefa Mirakl - Aceitar Encomendas (Mirakl - Accept Orders) também corre a cada dez minutos e está ativa ao instalar. Chama o mesmo método de aceitação com o limite de tentativas de cada instância.

As duas caixas vêm desmarcadas por defeito no código. A ajuda de Aceitar Encomendas Automaticamente diz: «Aceitar automaticamente as encomendas importadas que requerem aceitação do vendedor no Mirakl.» A de Aceitar Pendentes na Importação diz: «Tentar aceitar encomendas em espera logo após cada importação de encomendas manual ou agendada.»

Passo a passo com o botão

  1. Abre Mirakl › Configuração › Marketplaces e entra na ficha da instância, no ecrã Instâncias Mirakl (Mirakl Instances).
  2. Vai ao separador Encomendas e Devoluções (Orders and Returns), grupo Política de Sincronização (Sync Policy). Aí estão as duas caixas de há pouco e o campo Limite de Tentativas de Aceitação (Accept Retry Limit), cujo valor por defeito no código é 100.
  3. Prime Aceitar Encomendas Pendentes. O botão vê-se sempre nesse ecrã, no Odoo 17, 18, 19 e 20. O que se segue é o que acontece segundo o código do Odoo 20.
  4. Lê o aviso que aparece no fim. Tem o título Mirakl, não fica fixo no ecrã e o seu texto é Aceites: … | Erros: … (Accepted: … | Errors: …). Se houve algum erro, o aviso aparece como advertência.
  5. Vê a ficha da instância: o botão também deixa lá uma mensagem com o resultado.
  6. Se não foi aceite nenhuma encomenda e houve erros, a mensagem da ficha remete-te para os registos de encomendas do Mirakl; se houve erros mas também encomendas aceites, vê-lo-ás na contagem «Erros» do aviso. Volta a premir o botão quando quiseres tentar de novo.
Esquema feito com código do menu Mirakl, Configuration, Marketplaces e do botão Accept Pending Orders
Esquema feito com código a partir do código do módulo, não um ecrã do Odoo: o menu das instâncias e o botão, com os rótulos originais do módulo, presentes no Odoo 17, 18, 19 e 20.

O que faz o botão por dentro

O botão atua sobre a instância que tens aberta. Segundo o código do Odoo 20, faz isto, por esta ordem:

  • Procura as encomendas dessa instância que requerem aceitação e cujo estado de aceitação é pendente ou com erro.
  • Deixa de fora as encomendas retidas em relação às ordens de vendas. O comentário do código explica-o assim: aceitá-las seria comprometer-se a enviar o que o Odoo nunca vai enviar.
  • Ordena-as por data da encomenda, da mais antiga à mais recente, e fica com tantas quantas indicar Limite de Tentativas de Aceitação.
  • Tenta aceitar cada uma. Se for aceite, soma um aos aceites. Se não for aceite e a encomenda ficar com o estado de aceitação em erro, soma um aos erros.
  • Publica uma mensagem na ficha da instância e mostra o aviso com as duas contagens. O aviso aparece como advertência se houve algum erro e como sucesso se não houve nenhum.

Um pormenor da contagem: uma encomenda que não é aceite mas também não fica em estado de erro não soma a nenhuma das duas contas.

Que mensagem te dá

O texto da mensagem da ficha depende do resultado:

MensagemQuando apareceO que significa
Aceitar Encomendas Pendentes concluído: … encomendas aceites. (Accept Pending Orders completed: … orders accepted.)Foi aceite pelo menos uma encomendaEm vez das reticências vai o número de encomendas aceites.
Aceitar Encomendas Pendentes concluído com erros. Verifique os registos de encomendas Mirakl. (Accept Pending Orders completed with errors. Check Mirakl order logs.)Não foi aceite nenhuma e houve errosHá encomendas que ficaram com o estado de aceitação em erro.
Aceitar Encomendas Pendentes concluído: nenhuma encomenda requeria aceitação. (Accept Pending Orders completed: no orders required acceptance.)Não foi aceite nenhuma e também não houve errosNão foi aceite nenhuma encomenda e nenhuma ficou com o estado de aceitação em erro.

Repara que, se algumas encomendas são aceites e outras falham, a mensagem da ficha é a primeira, mas o aviso aparece como advertência e o seu texto mostra as duas contagens.

O que aprender com o caso

A Almazara Home verifica três coisas, por esta ordem: se as duas caixas da política de sincronização estão marcadas, que limite de tentativas tem a instância e o que lhe diz o botão ao premi-lo. Como as encomendas em erro entram de novo na pesquisa, premir outra vez o botão volta a tentá-las. As encomendas retidas em relação às ordens de vendas ficam de fora, quando quer que prima o botão.

O botão muda de nome com o idioma do teu Odoo:

Esquema feito com código com o nome 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 castelhano, Aceptar pedidos pendientes; em alemão, Ausstehende Bestellungen annehmen; em francês, Accepter les commandes en attente; em italiano, Accetta ordini in sospeso; em português, Aceitar Encomendas Pendentes.

Para continuar com a colocação em funcionamento, o botão Testar ligação tem o seu próprio percurso.

Versões e custo

O botão existe nos quatro ramos publicados, o 17, o 18, o 19 e o 20, e em todos se vê sempre. O código que descrevo é o do Odoo 20. O Mirakl Connector é um módulo de pagamento único por versão do Odoo, publicado no Odoo Apps para essas versões (consulta a ficha ou a página do módulo), e precisa da subscrição do FlexigoTech Cloud, plano Conector: 49 €/mês ou 490 €/ano, sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais e avisa por e-mail se a sincronização falhar.

Se quiseres ajuda com a colocação em funcionamento

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se quiseres rever contigo a política de sincronização da tua instância Mirakl, escreve-nos a partir da página do módulo.

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