Extensão: Referências Cruzadas de Produtos

O que é a extensão Referências Cruzadas

A extensão Referências Cruzadas (código produtos_referencias_cruzadas) permite cadastrar códigos alternativos para os seus produtos — o código que o fornecedor usa, o código do fabricante, o nome que o cliente dá ao item, ou o SKU de uma empresa parceira. Com isso, é possível encontrar um produto por qualquer um desses códigos e importar XML de fornecedor sem precisar recodificar tudo na mão.

Ela também agrupa produtos equivalentes em grupos, facilitando a substituição automática quando um item da mesma família está em falta e outro está disponível.

Como instalar e ativar

1. No menu lateral, acesse Extensões.
2. Localize Referências Cruzadas.
3. Ative para a empresa atual.
4. Confirme.

A partir daí, o cadastro do produto ganha uma nova aba e a importação de XML passa a consultar o mapa de referências automaticamente.

Como acessar

No menu lateral, acesse Cadastros → Produtos → Referências Cruzadas. Rota: /produtos/referencias-cruzadas. Também é possível acessar pela aba Referências dentro do cadastro de um produto individual.

Estrutura

Grupo de referência

Um grupo reúne produtos equivalentes ou substituíveis. Exemplo: "Parafuso M10 × 50" pode agrupar o seu item ABC123, o item XYZ789 do Fornecedor A e o item REF-001 do Fabricante B. Todos são funcionalmente iguais.

Produto com código alternativo

Dentro do grupo, cada produto recebe um ou mais códigos alternativos, cada um associado a uma fonte (fornecedor específico, fabricante, cliente, EAN alternativo).

Como usar

Cadastro manual

1. Abra a tela de Referências Cruzadas.
2. Crie um grupo com nome descritivo (ex.: "Parafuso M10 × 50").
3. Vincule ao grupo o seu produto principal.
4. Adicione os códigos alternativos — cada um com o fornecedor ou cliente que usa aquela codificação.

Importação de XML do fornecedor

Quando você importa um XML de nota fiscal de entrada, o Bunto lê o código que o fornecedor colocou no XML (geralmente não é o seu código). A extensão intercepta a leitura e busca o mapeamento:

• Se encontra o código no mapa, faz o vínculo com o seu produto automaticamente.
• Se não encontra, pergunta — e você pode criar o mapeamento ali mesmo, para que nas próximas importações o sistema reconheça.

Com o tempo, o mapa fica cada vez mais completo e a importação de XML vira quase automática.

Busca por código alternativo

A busca global de produtos (em vendas, compras, PDV, restaurante) passa a consultar também os códigos alternativos. Se o cliente pede "XYZ789" ao telefone, você digita esse código e encontra o seu produto correspondente, mesmo que internamente ele tenha outro SKU.

Compatíveis e substituição

Quando um produto está em falta, a API retorna os compatíveis — outros itens do mesmo grupo de referência. Isso permite oferecer rapidamente uma alternativa ao cliente.

Integrações com outros módulos

Produtos

Cada produto pode ter vários grupos e vários códigos alternativos. O cadastro ganha uma aba dedicada.

Compras e NF de entrada

A importação de XML consulta automaticamente o mapa de referências.

Vendas, PDV e Restaurante

A busca de produtos passa a aceitar também os códigos alternativos, facilitando atendimento.

Necessidades de Compra

Quando você roda o cálculo, produtos compatíveis podem ser consolidados — útil para analisar a demanda total de um grupo, não só de um código específico.

Catálogo e site público

O catálogo digital pode exibir os códigos alternativos para facilitar o encontro do cliente que lembra do nome antigo ou do nome do fabricante.

Permissões

• Listar referências cruzadas.
• Visualizar referência.
• Criar referência.
• Editar referência.
• Excluir referência.

Perguntas frequentes

Posso ter o mesmo código alternativo em dois produtos diferentes?

Não recomendamos. O ideal é que cada código alternativo aponte para um produto único, ou que pertença ao mesmo grupo de referência. Ambiguidades atrapalham a busca.

Como importo uma lista grande de códigos de fornecedor?

Use a importação por planilha (CSV) — colunas com o seu código, o código do fornecedor e o nome do fornecedor. O sistema cria os mapeamentos em lote.

Um mesmo produto pode estar em vários grupos?

Sim. É útil quando um produto é genuinamente equivalente a produtos de grupos diferentes (por exemplo, duas famílias de peças que se substituem entre si).

A extensão afeta o desempenho do sistema?

A busca passa a consultar uma tabela extra, mas com índice otimizado o impacto é mínimo. Em operações muito grandes, os benefícios (menos erros, importação automática) compensam com folga.

Posso desativar a extensão depois?

Sim. Os mapeamentos ficam preservados no banco, mas a busca por código alternativo e a consulta automática na importação de XML deixam de funcionar até você reativar.