Saltar para o conteúdo principal

Mirakl

Campos da Instância Mirakl no Mirakl Connector: o que significam e o que pôr

A ficha de Instâncias Mirakl reparte os campos por vários separadores, e cada um traz a sua própria ajuda. Aqui comparamo-los: o que diz a ajuda, que valor levam por defeito e o que muda se os deixares vazios ou preenchidos.

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

Onde estão os campos

As fichas abrem-se a partir do menu Mirakl › Configuração › Marketplaces. Na ficha de Instâncias Mirakl (Mirakl Instances), os campos deste guia estão repartidos por três separadores: Transportadoras (Carriers), Encomendas e Devoluções (Orders and Returns) e Operações Manuais (Manual Operations).

Esquema feito com código do menu Mirakl, Configuration, Marketplaces e da ficha Mirakl Instance com os campos que aqui se comparam — Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo: o menu e os campos da ficha com os seus rótulos originais.

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)

Janelas de importação e limites

Estes campos delimitam o que se importa, se analisa ou se consulta. Todos levam um valor por defeito no código.

Campo	Onde está	O que diz a ajuda	Por defeito
`Dias de Sincronização Inicial de Encomendas` (Initial Order Sync Days)	`Encomendas e Devoluções`, grupo `Windows`	«Janela histórica utilizada quando não existe sincronização de encomendas anterior. A importação manual também utiliza este intervalo.»	30
`Dias de Sincronização Inicial de Devoluções` (Initial Return Sync Days)	`Encomendas e Devoluções`, grupo `Windows`	«Janela histórica utilizada quando não existe sincronização de devoluções anterior. A importação manual também utiliza este intervalo.»	30
`Páginas Máximas de Sincronização` (Max Sync Pages)	`Encomendas e Devoluções`, grupo `Windows`	«Limite de segurança para importações paginadas de encomendas/devoluções.»	40
`Limite de Geração de Ligação de Oferta` (Offer Binding Generate Limit)	`Operações Manuais`, grupo `Ofertas` (Offers)	«Número máximo de produtos analisados ao gerar automaticamente ligações de oferta em falta.»	500
`Transportadoras de Envio do Endpoint` (Endpoint Shipping Carriers)	`Transportadoras`, grupo `Sincronização de Transportadoras` (Carrier Sync)	«Endpoint SH21 do Mirakl utilizado para obter as transportadoras de envio disponíveis quando suportado pelo operador.»	`/shipping/carriers`

Os dois campos de dias marcam a janela que se usa quando ainda não existe uma sincronização prévia de encomendas ou de devoluções, e a ajuda acrescenta que a importação manual usa o mesmo intervalo. Páginas Máximas de Sincronização é, segundo a sua ajuda, um limite de segurança para as importações paginadas.

Cliente da encomenda: dois modos e duas caixas

O campo Modo de cliente dos pedidos (Order Customer Mode) está em Encomendas e Devoluções, grupo Cliente e privacidade (Customer & Privacy). Tem dois valores: Um cliente por comprador (padrão) (One customer per shopper (standard)), o que vem por defeito, e Cliente padrão único com contactos filhos de entrega (Single default customer with delivery child contacts).

Campo	Quando se vê	Por defeito
`Modo de cliente dos pedidos`	No grupo `Cliente e privacidade`	`Um cliente por comprador (padrão)`
`Cliente padrão do marketplace` (Default Marketplace Customer)	Só com o modo de cliente único; com os valores por defeito não se vê	Oculto com o modo padrão
`Contactos de entrega como empresas` (Delivery Contacts as Companies)	Só com o modo de cliente único; com os valores por defeito não se vê	Desativada
`Usar email de notificação Mirakl` (Use Mirakl Notification Email)	No grupo `Cliente e privacidade`	Desativada

O que diz a ajuda de cada opção:

Modo padrão: cada comprador passa a ser o seu próprio cliente no Odoo.
Cliente padrão único: todas as encomendas do marketplace são atribuídas a um cliente fixo, o que escolhes em Cliente padrão do marketplace. O endereço de entrega do comprador é guardado como contacto filho dele (tipo Entrega, marcado como comprador do marketplace), de modo que os dados pessoais ficam delimitados e podem ser ocultados com uma regra de registo. As faturas são emitidas ao cliente padrão e não levam dados do comprador.
Contactos de entrega como empresas: só com cliente único. Cada endereço de entrega passa a ser um contacto de empresa próprio em vez de um contacto filho do cliente padrão, de modo que a ordem de vendas, a entrega e a guia de remessa mostram a empresa do cliente final e nunca o nome do cliente padrão. A ajuda indica que a pessoa vai para Pessoa de contacto, e que o email que a Mirakl envia do cliente não é guardado: nos marketplaces em que o operador te compra (GACD, por exemplo) é um endereço do operador, não do cliente.
Email de notificação: a Mirakl anonimiza o comprador por trás de um endereço de reencaminhamento por encomenda, que muda em cada encomenda. Com a caixa ativa, o endereço de reencaminhamento é usado como email do contacto de entrega da encomenda (nunca numa ficha de cliente permanente), assim as respostas chegam ao comprador através da Mirakl. Em modo de cliente único, o contacto filho do comprador leva sempre o endereço de reencaminhamento quando a Mirakl o fornece. O valor de cada encomenda é também guardado na ordem de vendas.

