Saltar para o conteúdo principal
Mirakl

Mirakl Connector: o que fazer quando só um Mirakl Manager pode aceitar ou cancelar

O aviso Só um Mirakl Manager pode aceitar, cancelar ou reembolsar uma encomenda do marketplace. Estas ações alteram a encomenda no marketplace e movimentam dinheiro real. (Only a Mirakl Manager can accept, cancel or refund a marketplace order. These actions change the order on the marketplace and move real money.) surge, por exemplo, quando carrega em Aceitar Encomenda ou Cancelar no Mirakl sem pertencer ao grupo Mirakl Manager; resolve-se pedindo a alguém desse grupo que carregue ou adicionando-o a ele.

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

O caso: a Marta carrega em Aceitar Encomenda e o Odoo pára

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

A Distribuciones Norte, uma empresa inventada para este exemplo, já tem o Mirakl Connector instalado. A Marta trabalha lá com um utilizador interno do Odoo. Abre Mirakl › Operações › Encomendas, entra numa encomenda, carrega em Aceitar Encomenda (Accept Order) e recebe este aviso: Só um Mirakl Manager pode aceitar, cancelar ou reembolsar uma encomenda do marketplace. Estas ações alteram a encomenda no marketplace e movimentam dinheiro real.

A Marta pensa que algo falhou na encomenda ou na ligação. Mas o aviso não fala de nenhuma das duas coisas: fala de quem carregou no botão.

Esquema feito com código, não um ecrã do Odoo: o menu Mirakl › Operations › Orders, os botões Accept Order e Cancel in Mirakl e a mensagem sobre o Mirakl Manager, com as legendas em inglês
Esquema do percurso da Marta com as legendas originais em inglês do módulo: menu, dois botões e o aviso (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)

Quando surge exatamente

O módulo verifica, no servidor, se o utilizador que carregou pertence ao grupo Mirakl Manager. Se não pertence, lança o aviso e a ação pára: surge o aviso em vez de seguir em frente. Se pertence, a verificação dá-se por boa e a ação segue o seu curso.

O aviso está no código publicado das quatro versões do Odoo que o módulo cobre: 17, 18, 19 e 20.

O próprio código explica porque é que a verificação se faz no servidor. Os botões que alteram algo no marketplace (aceitar, cancelar, reembolsar) são limitados nas vistas por grupos, mas um atributo de vista não é uma barreira de segurança: qualquer utilizador interno poderia chamar o método por RPC, e a permissão de acesso dá escrita sobre as encomendas do Mirakl aos utilizadores internos. Por isso o grupo volta a ser exigido no servidor.

Botões com que pode surgir o aviso

Estes são dois botões da ficha da encomenda que chegam à verificação do grupo:

BotãoQuando se vêO que acontece se não for Mirakl Manager
Aceitar EncomendaFica oculto se Estado de Aceitação (Acceptance State) indicar que a encomenda já está aceite ou se a encomenda não requer aceitação (campo Requer Aceitação, Requires Acceptance)Surge o aviso e a ação pára
Cancelar no Mirakl (Cancel in Mirakl)Fica oculto quando Estado (State) é o de cancelado; com os valores por defeito (encomenda pendente) vê-seSurge o aviso e a ação pára

Ver o botão não quer dizer que a ação vá continuar: a verificação do grupo faz-se quando carrega nele. Se não vir um dos botões, pode dever-se às condições da tabela.

Como se resolve, passo a passo

  1. Confirme que o aviso é este, com o texto inteiro: Só um Mirakl Manager pode aceitar, cancelar ou reembolsar uma encomenda do marketplace. Estas ações alteram a encomenda no marketplace e movimentam dinheiro real.
  2. Decida se essa ação lhe compete a si. Segundo o próprio aviso, aceitar, cancelar ou reembolsar altera a encomenda no marketplace e movimenta dinheiro real.
  3. Se não lhe compete, peça a alguém do grupo Mirakl Manager que abra a mesma encomenda e carregue no botão.
  4. Se lhe compete, peça a quem administra os utilizadores do seu Odoo que o adicione ao grupo Mirakl Manager.
  5. Volte à encomenda, carregue de novo no botão e confirme que o aviso já não surge.
Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: o mesmo aviso em castelhano, alemão, francês, italiano e português
Esquema com o aviso tal como o utilizador o vê consoante o idioma do seu Odoo; com o Odoo em português é o texto do caso da Marta.

Dúvidas de quem vê o aviso

É uma falha da ligação com o Mirakl?

O aviso fala do grupo do utilizador: é lançado quando o utilizador que carrega não pertence a Mirakl Manager. Não menciona a ligação nem dados da encomenda.

O que acontece quando surge?

A ação pára: surge o aviso em vez de seguir em frente. Pode surgir, por exemplo, ao carregar em Aceitar Encomenda ou Cancelar no Mirakl.

Basta o botão estar oculto na vista para proteger a ação?

Segundo explica o código, não: um atributo de vista não é uma barreira de segurança, e por isso o grupo também é exigido no servidor.

Acontece também no Odoo 17, 18 ou 19?

O aviso está no código publicado de 17, 18, 19 e 20.

O que aprender com o caso

  • O aviso trata de permissões, não de dados: antes de rever a encomenda, veja a que grupo pertence quem carrega.
  • Pertencer a Mirakl Manager é o que conta. Ser utilizador interno do Odoo, como a Marta, não basta.
  • Decida com critério quem entra no grupo: as ações que protege alteram a encomenda no marketplace e movimentam dinheiro real.
  • Que um botão se veja depende das condições da vista; que a ação siga em frente depende do grupo do utilizador, que se verifica no servidor ao carregar.

Como a FlexigoTech o ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida; se está a distribuir permissões pela equipa que gere encomendas de marketplace, podemos revê-lo consigo. O Mirakl Connector está publicado no Odoo Apps para 17, 18, 19 e 20, e precisa da subscrição da FlexigoTech Cloud (plano Conector: 49 €/mês ou 490 €/ano, sem IVA). Tem a ficha no Odoo Apps e a página do módulo.

Sem a subscrição, ou com o serviço suspenso, pára o que a subscrição dá; os dados ficam no seu Odoo.

Continue a ler

Checklist da instância do Mirakl Connector, campo a campoChecklist para preencher a instância do Mirakl Connector no Odoo: ligação, contas de liquidação e opções, com o que diz a ajuda de cada campo.Campos da Instância Mirakl no Mirakl Connector: o que significam e o que pôrGuia comparado dos campos da ficha Instâncias Mirakl no Mirakl Connector para Odoo: o que diz cada ajuda, o valor por defeito e o que preencher.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes