Saltar para o conteúdo principal
Mirakl

O que faz o botão «Aplicar Mapeamento de Categorias» do Mirakl Connector

O botão Aplicar Mapeamento de Categorias (Apply Category Mapping) da ficha da instância aplica o mapeamento de categorias às ofertas dessa instância que o utilizam e diz-lhe a quantas chegou. Vê-se sempre, mas não é preciso premi-lo de cada vez: guardar ou criar um mapeamento de categorias já lança a mesma sincronizaçã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

Onde está o botão e como se chama

Onde está o botão e quando se vê?

Abra Mirakl › Configuração › Marketplaces (Mirakl › Configuration › Marketplaces) e entre na ficha da sua instância: o botão Aplicar Mapeamento de Categorias está no ecrã Instâncias Mirakl (Mirakl Instances). Não depende de nenhum estado: vê-se sempre, e existe nas quatro versões publicadas, Odoo 17, 18, 19 e 20.

Esquema feito com código: em cima o menu Mirakl › Configuration › Marketplaces e por baixo o botão Apply Category Mapping
Esquema feito com código a partir do código publicado do módulo (não é um ecrã do Odoo): o menu e o botão, com os rótulos originais em inglês, válido para Odoo 17, 18, 19 e 20.

Como se chama o botão com o Odoo noutro idioma?

Com o Odoo em português é Aplicar Mapeamento de Categorias. As traduções publicadas do módulo mostram-no como Kategoriezuordnung anwenden em alemão, Appliquer le mappage des catégories em francês, Applica mappatura categorie em italiano e Aplicar Mapeamento de Categorias em português.

Esquema feito com código com o texto do botão em português, alemão, francês e italiano
Esquema feito com código a partir das traduções publicadas do módulo (não é um ecrã do Odoo): o rótulo do botão consoante o idioma 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)

O que acontece sem premir nada

Tenho de o premir de cada vez que altero um mapeamento de categorias?

Não. O caminho normal é automático: ao guardar um mapeamento de categorias, o módulo lança a mesma sincronização que o botão. Também se chega a ela ao criar um mapeamento novo. O botão fica para voltar a aplicar o mapeamento manualmente a toda a instância.

Que ofertas altera a gravação de um mapeamento?

Ao guardar, o módulo recolhe as instâncias e as categorias de artigo que o mapeamento tinha antes da alteração e as que tem depois, e junta-as. Por isso, se um mapeamento passa para outra categoria de artigo, recalculam-se tanto a anterior como a nova. Só entram as ofertas dessas instâncias cuja categoria de artigo é uma dessas ou uma subcategoria sua, e cuja categoria é tomada do mapeamento.

O que mais faz o módulo ao guardar um mapeamento?

Antes de guardar, completa os dados da categoria do Mirakl a partir do catálogo: o seu código, a sua etiqueta e o seu caminho. Parte da categoria que tenha escolhido, da instância e do código indicados ou, se editar uma só ficha, da categoria que já tinha. Os dados que já venham preenchidos nessa mesma gravação não são substituídos.

O que faz o botão, passo a passo

O que faz o botão ao ser premido?

No Odoo 20, o botão atua primeiro sobre uma só instância: a da ficha aberta. Depois procura as ofertas dessa instância cuja categoria é tomada do mapeamento. Ao contrário da gravação de um mapeamento, não limita por categoria de artigo, pelo que entram todas as que cumprem essa condição. A essas ofertas aplica o mapeamento de categorias e conta quantas atualizou. Por fim, publica uma mensagem com esse número na ficha da instância e mostra um aviso de sucesso.

O que verei no fim?

Um aviso intitulado Mirakl com o texto Mapeamento de categorias aplicado a … oferta(s). (Category mapping applied to … offer(s).), onde o código coloca o número de ofertas atualizadas. O aviso não fica fixo, o mesmo texto guarda-se como mensagem na ficha da instância e o ecrã recarrega no fim.

Em que difere do automático?

No alcance. Ao guardar um mapeamento, o módulo só percorre as ofertas das categorias de artigo afetadas. O botão percorre todas as ofertas da instância cuja categoria é tomada do mapeamento, sem tocar em nenhum mapeamento. Use-o quando quiser reaplicar o mapeamento a toda a instância.

O que verifico se o número do aviso não é o que esperava?

O número é devolvido pelo passo que aplica o mapeamento às ofertas encontradas, e a pesquisa só inclui ofertas da instância cuja ficha tem aberta e cuja categoria é tomada do mapeamento. Uma oferta de outra instância não entra: abra a ficha dessa outra instância e prima o botão aí. Também não entra uma oferta cuja categoria não seja tomada do mapeamento.

O que necessita e quanto custa

O que preciso para o usar?

O módulo é de pagamento único por versão do Odoo e precisa da subscrição do FlexigoTech Cloud: o plano Conector custa 49 €/mês ou 490 €/ano, sem IVA. A ligação passa pelo FlexigoTech Cloud, que guarda cifradas as credenciais, vigia a sincronização e avisa por e-mail se falhar. Está publicado no Odoo Apps para 17, 18, 19 e 20 (consulte a ficha ou a página do módulo). Com a subscrição, o módulo para as versões novas do Odoo vem incluído se o comprou em flexigotech.com; no Odoo App Store, cada versão compra-se lá.

Se lhe interessa outro botão do conector explicado da mesma forma, tem Cancelar no Mirakl. E se está a implementar o Odoo, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

O erro «Lance a fatura antes de a enviar para o Mirakl.» no Mirakl ConnectorQuando aparece o erro «Lance a fatura antes de a enviar para o Mirakl.» no Mirakl Connector para Odoo, o que o código verifica e como o resolver.A tarefa «Mirakl - Aceitar Encomendas», passagem a passagemO que faz em cada passagem a tarefa agendada Mirakl - Aceitar Encomendas do Mirakl Connector para Odoo, de quanto em quanto tempo corre e o que rever se não…O que faz o botão «Cancelar no Mirakl» do Mirakl Connector, passo a passoO que faz o botão Cancelar no Mirakl do Mirakl Connector para Odoo: quando aparece, o que verifica, o que muda na encomenda e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes