Organizando seu Catálogo de Insumos
Este guia mostra como organizar seu catálogo criando categorias hierárquicas, sugerindo unidades de medida, criando marcas, fornecedores, cadastrando insumos e gerenciando estoque.
Passo 1: Sugerir Unidades de Medida#
As unidades de medida fazem parte de um catálogo compartilhado da plataforma — você não cria uma unidade diretamente, mas pode sugerir uma nova quando a que precisa ainda não existe. A maioria das unidades comuns (kg, L, peça, caixa, metro) já está disponível.
- Acesse Insumos > Unidades
- Clique em Sugerir Nova Unidade
- Preencha:
- Nome: ex: Arroba, Dúzia, Fardo
- Símbolo: ex: @, dz, fd
- Descrição: quando usar esta unidade (opcional)
- Permite Quantidades Fracionárias: Sim (permite 1.5 kg, 2.3 kg, etc.) ou apenas valores inteiros (1 peça, 3 caixas)
- Clique em Enviar Sugestão
A sugestão é enviada para ser adicionada ao catálogo. Se já existir uma unidade ou sugestão com o mesmo símbolo, o envio é bloqueado.
Dica: Antes de sugerir, procure a unidade desejada na lista — ela provavelmente já existe. Com fracionamento permite vendas como 1.5 kg ou 2.75 litros; sem fracionamento aceita apenas valores inteiros.
Passo 2: Criar Categorias Hierárquicas#
Criar categoria pai#
- Acesse Insumos > Categorias
- Clique em Nova Categoria
- Preencha:
- Nome: Defensivos
- Descrição: Defensivos agrícolas em geral
- Categoria Pai: selecione Nenhuma (Categoria Raiz) para criar uma categoria de nível mais alto
- Clique em Criar Categoria
Criar subcategoria#
- Clique novamente em Nova Categoria
- Preencha:
- Nome: Herbicidas
- Descrição: Herbicidas seletivos e não seletivos
- Categoria Pai: Defensivos
- Clique em Criar Categoria
Dica: Você também pode abrir a categoria pai e usar Nova Subcategoria (na árvore ou na página de detalhes) para já criar a filha com o pai preenchido.
Criar sub-subcategoria#
- Clique em Nova Categoria
- Preencha:
- Nome: Glifosato
- Categoria Pai: Herbicidas
- Clique em Criar Categoria
Resultado da hierarquia:
Defensivos
└── Herbicidas
└── Glifosato
Passo 3: Cadastrar Marcas#
Marcas permitem organizar seus insumos por fabricante ou linha, facilitando a busca e os filtros no catálogo.
- Acesse Insumos > Marcas
- Clique em Nova Marca
- Preencha:
- Nome: Bayer (nome do fabricante ou linha)
- Descrição: Fabricante de defensivos e sementes (opcional)
- Clique em Criar Marca
Repita para outras marcas do seu catálogo:
- Syngenta
- Yara
- John Deere
Dica: Você também pode criar marcas diretamente pelo formulário de insumo, clicando em Criar nova marca na seção Marca.
Gerenciar marcas#
Na página de detalhes de cada marca você pode:
- Editar Marca — atualizar nome e descrição
- Ativar/Inativar Marca — marcas inativas não aparecem no formulário de insumo
- Ver a quantidade de insumos associados
Passo 4: Cadastrar Fornecedores#
Fornecedores permitem registrar os parceiros comerciais que abastecem sua propriedade, vinculando-os aos insumos com código e preço de custo.
- Acesse Insumos > Fornecedores
- Clique em Novo Fornecedor
- Preencha as informações básicas:
- Nome: Nome do fornecedor
- Tipo de Pessoa: Pessoa Física ou Jurídica — define se será pedido CPF ou CNPJ
- Clique em Criar Fornecedor
Campos adicionais (opcional)#
O formulário é dividido em seções. Todos os campos abaixo são opcionais:
| Seção | Campos |
|---|---|
| Tipo de Pessoa | Pessoa Física/Jurídica, CPF ou CNPJ, Gênero e Data de Nascimento (Pessoa Física) |
| Contato | Nome do Contato, E-mail, Telefone, WhatsApp, Website, Observações |
| Dados Legais | Razão Social, Inscrição Estadual, Inscrição Municipal |
| Endereço | CEP, Logradouro, Número, Complemento, Bairro, Estado e Cidade |
Dica: Cada fornecedor pode ter vários endereços (Principal, Faturamento, Entrega e Outro). Gerencie-os pela ação Endereços na página de detalhes do fornecedor.
Gerenciar fornecedores#
Na página de detalhes de cada fornecedor você pode:
- Editar Fornecedor — atualizar todas as informações cadastradas
- Ativar/Inativar Fornecedor — fornecedores inativos não aparecem no formulário de insumo
- Gerenciar os Endereços do fornecedor
- Ver os Insumos vinculados
Dica: Cadastre os fornecedores antes de registrar muitos insumos. Assim você pode vincular cada insumo ao seu fornecedor com o código e preço de compra.
Passo 5: Cadastrar Insumo#
- Acesse Insumos > Insumos
- Clique em Novo Insumo
- Na seção Informações Básicas, preencha:
- Nome: Glifosato 480 SL
- Unidade de Medida: Litro (obrigatório)
- Descrição: Herbicida sistêmico não seletivo, 480 g/L (opcional)
- Categoria: Glifosato (opcional)
- Na seção Preços, informe o Preço de Custo (ex: 28,90) — é o preço que alimenta o custo por hectare das operações de campo.
- Clique em Criar
Demais campos do formulário (opcional)#
O restante do formulário é dividido em seções:
| Seção | Campos |
|---|---|
| Identificação | SKU (código interno único, ex: HERB-GLIF-480) e Código de Barras (EAN, UPC ou outro padrão) |
| Preços | Preço de Custo (alimenta o custo da operação de campo) |
| Marca | Marca do insumo (ou Criar nova marca ali mesmo) |
| Atributos Físicos | Peso em gramas (ex: 250), Altura, Largura e Comprimento em cm |
| Dados Fiscais | NCM (8 dígitos), CEST (7 dígitos) e Origem (Nacional, Importado, Nacional com conteúdo importado, Adquirido no mercado interno) |
| Estoque | Estoque Mínimo (quantidade para alerta de estoque baixo) |
Vincular fornecedores ao insumo#
O vínculo com fornecedores não é feito no formulário de criação. Ele acontece na página de detalhes do insumo, na seção Fornecedores:
- Abra o insumo pela Lista de Insumos
- Toque na seção Fornecedores para abrir a página de fornecedores do insumo
- Clique em Adicionar e selecione um fornecedor já cadastrado (ou use Criar Novo para cadastrar um fornecedor na hora)
- Informe os dados do vínculo:
- Código do Fornecedor — código do insumo no catálogo do fornecedor
- Custo de Compra — valor de aquisição junto a esse fornecedor
- Fornecedor Principal — marque para definir como fornecedor padrão
- Clique em Salvar Alterações
Você pode vincular vários fornecedores ao mesmo insumo, editar os dados de cada vínculo ou removê-los pela própria página.
Importante: O vínculo de fornecedores é feito na página de detalhes do insumo (seção Fornecedores), e não no formulário de criação.
Passo 6: Visualizar e Filtrar#
Ver árvore de categorias#
- Acesse Insumos > Categorias
- Veja a hierarquia completa na árvore
- Clique em uma categoria para ver seus insumos e subcategorias
Filtrar insumos#
Na lista de insumos, use o botão de filtros para refinar a busca:
- Status: Rascunho, Ativo ou Inativo
- Marca: Filtra por fabricante ou linha
- Estoque baixo: Exibe insumos abaixo do estoque mínimo
Módulo de Insumos no Hub#
O módulo de insumos exibe duas abas no hub:
| Aba | Conteúdo |
|---|---|
| Insights | Widget de estoque (scorecards de SKUs, estoque baixo, zerado) e dicas do módulo |
| Cadastros | Acesso rápido a Insumos, Categorias, Unidades, Marcas e Fornecedores |
Dicas do Módulo#
O hub exibe dicas contextuais para ajudar na configuração do catálogo:
- Cadastre seu Primeiro Insumo — guia para criar o primeiro insumo com preços e categorias
- Use SKU e Código de Barras — identificação padronizada para agilizar vendas e estoque
- Organize Insumos por Marca — cadastre marcas para categorizar por fabricante e facilitar filtros
- Cadastre seus Fornecedores — registre fornecedores e vincule aos insumos com código e custo de compra
Clique em Saiba mais em qualquer dica para ver o guia completo com exemplos e links de documentação.
Permissões#
| Permissão | Descrição |
|---|---|
catalog:product:list |
Listar insumos |
catalog:product:read |
Visualizar detalhes do insumo |
catalog:product:create |
Cadastrar insumos |
catalog:product:update |
Editar insumos |
catalog:category:list |
Listar categorias |
catalog:category:create |
Criar categorias |
catalog:category:read |
Visualizar categoria |
catalog:category:update |
Editar categorias |
catalog:brand:list |
Listar marcas |
catalog:brand:create |
Criar marcas |
catalog:brand:update |
Editar marcas |
supplier:supplier:list |
Listar fornecedores |
supplier:supplier:create |
Cadastrar fornecedores |
supplier:supplier:update |
Editar fornecedores |
inventory:stock:read |
Ver estoque atual |
inventory:stock:add |
Registrar entradas de estoque |
Unidades de medida: listar/visualizar unidades e enviar uma sugestão de nova unidade não exigem permissão específica — qualquer usuário autenticado pode fazê-lo. A administração do catálogo compartilhado de unidades (criar/editar diretamente) é feita pela plataforma.
Dicas#
- Planeje a hierarquia: Defina suas categorias principais antes de criar subcategorias
- Nomes descritivos: Use nomes claros para facilitar a busca
- Unidades consistentes: Padronize unidades por tipo de insumo
- Categorias flexíveis: Você pode mover insumos entre categorias depois
- Unidade obrigatória: Todo insumo precisa de uma unidade de medida
- Categoria opcional: Insumos podem ficar sem categoria
- Marcas antes de insumos: Cadastre as marcas antes de cadastrar muitos insumos
- Fornecedores organizados: Cadastre fornecedores com dados legais e contato para facilitar compras e reposição
- Nomes oficiais de marca: Use nomes consistentes (ex: "Syngenta" em vez de "syngenta")
- SKU único: O SKU deve ser único por tenant — use um padrão como
[TIPO]-[MARCA]-[NUM] - Estoque mínimo: Configure o estoque mínimo para receber alertas de reposição
- NCM correto: Informe o NCM correto para garantir a tributação adequada nas notas fiscais