Catálogo de insumos

O que é

O catálogo de insumos é a tela onde você cadastra e mantém todos os seus insumos: cada material não comestível com o custo por unidade, a unidade de consumo, o fornecedor e, se quiser, campos próprios. É um catálogo por usuário (é você quem cria; não existe uma base global como nos ingredientes) e é a fonte de onde as receitas tiram os dados quando você adiciona insumos.

Ele funciona numa única tela: não há sub-rotas (/supplies/catalog, /supplies/categories…). Tudo (busca, filtros, cadastro, edição, campos personalizados e importação/exportação) é feito daqui, por meio de modais.

Como acessar

• URL: https://app.areacacao.com/supplies
• Como chegar: menu lateral → FORMULAÇÃO → Insumos.
• Disponibilidade: qualquer usuário com sessão iniciada (sem restrição por plano).
• O antigo /insumos redireciona para cá.

Seções da tela

Cabeçalho

No topo você encontra o link Voltar ao painel e o título Catálogo de insumos, com um subtítulo que mostra a contagem real de insumos (“N insumos no seu catálogo”) ou, se você ainda não tiver nenhum, “Recipientes, etiquetas, embalagem e materiais de consumo não comestíveis”.

À direita há quatro botões:

• Novo insumo — abre o formulário para criar um insumo com a ficha completa. Veja Criar um insumo.
• Gerenciar categorias — abre o painel para renomear, excluir ou adicionar categorias de insumo. Veja Categorias de insumos.
• Campos personalizados — abre o gerenciador para definir campos próprios dos seus insumos (material, lote, certificação…). Veja Campos personalizados.
• Importar / Exportar — abre o modal para exportar ou carregar o seu catálogo em CSV. Veja Importar e exportar.

Barra de filtros

Acima da tabela há uma barra com quatro controles:

• Campo de busca com o texto de exemplo “Buscar por nome, código ou fornecedor…”. Busca por nome (inclusive o nome em inglês), código interno (SKU), código do fornecedor, fornecedor, descrição e notas.
• Seletor de categoria com a opção padrão Todas as categorias (carregadas a partir das suas categorias gerenciadas).
• Seletor de fornecedor com a opção padrão Todos os fornecedores.
• Só com controle de estoque — caixa de seleção que limita a lista aos insumos com estoque ativado.

Ao mudar qualquer filtro, a lista volta para a página 1.

Tabela de resultados

Cada linha mostra estas colunas:

Clique em qualquer linha para abrir a ficha de detalhe do insumo.

Paginação

A lista mostra 50 insumos por página. Quando há mais de uma página, aparece um rodapé com o intervalo visível (“Mostrando X–Y de TOTAL”) e as setas Página anterior / Próxima página.

Criar um insumo

Clique em Novo insumo para abrir o formulário, com o texto de apoio “Materiais não comestíveis rateados por unidade de produto vendável.”. Ele é organizado em seções:

• Identificação — Nome (obrigatório), Nome (inglês) opcional, Categoria (veja Categorias), Descrição, Fornecedor, Código do fornecedor e Código interno (SKU).
• Unidades e compra — o modelo de unidade dupla:
  • Unidade de consumo — a unidade que você vai usar na receita (ex.: unidade, folha, metro).
  • Unidade de compra — como você compra (ex.: caixa com 500).
  • Unidades de consumo por unidade de compra — o fator (ex.: uma caixa com 500 forminhas → 500). Serve para calcular o custo por unidade de consumo.
• Custo — Custo por unidade de consumo e o Subtotal da ficha de custo (onde esse custo é agrupado: Insumos, Ingredientes ou Custos gerais; por padrão, Insumos).
• Estoque (opcional) — Controlar o estoque deste insumo ativa o inventário permanente no Estoque, com um Alerta de estoque baixo.
• Informações adicionais — URL da imagem, Observações e os Campos personalizados que você tiver definido.

Clique em Criar insumo para salvar (ou em Salvar alterações ao editar).

Campos personalizados

Como nos ingredientes, você pode ampliar os seus insumos com campos próprios da sua conta (material, lote, certificação…). Clique em Campos personalizados no cabeçalho para abrir o gerenciador:

• A lista N campos definidos com cada campo (Rótulo, Chave, Tipo, Obrigatório) e ações de editar/excluir.
• Novo campo abre um editor com Rótulo (obrigatório), Chave interna em snake_case (gerada automaticamente, não editável depois), Tipo (Texto, Número, Data, Lista ou Sim / Não), Opções (só para Lista), Texto de ajuda e a caixa Campo obrigatório.

Excluir um campo não apaga os valores já registrados nos seus insumos. Os valores de cada campo são preenchidos dentro de cada insumo, na seção Informações adicionais do formulário.

Importar e exportar

Clique em Importar / Exportar para abrir o modal (subtítulo “Cadastre insumos em massa ou baixe o seu catálogo.”), com duas abas:

Importar

• Baixar modelo fornece modelo-insumos.csv com as colunas corretas e duas linhas de exemplo (uma forminha e uma caixa de bombons) no idioma do app.
• Envie o conteúdo arrastando um CSV, com Selecionar arquivo ou colando-o diretamente (“…ou cole o conteúdo diretamente”).
• A seção expansível Como preparar o CSV lembra as regras principais:
  • name é a única coluna obrigatória.
  • purchaseUnit, trackingUnit e purchaseToTrackingFactor definem o modelo de unidade dupla (você compra em “caixa com 500” e consome em “unidade”).
  • costPerUnit é o custo por unidade de consumo, na moeda da sua conta.
  • costBucket aceita insumos, ingredientes ou overhead.
  • As categorias novas são criadas automaticamente como categorias gerenciadas.
• O seletor Modo decide como a importação é aplicada:

Antes de confirmar, você pode Pré-visualizar: aparece um resumo do tipo “N linhas — criar X, atualizar Y, ignorar Z, erros W”. Clique em Importar para aplicar.

Exportar

Baixa todo o seu catálogo em CSV (insumos.csv), uma linha por insumo com todas as colunas. As colunas de campos personalizados são adicionadas com o prefixo cf_; o campo allergens não se aplica a insumos.

Histórico de custo

Cada vez que o custo de um insumo muda, o AreaCacao registra a alteração. Ao abrir a ficha de detalhe (clique em uma linha), você verá, além dos dados gerais e das unidades, uma seção Histórico de custo com a data, o custo Antes, o custo Depois e uma Observação para cada alteração. Se ainda não houver alterações, aparece “Ainda não há alterações de custo registradas.”.

Estados da tela

• Carregando: mostra um esqueleto da tabela.
• Catálogo vazio: “Você ainda não tem insumos” + “Adicione recipientes, etiquetas, forminhas, caixas ou qualquer material não comestível para incluí-los no custo das suas receitas.” com um botão Novo insumo.
• Nenhum resultado com os filtros: “Nenhum insumo com esses filtros.”.
• Erro de carregamento: faixa vermelha com “Não foi possível carregar os insumos”.

Disponibilidade por plano

Disponível em todos os planos.

Próximos passos