Ponte de vendas: vazio versus preenchido

No separador Encomendas e Devoluções, o grupo Ponte de Vendas (Sales Bridge) reúne campos cuja ajuda diz o que acontece se os deixares vazios.

Campo	Se o deixares vazio	Se o preencheres
`Produto de Envio` (Shipping Product). No ecrã aparece sem rótulo: só se vê o seu conteúdo	Não é adicionada linha de envio à ordem de vendas	Esse produto de serviço é usado para a linha de custos de envio
`Criar encomendas de venda a partir de` (Create Sales Orders From)	Sem limite	As encomendas da Mirakl criadas antes dessa data são importadas mas nunca passam a ser ordens de vendas
`Comercial nas encomendas` (Salesperson on Orders)	Decide o Odoo: o comercial do cliente ou, se não tiver, o utilizador que importou a encomenda (OdooBot na importação automática)	Esse comercial é colocado em cada ordem de vendas importada deste marketplace
`Método de envio nas encomendas` (Shipping Method on Orders)	As ordens de vendas não levam método de envio	Esse método é colocado em cada ordem de vendas e, com ele, na sua entrega

Dois pormenores da ajuda. Em Criar encomendas de venda a partir de, o motivo é que as encomendas que foram geridas antes de usar o conector não sejam enviadas outra vez. Em Método de envio nas encomendas, a ajuda pede para o atribuir em Mirakl > Catálogo > Asignación de transportistas para que o número de seguimento chegue à Mirakl com a transportadora correta.

Enviar o seguimento ao validar

A caixa Enviar o seguimento para a Mirakl ao validar (Send Tracking to Mirakl on Validation) está desativada por defeito. Ativada, ao validar a entrega no Odoo é enviado o envio à Mirakl (número de seguimento, transportadora e confirmação de envio), para que o marketplace marque a encomenda como enviada e o comprador veja o seguimento. A ajuda põe dois requisitos: a entrega deve levar um número de seguimento e a sua transportadora deveria estar mapeada no separador Transportadoras. Se faltar o número, a guia de remessa não é tocada e uma nota explica porquê. Alguns perfis de marketplace, como a Leroy Merlin, enviam-no sempre porque o operador o exige.

O campo do endpoint de transportadoras

A ajuda de Transportadoras de Envio do Endpoint lê-se, com o Odoo em português de Portugal, «Endpoint SH21 do Mirakl utilizado para obter as transportadoras de envio disponíveis quando suportado pelo operador.». O esquema mostra esse mesmo texto em castelhano, alemão, francês e italiano.

Esquema com a ajuda do campo Endpoint Shipping Carriers 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.

O que pôr consoante o teu caso

Já vendias no marketplace antes de instalar o conector: preenche Criar encomendas de venda a partir de; segundo a ajuda, as encomendas anteriores são importadas mas não passam a ser ordens de vendas.
Não queres um cliente do Odoo por comprador: escolhe o modo de cliente único e indica o Cliente padrão do marketplace; a ajuda sugere um contacto genérico por marketplace.
Queres que o comprador veja o seguimento ao validar: ativa Enviar o seguimento para a Mirakl ao validar e revê a transportadora no separador Transportadoras.
Não queres linha de custos de envio: deixa Produto de Envio vazio.
Não tens um comercial fixo para estas encomendas: deixa Comercial nas encomendas vazio e o Odoo decidirá segundo a sua ajuda.

Custo e ajuda da FlexigoTech

O Mirakl Connector é um módulo de pagamento único por versão do Odoo (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, até 3 contas da plataforma. A ligação passa pela FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por email se falhar. Tens a ficha do Odoo Apps e a página do módulo. Se preferires que alguém configure a instância contigo, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

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.Os campos da instância Mirakl no Odoo: o que significa cada um e o que indicarGuia dos campos da instância do Mirakl Connector para Odoo: envio, desconto, comissão, idioma, faturas e sincronização, segundo a sua própria ajuda.

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes

Código do módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
Código do módulo: flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
flexigotech.com/en/services.html
flexigotech.com/precios.html