Pular para o conteúdo principal

Hub Marcas

A tela Hub Marcas — também conhecida como DE-PARA Marcas — faz a ponte entre o código/identificador de marca usado pelo canal de venda externo (Mercado Livre tem IDs próprios, Magalu usa outros, marketplaces europeus usam padrões diferentes) e a marca cadastrada no idworks. Cada linha é uma regra de tradução: quando um produto/anúncio vem do canal X com a marca Y, qual marca interna usar para classificá-lo no catálogo do idworks.

O nome "DE-PARA" vem do conceito clássico de integração: DE = o lado externo (canal de venda) → PARA = o lado interno (ERP idworks). A tela é uma lista CRUD simples (5 endpoints, 4 privilégios) com um modal de cadastro que mostra os dois lados separados por uma seta. Diferencial desta tela: cada linha tem um botão Reprocessar que reconsulta a marca direto no canal — útil para corrigir dados quando o canal alterou o nome ou ID da marca.

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. Não há validações especiais por tipo de integração — o mapeamento funciona igual para todos os canais.

Índice​

Conceito

Cadastro e edição

Reprocessamento

Regras de negócio

Referência rápida

O que é a tela Hub Marcas?​

É a tela onde você cadastra a tradução entre o código de marca usado pelo canal de venda externo e a marca cadastrada no idworks. Cada linha responde à pergunta "quando um produto chegar do canal X com a marca Y, qual marca interna usar?". A tela é puramente um catálogo de regras, com o adicional do reprocessamento por linha.

📍 Onde: menu lateral → Integrações → Hub Marcas.

O que significa "DE" e "PARA" no mapeamento?​

DE (canal externo)PARA (ERP idworks)
Origem do códigoO canal de venda (Mercado Livre, Magalu, Tray Commerce, etc.).Cadastrado em Produtos → Marcas.
IdentificaçãoIntegração (qual canal) + Código canal (string da marca no canal).Marca (marca do catálogo interno do idworks).

A direção do mapeamento é sempre canal → ERP: quando um produto/anúncio chega com determinado código de marca, o sistema procura nesta tela qual marca interna corresponde para classificar o item no catálogo idworks.

Para que serve esse mapeamento na prática?​

Marketplaces usam códigos próprios para representar marcas:

  • Mercado Livre retorna brand_id numérico (ex.: "206" = Samsung, "55" = Apple).
  • Magalu envia o nome da marca livremente como string.
  • Vtex tem um cadastro próprio de marcas com IDs internos da plataforma.

Sem o DE-PARA, o idworks não saberia que marca interna aplicar a um produto importado de um anúncio do canal. Com o mapeamento, o mesmo SKU pode ser anunciado em vários canais (cada um com seu código de marca próprio) e o sistema consegue consolidar tudo na mesma marca interna ("Samsung", "Apple").

Onde o mapeamento é consumido pelo sistema?​

Principal consumo: importação de ofertas/anúncios do canal. Quando uma oferta é importada do Mercado Livre com brand_id = "206", o sistema:

  1. Consulta esta tela para descobrir o código de marca interno correspondente.
  2. Aplica essa marca ao SKU criado/atualizado.
  3. Mantém o catálogo do idworks limpo e consolidado, sem duplicidade de marcas entre canais.

Também é usado quando o sistema envia produtos para o canal — para descobrir qual código de marca enviar ao canal a partir da marca interna do SKU.

Como criar um novo mapeamento DE-PARA?​

  1. Acesse Integrações → Hub Marcas.
  2. Clique em Novo.
  3. Preencha o lado DE (esquerda):
    • * Integração — selecione a integração configurada.
    • Código canal — escolha o código de marca na lista (carregada pela API do canal), ou digite manualmente.
  4. No lado PARA (direita):
    • * Marca — marca interna do idworks.
  5. Clique em Salvar.

Pré-requisito: privilégio Criar hub marcas.

Quais campos são obrigatórios?​

São obrigatórios:

  • Integração — qual canal de venda.
  • Marca — qual marca interna do idworks.

O Código canal é opcional no formulário (ao contrário de outras telas DE-PARA, esta não bloqueia mapeamento sem código). Útil para criar uma regra "fallback" para todos os anúncios da integração que não tenham marca específica mapeada.

Cadastros que você precisa ter antes​

  • Integração — em Configurações → Integrações.
  • Marca — em Produtos → Marcas.

Como adicionar um código de canal que não está na lista?​

Para canais cuja API não retorna a lista de marcas (ou quando o operador precisa cadastrar um código novo manualmente):

  1. Com a janela aberta, clique no campo Código canal.
  2. No final do dropdown, há um campo Digite... com um botão Adicionar.
  3. Digite o código exatamente como o canal usa e clique em Adicionar.
  4. O código aparece preenchido no campo principal.
  5. Salve.

Como editar um mapeamento existente?​

  1. Na lista, clique no ícone de lápis (ou duplo clique).
  2. Edite os campos.
  3. Salve.

Pré-requisito: privilégio Editar hub marcas.

Como excluir um mapeamento?​

  1. Na lista, clique no ícone de lixeira.
  2. Confirme.

Pré-requisito: privilégio Deletar hub marcas.

O que faz o botão Reprocessar?​

O botão Reprocessar (uma das ações de linha) consulta a API do canal para atualizar os dados da marca — útil quando:

  • O canal mudou o nome da marca (Mercado Livre fez rebranding).
  • O cadastro local ficou desatualizado.
  • A marca foi reclassificada no canal.
  1. Na linha do mapeamento, clique no ícone correspondente.
  2. Confirme na janela "Confirma reprocessar essa marca?".
  3. O sistema chama a API do canal usando a URL de recurso configurada para o tipo de integração.
  4. Os dados da marca são atualizados conforme o canal.

A operação consulta um worker externo e pode demorar alguns segundos.

Quando o reprocessamento falha com "Integração não tem recurso"?​

O reprocessamento depende de uma URL de recurso cadastrada no tipo de integração (em TypeSalesChannelResource com ResourceType = "Brand"). Quando esta URL não está cadastrada para a integração escolhida, o reprocessamento falha com "Integração não tem recurso".

Solução: verificar com o suporte se o canal específico tem o reprocessamento de marca habilitado. Nem todos os canais expõem este recurso — alguns só permitem reprocessar via reimportação completa do catálogo.

O que acontece quando uma integração é excluída?​

Quando uma integração é excluída em Configurações → Integrações, todos os mapeamentos de marca vinculados a ela são apagados automaticamente em cascata.

⚠️ Atenção: ao excluir uma marca interna em Produtos → Marcas, o sistema não bloqueia se existirem mapeamentos Hub apontando para ela — isso pode deixar as linhas órfãs. Quando precisar excluir uma marca usada aqui, exclua primeiro os mapeamentos correspondentes.

Resumo de parametrizações​

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. A configuração relevante vive em:

Onde configurarO que define
Configurações → IntegraçõesCadastra os canais de venda.
Produtos → MarcasCadastra as marcas internas do catálogo.

A capacidade de reprocessamento por linha depende do tipo da integração ter a URL de recurso configurada internamente — não há configuração pelo lojista.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar hub marcasAcesso à tela, à lista e à visualização dos mapeamentos.
Criar hub marcasBotão Novo e o cadastro de um novo mapeamento.
Editar hub marcasEdição de um mapeamento existente.
Deletar hub marcasExclusão de um mapeamento.