Códigos similares
A tela Códigos similares é onde você cadastra os códigos alternativos que apontam para um Grupo SKU. Cada linha representa um código (do fornecedor, do canal de venda, do XML da nota) que o sistema deve reconhecer como equivalente aos produtos do grupo, mesmo quando esse código é diferente do código de referência cadastrado no produto. A lista mostra o código, a tag de origem, o grupo SKU e a conta dona, e permite criar, editar e excluir os códigos.
Esta tela só cuida do cadastro do par código + grupo. O vínculo entre o grupo e os produtos é feito no cadastro do produto (aba Grupos SKU); o grupo em si é mantido em Produtos → Grupo SKU.
Índice
Conceito
- O que são códigos similares?
- Para que serve um código similar?
- Qual a diferença entre Grupo SKU e Código similar?
Cadastro e edição
Busca e visualização
Regras de negócio
- Posso ter o mesmo código em grupos diferentes?
- Por que o sistema não aceita meu código?
- Onde o código similar é usado depois de cadastrado?
- Posso cadastrar pela tela do produto?
Referência rápida
O que são códigos similares?
São códigos alternativos que apontam para um Grupo SKU. Cada código guarda três informações: o código em si (Cód. referência similar), o grupo SKU ao qual ele pertence e, opcionalmente, uma tag (texto livre) que identifica a origem desse código.
Quando o sistema recebe um pedido, uma nota fiscal ou um arquivo do fornecedor com um código que não é o de referência cadastrado no produto, ele consulta os códigos similares para descobrir qual grupo (e portanto quais produtos) corresponde àquele código.
📍 Onde: menu lateral → Produtos → Códigos similares.
Para que serve um código similar?
Serve para o sistema reconhecer o mesmo produto sob códigos diferentes. Casos típicos:
- O mesmo produto chega de fornecedores diferentes, cada um com seu código.
- O produto é vendido em vários canais (loja própria, marketplace, ERP do cliente) e cada canal usa um código.
- A nota fiscal de entrada vem com o código do fornecedor, que não bate com o código de referência do seu cadastro.
- O item tem mais de um código de barras e você quer que todos sejam tratados como o mesmo item.
Sem o código similar cadastrado, o sistema não consegue ligar o que chega ao produto correto e o usuário precisa fazer essa associação manualmente toda vez.
Qual a diferença entre Grupo SKU e Código similar?
| Grupo SKU | Código similar | |
|---|---|---|
| O que é | Um nome que agrupa produtos equivalentes. | Um código alternativo que aponta para um grupo. |
| Quando usar | Para juntar SKUs do mesmo item sob um nome. | Para informar ao sistema que um código externo corresponde àquele grupo. |
| Exemplo | Grupo "Caneca Branca 300ml". | Códigos 7891234500001, CAN-300-BR, ML-9988 apontando todos para o grupo "Caneca Branca 300ml". |
Você sempre cria o grupo primeiro (em Produtos → Grupo SKU) e depois cadastra os códigos similares que apontam para ele. Sem o grupo, o código não tem para onde apontar e o cadastro fica bloqueado.
Como cadastrar um código similar?
Cadastros que você precisa ter antes
- Grupo SKU — cadastrado em Produtos → Grupo SKU. Sem o grupo, o sistema não aceita o código (mostra "Grupo não existe").
Para cadastrar:
- Clique em Adicionar no topo da tela.
- Em ambiente com mais de uma conta, selecione a Conta dona do código.
- Selecione o Grupo SKU (busca pelo nome a partir de 3 caracteres).
- Informe o Cód. referência similar (campo obrigatório).
- Opcional: informe uma Tag referência similar (ex.: nome do fornecedor, do canal).
- Clique em Salvar.
O código passa a aparecer na lista e fica disponível para o sistema usar nas telas que reconhecem similares.
Pré-requisito: privilégio Criar Sku Códigos Similares.
Como editar um código similar?
Clique no ícone Editar (lápis) na linha. Você pode alterar o Grupo SKU, o Cód. referência similar e/ou a Tag. Clique em Salvar para confirmar.
A alteração vale imediatamente: a partir desse momento o código passa a apontar para o novo grupo (ou o novo valor passa a ser reconhecido).
Pré-requisito: privilégio Editar Sku Códigos Similares.
Como excluir um código similar?
Clique no ícone Remover (lixeira) na linha. Uma confirmação aparece; confirme para excluir.
A exclusão é direta — não há regra que trave a remoção. Depois de excluído, o código deixa de ser reconhecido pelas telas que usam similares.
Pré-requisito: privilégio Deletar Sku Códigos Similares.
Como filtrar os códigos?
Clique em Filtros para abrir o painel lateral. Os filtros disponíveis:
- Conta — separa por conta dona (aparece apenas quando você tem mais de uma conta).
- Nome grupo SKU — busca pelo nome do grupo SKU ao qual o código pertence.
- Cód. referência similar — busca pelo código exato.
- Tag referência similar — busca pelos códigos que carregam determinada tag.
Clique em Aplicar para atualizar a lista.
Para que serve a tag de referência similar?
A tag é um rótulo livre que você pode anexar ao código para identificar a origem. Exemplos: o nome do fornecedor que usa aquele código, o nome do canal de venda, "EAN antigo", "Importado". Não tem efeito nas regras do sistema — serve para você organizar e filtrar os códigos depois.
Quando você começa a digitar a tag no cadastro, o sistema oferece como sugestão as tags já em uso na sua conta — basta selecionar uma existente para manter a padronização.
Posso ter o mesmo código em grupos diferentes?
Sim. O mesmo valor de Cód. referência similar pode existir em grupos diferentes — o que o sistema impede é repetir o mesmo código dentro do mesmo grupo (mostra "Já existe esse código cadastrado para o grupo").
Na prática, isso significa que você pode usar um mesmo código para identificar produtos distintos em grupos distintos, mas dentro de um grupo cada código aparece uma única vez.
Por que o sistema não aceita meu código?
Duas situações principais bloqueiam o cadastro:
- "Grupo não existe" — o Grupo SKU selecionado não está cadastrado ou não pertence à sua conta. Crie/ajuste em Produtos → Grupo SKU.
- "Já existe esse código cadastrado para o grupo" — você já tem um código com esse mesmo valor no mesmo grupo. Edite o existente em vez de criar um novo, ou cadastre o código em outro grupo.
Onde o código similar é usado depois de cadastrado?
Em todas as telas e fluxos que precisam identificar um produto a partir de um código externo. Os principais:
- Importação de pedidos — quando o canal envia um código que não bate com o de referência, o sistema procura nos códigos similares.
- Recebimento de nota fiscal — o código do fornecedor no XML é casado com o produto via similar.
- Lista de produtos — você pode filtrar a busca pelo campo Cód. referência similar para localizar todos os produtos do grupo correspondente.
Você não precisa configurar nada além do cadastro nesta tela — o uso é automático.
Posso cadastrar pela tela do produto?
Sim. No cadastro do produto, na aba Grupos SKU, ao vincular o produto a um grupo você também pode adicionar códigos similares para aquele grupo direto pela janela Novo Código Similar. O resultado é o mesmo: o código fica gravado na mesma lista que esta tela mostra.
A vantagem desta tela é a visão consolidada de todos os códigos da conta (ou de todas as contas), permitindo busca, filtro e manutenção em massa.
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 Sku Códigos Similares | Acesso à tela e à lista de códigos. |
| Criar Sku Códigos Similares | Botão Adicionar. |
| Editar Sku Códigos Similares | Ícone Editar (lápis) na linha. |
| Deletar Sku Códigos Similares | Ícone Remover (lixeira) na linha. |