Um catálogo mal estruturado espalha problemas pela empresa. O comercial vende uma descrição, o estoque separa outra e a integração precisa adivinhar qual código representa o item. Cores, tamanhos, embalagens e unidades passam a ser escritos no nome, dificultando comparação e manutenção.
Este guia explica como desenhar um catálogo para sistemas empresariais, separando identidade, apresentação e regras de uso. Não existe uma estrutura universal para todos os setores. O projeto precisa representar as diferenças que afetam compra, venda, estoque e atendimento, sem criar campos para situações que a empresa não utiliza.
1. Defina o que constitui um item distinto
Dois produtos parecidos podem exigir identidades separadas se forem comprados, vendidos ou movimentados de forma independente. Uma variação apenas visual pode ter outro tratamento. A decisão deve considerar como a operação reconhece e controla o objeto, não somente como deseja exibi-lo no site.
Comece com exemplos concretos. Uma camiseta de tamanho diferente pode possuir saldo próprio. Uma embalagem com seis unidades pode ser vendida como conjunto ou ser apenas uma forma de transporte. Um serviço não possui necessariamente estoque, mas pode exigir unidade, duração e regras comerciais.
Escreva a identidade do item em termos que pessoas de áreas diferentes concordem. Se compras e vendas utilizam o mesmo código para objetos distintos, o problema não será resolvido apenas com uma nova tela de cadastro.
2. Separe produto conceitual e variante operacional
Um produto conceitual pode agrupar características compartilhadas, como marca, descrição geral e categoria. A variante representa a combinação que possui identidade operacional própria: tamanho, cor, material ou outra característica relevante.
Evite gerar automaticamente todas as combinações possíveis. Uma coleção pode ter quatro cores e seis tamanhos, mas nem todas as combinações são comercializadas. Criar variantes inexistentes produz códigos sem uso e aumenta o risco de pedidos incorretos.
| Camada | Conteúdo típico | Decisão que suporta |
|---|---|---|
| Produto | Descrição e características comuns | Organização e apresentação |
| Variante | Combinação efetivamente comercializada | Pedido e saldo específicos |
| Embalagem | Quantidade e forma de acondicionamento | Compra, separação e transporte |
| Unidade | Base de quantidade e conversão | Cálculo e movimentação |
| Código externo | Identidade em outro sistema | Integração e correspondência |
3. Trate atributos como dados, não como texto escondido
Se tamanho e material são necessários para filtrar, comparar ou integrar, registre-os de maneira estruturada. Extrair essas informações do nome do produto exige convenções frágeis. Uma pequena mudança de escrita pode quebrar uma regra que parecia funcionar.
Defina vocabulários e tipos adequados. Cor pode ter um nome comercial; dimensão precisa de valor e unidade; capacidade pode admitir faixas. Não transforme todo atributo em uma lista livre de texto quando a operação precisa de comparação consistente.
Ao mesmo tempo, preserve descrições humanas úteis. Estrutura não significa substituir informação por códigos incompreensíveis. A interface deve apresentar rótulos claros e permitir que o usuário reconheça o item antes de confirmar uma operação.
4. Unidades e conversões exigem precisão contextual
Uma caixa pode conter quantidades diferentes conforme o produto e a embalagem. Não mantenha uma regra global “caixa = 12” se isso não for verdade para todos os itens. A conversão deve estar vinculada à configuração correta e à sua vigência quando necessário.
Considere se a conversão é exata ou depende de medição. Uma embalagem de dez unidades é diferente de um volume cujo peso varia. Quando o valor efetivo é medido, o sistema precisa registrar a quantidade observada, não substituir automaticamente por uma média sem identificação.
O pedido, a movimentação e a cobrança precisam indicar a base utilizada. Ao converter, preserve os dados necessários para explicar o resultado. Arredondamento de quantidade também pode ter impacto: não é possível separar uma fração de item indivisível apenas porque a conta decimal permitiu.
5. Use identificadores conforme sua finalidade
Um código interno identifica o registro dentro da aplicação. Um SKU pode atender à organização comercial. Códigos padronizados de mercado possuem regras próprias. A explicação oficial da GS1 sobre GTIN e códigos de barras é uma referência para entender a função desse identificador; não invente códigos que aparentem seguir um padrão sem validar sua utilização.
Separe identidade de descrição. O nome pode ser corrigido sem alterar o identificador estável. Códigos externos devem ter origem e contexto, pois o mesmo texto pode representar itens diferentes em sistemas distintos.
Quando houver correspondência ambígua em uma importação, encaminhe para revisão. Criar automaticamente outro produto para qualquer código desconhecido pode multiplicar duplicatas e contaminar o catálogo. A velocidade da importação não deve substituir a qualidade da identificação.
6. Kits e composições precisam de regras explícitas
Um kit pode ser vendido como conjunto, separado em componentes ou produzido previamente. Cada modelo afeta disponibilidade e movimentação. Se o kit só é montado na expedição, sua disponibilidade depende dos componentes; se já está pronto, pode possuir saldo próprio.
Defina substituições permitidas, quantidade de cada componente e tratamento de devolução parcial. Um conjunto com duas peças não deve voltar integralmente ao saldo se o cliente devolveu apenas uma. O sistema precisa relacionar a operação à composição utilizada naquela venda.
Versione mudanças de composição quando alterarem o significado operacional. Um pedido antigo precisa continuar explicável mesmo que o kit atual tenha outro componente. Essa é uma decisão de rastreabilidade e atendimento, não apenas uma preocupação técnica.
7. Exemplo: venda por caixa e controle por unidade
Considere um distribuidor que controla um produto por unidade e vende também uma caixa com seis. O pedido de três caixas representa dezoito unidades, mas o documento comercial pode preservar a apresentação escolhida pelo cliente.
Se o fornecedor passa a entregar embalagens com oito, a alteração não deve transformar pedidos antigos de três caixas em vinte e quatro unidades. A configuração anterior continua vinculada à operação histórica. A nova embalagem precisa de identificação e conversão adequadas.
Se duas unidades estiverem bloqueadas, a disponibilidade de caixas completas deve considerar a quantidade elegível e as regras de separação. Um saldo total de dezoito não garante três caixas vendáveis quando parte não pode ser utilizada.
8. Integre catálogo e conteúdo sem misturar responsabilidades
O conteúdo comercial pode variar por canal, enquanto a identidade operacional permanece comum. Um marketplace exige campos específicos; o portal B2B utiliza outros. Defina quem mantém descrições, imagens, características e informações operacionais.
Uma sincronização não deve sobrescrever dados aprovados apenas porque recebeu um valor vazio. Diferencie ausência de informação, exclusão intencional e atualização. Esse cuidado é especialmente importante em categorias e atributos usados por regras de estoque ou precificação.
Para estruturar as relações, o centro de engenharia de software da A2CR reúne conteúdos sobre dados e arquitetura. O catálogo precisa funcionar como parte do sistema, não como um arquivo isolado de descrições.
9. Critérios de teste e manutenção
Monte casos com variantes existentes e inexistentes, códigos externos repetidos, kits, devoluções e mudança de embalagem. Confira a mesma operação em venda, separação e relatório. Uma diferença de unidade pode passar despercebida na tela e aparecer somente na cobrança.
Estabeleça uma fila de qualidade para atributos ausentes, imagens inadequadas e correspondências incertas. Conte quantidade de itens efetivamente utilizáveis, não apenas registros cadastrados. Um catálogo grande com dados incompletos pode ser menos útil que um catálogo menor e coerente.
Checklist de implantação
- Definir identidade operacional de produto e variante.
- Criar somente combinações realmente utilizadas.
- Estruturar atributos relevantes para decisões.
- Separar unidades e embalagens.
- Documentar conversões e arredondamentos.
- Preservar configurações de operações históricas.
- Identificar a origem de códigos externos.
- Modelar kits e devoluções parciais.
- Distinguir atualização, ausência e exclusão de dados.
- Testar o percurso entre venda, estoque e cobrança.
Checklist para usar com sua equipe
Baixe o checklist editável em CSV e registre a conferência, o responsável e as observações da implantação.
Perguntas frequentes
Devo criar um produto para cada embalagem?
Depende de como ela é identificada e controlada. A embalagem pode ser uma apresentação do mesmo item ou uma identidade operacional distinta. A decisão deve considerar estoque, códigos, compra e venda.
Posso usar o nome como identificador?
Não é uma boa base para integrações e histórico. Nomes mudam e podem se repetir. Utilize identificadores estáveis e preserve a descrição para reconhecimento humano.
A IA pode preencher todos os atributos?
Pode preparar sugestões e organizar descrições, mas características operacionais precisam de fonte confiável e validação. Uma dimensão ou composição inventada pode causar erro de venda, transporte ou uso.
Para organizar variantes, unidades e integrações, prepare seu briefing com exemplos de produtos que hoje geram confusão. A A2CR pode desenhar um catálogo alinhado à operação.
Autoria: Agência A2CR. Preparação editorial: 12 de novembro de 2026. Exemplos hipotéticos; padrões de identificação e requisitos setoriais devem ser verificados no projeto.
