Começar de graça

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.

  1. Acesse Insumos > Unidades
  2. Clique em Sugerir Nova Unidade
  3. 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)
  4. 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#

  1. Acesse Insumos > Categorias
  2. Clique em Nova Categoria
  3. 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
  4. Clique em Criar Categoria

Criar subcategoria#

  1. Clique novamente em Nova Categoria
  2. Preencha:
    • Nome: Herbicidas
    • Descrição: Herbicidas seletivos e não seletivos
    • Categoria Pai: Defensivos
  3. 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#

  1. Clique em Nova Categoria
  2. Preencha:
    • Nome: Glifosato
    • Categoria Pai: Herbicidas
  3. 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.

  1. Acesse Insumos > Marcas
  2. Clique em Nova Marca
  3. Preencha:
    • Nome: Bayer (nome do fabricante ou linha)
    • Descrição: Fabricante de defensivos e sementes (opcional)
  4. 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.

  1. Acesse Insumos > Fornecedores
  2. Clique em Novo Fornecedor
  3. 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
  4. 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#

  1. Acesse Insumos > Insumos
  2. Clique em Novo Insumo
  3. 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)
  4. 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.
  5. 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:

  1. Abra o insumo pela Lista de Insumos
  2. Toque na seção Fornecedores para abrir a página de fornecedores do insumo
  3. Clique em Adicionar e selecione um fornecedor já cadastrado (ou use Criar Novo para cadastrar um fornecedor na hora)
  4. 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
  5. 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#

  1. Acesse Insumos > Categorias
  2. Veja a hierarquia completa na árvore
  3. 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