Catálogo de consumíveis

O que é

O catálogo de consumíveis é o ecrã onde regista e mantém todos os seus consumíveis: cada material não comestível com o seu custo por unidade, a sua unidade de consumo, o seu fornecedor e, se quiser, os seus próprios campos. É um catálogo por utilizador (é criado por si; não existe uma base global como nos ingredientes) e é a fonte a que as receitas recorrem quando adiciona consumíveis.

Funciona num único ecrã: não há sub-rotas (/supplies/catalog, /supplies/categories…). Tudo — pesquisa, filtros, registo, edição, campos personalizados e importação/exportação — é feito a partir daqui, através de modais.

Como aceder

• URL: https://app.areacacao.com/supplies
• Como lá chegar: menu lateral → FORMULAÇÃO → Consumíveis.
• Disponibilidade: qualquer utilizador com sessão iniciada (sem restrições por plano).
• O antigo /insumos redireciona para aqui.

Secções do ecrã

Cabeçalho

No topo encontra a ligação Voltar ao painel e o título Catálogo de consumíveis, com um subtítulo que mostra o número real de consumíveis («N consumíveis no seu catálogo») ou, se ainda não tiver nenhum, «Recipientes, etiquetas, embalagem e materiais não comestíveis».

À direita há quatro botões:

• Novo consumível — abre o formulário para criar um consumível com a ficha completa. Ver Criar um consumível.
• Gerir categorias — abre o painel para mudar o nome, eliminar ou adicionar categorias de consumíveis. Ver Categorias de consumíveis.
• Campos personalizados — abre o gestor para definir campos próprios dos seus consumíveis (material, lote, certificação…). Ver Campos personalizados.
• Importar / Exportar — abre o modal para exportar ou carregar o seu catálogo em CSV. Ver Importar e exportar.

Barra de filtros

Por cima da tabela há uma barra com quatro controlos:

• Pesquisa com o texto de exemplo «Pesquisar por nome, código ou fornecedor…». Pesquisa por nome (incluindo o nome em inglês), código interno (SKU), referência do fornecedor, fornecedor, descrição e notas.
• Seletor de categoria com a opção predefinida Todas as categorias (carregadas a partir das suas categorias geridas).
• Seletor de fornecedor com a opção predefinida Todos os fornecedores.
• Só com controlo de stock — caixa de verificação que limita a lista aos consumíveis com o stock ativado.

Sempre que altera um filtro, a lista volta à página 1.

Tabela de resultados

Cada linha mostra estas colunas:

Clique em qualquer linha para abrir a ficha de detalhe do consumível.

Paginação

A lista mostra 50 consumíveis por página. Quando há mais de uma página, aparece um rodapé com o intervalo visível («A mostrar X–Y de TOTAL») e as setas Página anterior / Página seguinte.

Criar um consumível

Clique em Novo consumível para abrir o formulário, com o subtítulo «Materiais não comestíveis repartidos por unidade de produto vendável.». Está organizado em secções:

• Identificação — Nome (obrigatório), Nome (inglês) opcional, Categoria (ver Categorias), Descrição, Fornecedor, Referência do fornecedor e Código interno (SKU).
• Unidades e compra — o modelo de dupla unidade:
  • Unidade de consumo — a unidade que vai usar na receita (p. ex. unidade, folha, metro).
  • Unidade de compra — a forma como o compra (p. ex. caixa de 500).
  • Unidades de consumo por unidade de compra — o fator (p. ex. uma caixa de 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 este custo é agrupado: Consumíveis, Ingredientes ou Custos gerais; por predefinição, Consumíveis).
• Stock (opcional) — Controlar o stock deste consumível ativa o inventário permanente no Stock, com um Alerta de stock baixo.
• Informações adicionais — URL da imagem, Notas e os Campos personalizados que tiver definido.

Clique em Criar consumível para o guardar (ou em Guardar alterações ao editar).

Campos personalizados

Tal como nos ingredientes, pode alargar os seus consumíveis com campos próprios da sua conta (material, lote, certificação…). Clique em Campos personalizados no cabeçalho para abrir o gestor:

• A lista N campos definidos com cada campo (Rótulo, Chave, Tipo, Obrigatório) e as ações de editar/eliminar.
• Novo campo abre um editor com Rótulo (obrigatório), Chave interna em snake_case (gerada automaticamente e 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.

Eliminar um campo não apaga os valores já registados nos seus consumíveis. Os valores de cada campo são preenchidos dentro de cada consumível, na secção Informações adicionais do formulário.

Importar e exportar

Clique em Importar / Exportar para abrir o modal (subtítulo «Registe consumíveis em massa ou transfira o seu catálogo.»), com dois separadores:

Importar

• Transferir modelo dá-lhe o ficheiro modelo-consumiveis.csv com as colunas corretas e duas linhas de exemplo (uma forminha de papel e uma caixa de bombons) no idioma da aplicação.
• Forneça o conteúdo arrastando um CSV, com Selecionar ficheiro ou colando-o diretamente («…ou cole o conteúdo diretamente»).
• A secção expansível Como preparar o CSV recorda as regras principais:
  • name é a única coluna obrigatória.
  • purchaseUnit, trackingUnit e purchaseToTrackingFactor definem o modelo de dupla unidade (compra em «caixa de 500», 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 geridas.
• O seletor Modo decide como a importação é aplicada:

Antes de confirmar, pode Pré-visualizar: é apresentado um resumo do tipo «N linhas — criar X, atualizar Y, ignorar Z, erros W». Clique em Importar para aplicar.

Exportar

Transfira todo o seu catálogo em CSV (consumiveis.csv), com uma linha por consumível e todas as colunas. As colunas de campos personalizados são acrescentadas com o prefixo cf_; o campo allergens não se aplica a consumíveis.

Histórico de custo

Sempre que o custo de um consumível muda, o AreaCacao regista-o. Ao abrir a ficha de detalhe (clique numa linha) verá, além dos dados gerais e das unidades, uma secção Histórico de custo com a data, o custo Antes, o custo Depois e uma Nota para cada alteração. Se ainda não houver alterações, indica «Ainda não há alterações de custo registadas.».

Estados do ecrã

• A carregar: mostra o esqueleto de uma tabela.
• Catálogo vazio: «Ainda não tem consumíveis» + «Adicione recipientes, etiquetas, forminhas, caixas ou qualquer material não comestível para os incluir no custo das suas receitas.» com um botão Novo consumível.
• Sem resultados com os filtros: «Não há consumíveis com esses filtros.».
• Erro de carregamento: faixa vermelha com «Não foi possível carregar os consumíveis».

Disponibilidade por plano

Disponível em todos os planos.

Próximos passos