Saltar para o conteúdo principal
Mirakl

Erro de cliente padrão do marketplace ao guardar a instância Mirakl

A mensagem Defina um cliente padrão do marketplace para usar o modo de pedido 'Cliente padrão único'. (Set a Default Marketplace Customer to use the 'Single default customer' order mode.) aparece ao guardar a ficha da instância Mirakl quando o modo de cliente da encomenda é o de cliente único e o campo do cliente padrão está vazio. Resolve-se escolhendo um cliente nesse campo ou voltando ao modo padrão.

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

Quando aparece e o que interrompe

O aviso é dado pela própria ficha da instância ao guardá-la e depende apenas de dois campos dessa ficha. Estas são as perguntas que vai fazer ao vê-lo.

Quando aparece exatamente esta mensagem?

Ao guardar a ficha de uma instância Mirakl, quando se verificam duas condições em simultâneo: o campo Modo de cliente dos pedidos (Order Customer Mode) tem selecionada a opção Cliente padrão único com contactos filhos de entrega (Single default customer with delivery child contacts) e o campo Cliente padrão do marketplace (Default Marketplace Customer) está vazio. Se faltar uma das duas, a verificação não dispara. Com a opção Um cliente por comprador (padrão) (One customer per shopper (standard)), que é o valor por omissão, não pode aparecer por esta condição.

Esquema do percurso: o menu de Marketplaces, guardar a ficha com os campos do cliente padrão e do modo de cliente da encomenda, e a mensagem de erro
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo. As legendas estão em inglês, o texto original do módulo.

A ficha é guardada quando o aviso aparece?

Não. É uma verificação que se executa ao guardar e, se não for cumprida, a ficha não é guardada: a ação é interrompida e nada do que ia guardar nessa ficha fica registado. Corrija o que falta e volte a guardar.

Como vejo o aviso com o Odoo em português?

Com o Odoo em português, o aviso diz Defina um cliente padrão do marketplace para usar o modo de pedido 'Cliente padrão único'. O esquema seguinte reúne esse texto em castelhano, alemão, francês, italiano e português.

Esquema com a mesma mensagem em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo, não é uma captura do Odoo.
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 na ficha

Onde estão os dois campos?

A ficha abre-se a partir do menu Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces), na ficha de Instâncias Mirakl (Mirakl Instances). Os dois campos estão no separador Encomendas e Devoluções (Orders and Returns), dentro do grupo Cliente e privacidade (Customer & Privacy).

Porque não vejo o campo do cliente padrão?

Porque está oculto enquanto o modo não for o de cliente único. Com os valores por omissão o modo é Um cliente por comprador (padrão), por isso não se vê. Aparece quando escolhe em Modo de cliente dos pedidos a opção Cliente padrão único com contactos filhos de entrega.

Como o resolvo?

Há duas saídas. Se quiser o modo de cliente único, deixe selecionada essa opção em Modo de cliente dos pedidos, preencha Cliente padrão do marketplace nesse mesmo grupo e guarde. Se não o quiser, altere o modo para Um cliente por comprador (padrão) e guarde; com esse modo o campo do cliente padrão fica oculto.

Que cliente tenho de indicar?

A ajuda do campo diz: «Cliente fixo ao qual cada encomenda é associada quando o modo acima é 'Cliente padrão único' (p. ex. um parceiro genérico por marketplace).» Ou seja, um único cliente ao qual serão atribuídas as encomendas desse marketplace, e a própria ajuda sugere um contacto genérico por marketplace.

O que verifico depois de guardar?

Que a ficha é guardada sem que a mensagem volte a aparecer e que Cliente padrão do marketplace mostra o cliente que escolheu. Se a mensagem reaparecer, verifique se o campo não ficou vazio.

O que muda com cada modo

Em que se diferenciam os dois modos?

Segundo a ajuda de Modo de cliente dos pedidos, no modo padrão cada comprador passa a ser o seu próprio cliente no Odoo. No de cliente único, todas as encomendas deste marketplace são atribuídas a um cliente fixo, o que indica em Cliente padrão do marketplace.

O que acontece com a morada de entrega do comprador no modo de cliente único?

A mesma ajuda explica que a morada de entrega do comprador é guardada como contacto filho do cliente padrão (tipo Entrega, marcado como comprador do marketplace). Assim os dados pessoais ficam delimitados e podem ocultar-se com uma regra de registo.

A quem se faturam as encomendas nesse modo?

Segundo essa ajuda, as faturas são emitidas ao cliente padrão e não incluem dados do comprador.

Aparece em todas as versões?

O texto da mensagem está no código publicado das ramos 17, 18, 19 e 20 do Odoo, e o módulo está publicado no Odoo Apps para 17, 18, 19 e 20.

Se preferir que o configuremos consigo

A FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Pode ver o módulo na ficha do Odoo Apps ou na página do módulo. Se outro aviso de configuração o estiver a travar, pode consultar os nossos outros artigos sobre o Mirakl Connector.

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