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) coloca a oferta em modo de mapeamento, procura o código que lhe corresponde no mapeamento de categorias e reescreve o código de categoria e a categoria Mirakl dessa oferta. No fim mostra um aviso de sucesso se encontrou mapeamento e um de advertência se não encontrou, e recarrega a ficha.

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 quando aparece

Está no ecrã Ofertas Mirakl (Mirakl Offers), que se abre a partir do menu Mirakl › Operações › Ofertas (Mirakl › Operations › Offers). O troço Mirakl do menu exige a permissão base.group_user; se não a tiveres, não vês esse troço.

Segundo a condição da sua vista, o botão Aplicar Mapeamento de Categorias aparece sempre, e existe nas versões 17, 18, 19 e 20 do Odoo. O que se segue descreve o código do Odoo 20.

Esquema feito com código, não um ecrã do Odoo: o menu Mirakl › Operations › Offers e, por baixo, o botão Apply Category Mapping, presente no Odoo 17, 18, 19 e 20
Esquema do caminho até ao botão, feito a partir do código publicado 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)

Passo a passo

  1. Vê primeiro se o Odoo já o fez sozinho. O Odoo chega à mesma sincronização que o botão usa ao criar um mapeamento de categorias, ao guardá-lo, ao criar uma oferta e ao guardar uma oferta em que mudas a instância, o produto, o modo de sincronização de categoria ou a categoria Mirakl. Nesses caminhos, o código da oferta também é esvaziado se o mapeamento não der nenhum. Só são tocadas as ofertas que já estão em modo de mapeamento.
  2. Abre Mirakl › Operações › Ofertas e entra na oferta que queres rever.
  3. Carrega em Aplicar Mapeamento de Categorias quando quiseres aplicá-lo à mão. Além de sincronizar, o botão coloca a oferta em modo de mapeamento. Atua sobre uma única oferta.
  4. Lê o aviso que aparece com o título Mirakl: é de sucesso ou de advertência (explico-o mais abaixo). Não fica fixo no ecrã.
  5. Quando termina, a ficha recarrega sozinha. Verifica o código de categoria e a categoria Mirakl da oferta.

O que o botão faz por dentro, por ordem

  • Primeiro guarda o modo. Coloca a sincronização de categoria da oferta em modo de mapeamento. Isto acontece antes de verificar o que quer que seja: se depois surgir a advertência, a oferta já está nesse modo.
  • Depois verifica se há mapeamento. Comprova se o mapeamento de categorias dessa oferta dá um código. Se der, o aviso será de sucesso; se não, de advertência.
  • Calcula o código novo. É o que o mapeamento dá. Se o mapeamento não der nenhum, o código de categoria da oferta fica vazio.
  • Calcula a categoria Mirakl. Se o mapeamento aponta para uma categoria Mirakl, usa essa. Se só traz um código, procura na mesma instância uma categoria Mirakl com esse código (a primeira que encontrar). Se o mapeamento não traz nem categoria nem código, mantém a categoria Mirakl que a oferta já tinha.
  • Compara e escreve. Se o código e a categoria da oferta já coincidem com esses valores, não escreve nada. Se não, guarda os dois.
  • Avisa e recarrega. Mostra o aviso e recarrega a vista.

Os avisos do botão

No fim, o botão mostra um aviso com o título Mirakl, numa de duas variantes:

AvisoTomQuando apareceO que fazer
Mapeamento de categorias aplicado. (Category mapping applied.)SucessoO mapeamento da oferta dá um código de categoriaVerifica o código de categoria e a categoria Mirakl da oferta
Nenhum mapeamento de categoria encontrado para este produto. (No category mapping found for this product.)AdvertênciaO mapeamento não dá nenhum códigoRevê o mapeamento de categorias desse produto; ao criá-lo ou guardá-lo, o Odoo lança a mesma sincronização, e depois podes voltar a carregar no botão

Casos que convém perceber

  • Advertência não significa que nada tenha mudado. O modo já foi guardado e, como o mapeamento não dá código, o código de categoria da oferta fica vazio. A categoria Mirakl que a oferta já tivesse mantém-se como estava.
  • Sucesso com a categoria Mirakl vazia. Se o mapeamento traz um código e nessa instância não existe nenhuma categoria Mirakl com esse código, o código é guardado e a categoria Mirakl fica vazia. O aviso é de sucesso porque a única coisa que mede é se o mapeamento dá um código.
  • Nada para alterar. Se a oferta já coincide com o mapeamento, o botão não escreve nela; verás na mesma o aviso e o recarregamento.
Esquema feito com código a partir das traduções publicadas do módulo, não um ecrã do Odoo: o texto do botão consoante o idioma do Odoo, em castelhano Aplicar asignación de categorías, em alemão Kategoriezuordnung anwenden, em francês Appliquer le mappage des catégories, em italiano Applica mappatura categorie e em português Aplicar Mapeamento de Categorias
Esquema (não é uma captura do Odoo) com o nome do botão em cada idioma publicado: castelhano Aplicar asignación de categorías, alemão Kategoriezuordnung anwenden, francês Appliquer le mappage des catégories, italiano Applica mappatura categorie e português Aplicar Mapeamento de Categorias.

O que custa e como a FlexigoTech te ajuda

O Mirakl Connector é um módulo de pagamento único por versão do Odoo (publicado para 17, 18, 19 e 20) e precisa da subscrição do FlexigoTech Cloud, por onde passa a ligação: plano Conector, 49 €/mês ou 490 €/ano, sem IVA. O preço de cada versão está na ficha do Odoo Apps, e podes ver mais sobre o módulo na sua página em flexigotech.com.

Se estás a implementar o Odoo e queres que as categorias das tuas ofertas fiquem bem atribuídas desde o início, a FlexigoTech implementa o Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Para veres como se explica outro botão do módulo com o mesmo detalhe, tens o que faz o botão «Cancelar no Mirakl».

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