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 envia a marca interna para o canal, criando ou atualizando lá a marca correspondente.
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
- O que é a tela Hub Marcas?
- O que significa "DE" e "PARA" no mapeamento?
- Para que serve esse mapeamento na prática?
- Onde o mapeamento é consumido pelo sistema?
Cadastro e edição
- Como criar um novo mapeamento DE-PARA?
- Quais campos são obrigatórios?
- Cadastros que você precisa ter antes
- Como adicionar um código de canal que não está na lista?
- Como editar um mapeamento existente?
- Como excluir um mapeamento?
Reprocessamento
Regras de negócio
Boas práticas
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ódigo | O canal de venda (Mercado Livre, Magalu, Tray Commerce, etc.). | Cadastrado em Produtos → Marcas. |
| Identificação | Integração (qual canal) + Código canal (código ou nome 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_idnumérico (ex.:"206"= Samsung,"55"= Apple). - Magalu envia o nome da marca livremente como texto.
- 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:
- Consulta esta tela para descobrir a marca interna correspondente.
- Aplica essa marca ao SKU criado/atualizado.
- 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?
- Acesse Integrações → Hub Marcas.
- Clique em Novo.
- 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.
- No lado PARA (direita):
- * Marca — marca interna do idworks.
- 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). Isso existe porque alguns canais permitem cadastrar a marca antes de saber o código usado por eles — o código é preenchido depois, ao reprocessar a linha. Não existe uma regra coringa que aplique uma marca padrão a anúncios sem marca mapeada: cada linha corresponde a um código específico do canal.
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):
- Com a janela aberta, clique no campo Código canal.
- No final do dropdown, há um campo Digite... com um botão Adicionar.
- Digite o código exatamente como o canal usa e clique em Adicionar.
- O código aparece preenchido no campo principal.
- Salve.
Como editar um mapeamento existente?
- Na lista, clique no ícone de lápis (ou duplo clique).
- Edite os campos.
- Salve.
Pré-requisito: privilégio Editar hub marcas.
Como excluir um mapeamento?
- Na lista, clique no ícone de lixeira.
- 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) envia os dados da marca interna para o canal, criando ou atualizando lá a marca correspondente — útil sobretudo para canais que hospedam a própria loja do lojista (como Vtex ou Tray Commerce). Na primeira execução para uma marca ainda sem vínculo, o sistema cria a marca no canal e grava aqui o código retornado.
- Na linha do mapeamento, clique no ícone correspondente.
- Confirme na janela "Confirma reprocessar essa marca?".
- O sistema chama o worker do canal e envia os dados da marca interna.
A operação depende de 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 de marca cadastrada no tipo de integração do canal. 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 expõe o recurso de reprocessamento de marca.
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.
Boas práticas para o mapeamento de marcas
Um mapeamento de marca bem feito é o que mantém o catálogo consolidado, sem a mesma marca duplicada entre canais. Recomendações:
- Cadastre a marca interna e a integração antes de criar a regra. O lado da marca é um seletor de Produtos → Marcas e o lado do canal só lista integrações configuradas — sem esses dois cadastros prontos, não dá para montar o mapeamento.
- Copie o código de marca do canal exatamente como ele aparece. Cada marketplace usa seu próprio código (um número no Mercado Livre, o nome em texto no Magalu) — uma diferença faz o produto importado não casar com a marca interna certa.
- Só deixe o Código canal em branco quando o canal ainda não informou o código da marca. O campo é opcional para esses casos — o código é preenchido depois, ao reprocessar a linha. Não existe um mapeamento coringa que aplique uma marca padrão a anúncios sem marca mapeada, então mantenha o código preenchido sempre que ele estiver disponível.
- Use o Reprocessar para criar ou atualizar a marca no canal. Ele envia os dados da marca interna para o canal — útil sobretudo em canais que hospedam a própria loja do lojista (como Vtex ou Tray Commerce), e essencial na primeira vinculação, quando ainda não existe um código de marca do lado do canal.
- Ao excluir uma marca interna, apague antes os mapeamentos que apontam para ela. O sistema não bloqueia esse caso, então sobram linhas órfãs aqui — limpe os mapeamentos antes de remover a marca em Produtos → Marcas.
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 configurar | O que define |
|---|---|
| Configurações → Integrações | Cadastra os canais de venda. |
| Produtos → Marcas | Cadastra 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égio | Libera |
|---|---|
| Visualizar hub marcas | Acesso à tela, à lista e à visualização dos mapeamentos. |
| Criar hub marcas | Botão Novo e o cadastro de um novo mapeamento. |
| Editar hub marcas | Edição de um mapeamento existente. |
| Deletar hub marcas | Exclusão de um mapeamento. |