Catálogo de ingredientes
Base global de mais de 10.000 ingredientes com macros, alergênicos e densidade verificados.
O que é
O catálogo de ingredientes é a base comum sobre a qual se apoia toda a formulação do AreaCacao. Ele reúne mais de 10.000 fichas técnicas (macronutrientes, alergênicos UE-14, densidade e peso por unidade) que alimentam o editor de receitas, os formuladores e o cálculo automático de macros.
A base global é somente leitura: você pode buscar, filtrar e consultar a ficha completa de qualquer ingrediente, mas os dados dela não são editados nesta tela. O que é seu: você pode criar os seus próprios ingredientes personalizados (fichas privadas que são usadas nas suas receitas como as do catálogo), definir campos personalizados para a sua conta e importar ou exportar o seu próprio catálogo personalizado.
O catálogo de ingredientes é só para materiais comestíveis. As embalagens, as forminhas, os rótulos, as caixas e outros consumíveis não comestíveis ficam em um módulo próprio: Insumos.
Como acessar
- URL:
https://app.areacacao.com/ingredients - Como chegar: menu lateral → seção FORMULAÇÃO → Ingredientes.
- Disponibilidade: acessível para qualquer usuário conectado (sem restrição por plano).
Seções da tela
Cabeçalho
Na parte de cima você encontra o link Voltar ao painel e o título Catálogo de ingredientes. Abaixo do título aparece um subtítulo dinâmico com o número de fichas da listagem, do tipo “Base global de N ingredientes com macros e alergênicos verificados.” O número é o total de resultados da listagem atual: muda quando você busca ou filtra. Enquanto não há resultados (durante o carregamento ou se os filtros não retornam nada), você vê o texto padrão “Base global de mais de 10.000 ingredientes com macros e alergênicos verificados.”.
A tela tem duas abas: Catálogo (a base global) e Meus ingredientes (os ingredientes personalizados da sua conta). Depois que você abre a aba Meus ingredientes, se tiver fichas próprias, ela mostra ao lado do nome um selo com o número de ingredientes personalizados ativos.
À direita do cabeçalho há três botões:
- Novo ingrediente — abre o formulário para criar um ingrediente personalizado com a ficha completa (macros, micronutrientes, alergênicos e custo).
- Campos personalizados — abre o gerenciador para definir campos próprios da sua conta (origem, certificação, lote etc.). Veja Campos personalizados.
- Importar / Exportar — abre o modal para exportar ou carregar o seu catálogo personalizado em JSON ou CSV. Veja Importar e exportar.
Barra de filtros
Acima da tabela há uma barra horizontal de filtros com três controles:
- Campo de busca com o placeholder “Buscar por nome, marca...”.
- Seletor de categoria com a opção padrão Todas as categorias. As categorias são carregadas a partir do catálogo; não são uma lista fixa.
- Com alergênicos — caixa de seleção que limita a listagem aos ingredientes que declaram algum alergênico UE-14.
Ao mudar qualquer filtro, a listagem volta para a página 1.
Filtrar por etiquetas
Abaixo da barra de filtros há uma seção Etiquetas que permite restringir o catálogo por características transversais. É um filtro de seleção múltipla: clique nos chips que interessam e a listagem se reduz. Dentro de um mesmo eixo, basta o ingrediente ter uma das etiquetas marcadas; entre eixos diferentes, ele precisa cumprir todos (por exemplo, Orgânico + Torrado mostra os ingredientes orgânicos que também são torrados). Quando há etiquetas ativas, aparece um botão Limpar (N) que remove todas de uma vez. Qualquer mudança faz a listagem voltar para a página 1.
Os chips estão agrupados por eixos:
| Eixo | Etiquetas |
|---|---|
| Origem | Origem única, Orgânico |
| Dieta | Vegetal / Vegano, Sem açúcar, Integral |
| Processamento | Cru, Torrado, Alcalinizado |
| Uso | Decoração, Granola, Cozinha, Snacks, Confeitaria, Saladas, Geleias, Smoothies, Compotas, Sobremesas, Preparado / mistura |
| Família química | Poliol, Goma, Polissacarídeo |
| Fonte | Leite de cabra |
Tabela de resultados
Cada linha da listagem mostra estas colunas:
| Coluna | Conteúdo |
|---|---|
| Nome | Nome do ingrediente, com a etiqueta base quando é um ingrediente base. |
| Categoria | Categoria principal. |
| Marca | Marca ou origem (fica oculta em telas pequenas). |
| Alergênicos | Número de alergênicos UE-14 declarados; um traço se a ficha declara que não tem nenhum; Não declarados se a ficha não confirma os seus alergênicos (fica oculto em telas estreitas). |
| Detalhe | Link Ver que abre a ficha completa. |
Clique em qualquer linha para abrir a ficha do ingrediente.
Paginação
A listagem mostra 50 ingredientes por página. Quando há mais de uma página, aparece um rodapé com o intervalo visível (“Mostrando X–Y de TOTAL”), as setas Página anterior / Próxima página e o indicador da página atual.
Ações disponíveis
| Ação | Como |
|---|---|
| Buscar | Digite no campo de busca; a listagem é filtrada sozinha após uma breve pausa. |
| Filtrar por categoria | Escolha uma categoria no seletor. |
| Filtrar por alergênicos | Marque a caixa Com alergênicos. |
| Filtrar por etiquetas | Clique nos chips da seção Etiquetas (seleção múltipla); use Limpar (N) para removê-las. |
| Consultar uma ficha | Clique na linha ou no link Ver dela. |
| Criar um ingrediente próprio | Clique em Novo ingrediente. Veja Ingredientes personalizados. |
| Definir campos próprios | Clique em Campos personalizados. |
| Importar ou exportar | Clique em Importar / Exportar. |
Estados da tela
- Carregando: linhas de esqueleto enquanto a listagem chega.
- Sem resultados: “Nenhum ingrediente com esses filtros.”.
- Erro de carregamento: banner vermelho com a mensagem do sistema ou o aviso “Erro ao carregar ingredientes”.
- Limite diário de consultas: cada conta pode pedir até 2.000 páginas do catálogo por dia (listagem e busca). Se passar disso, o banner vermelho diz “Você consultou o catálogo mais de 2.000 vezes hoje. Ele volta a ficar disponível amanhã; se precisar do catálogo completo, escreva para o suporte.”.
O catálogo global é comum a toda a plataforma e não é editado pela interface. Se você precisar de dados próprios do fornecedor, use Campos personalizados para ampliar as informações ou Importar / Exportar para manter o seu catálogo personalizado.
Próximos passos
Ingredientes personalizados
Crie as suas próprias fichas privadas e use-as nas suas receitas.
Buscar ingredientes
Como encontrar rápido o que você precisa?
Ficha do ingrediente
O que inclui a ficha completa de um ingrediente?
Importar e exportar
Exporte ou carregue o seu catálogo personalizado em JSON ou CSV.
Campos personalizados
Defina campos próprios para a sua conta.
Nível de confiança
De onde vêm os dados de cada ficha?
Alergênicos UE-14
Os 14 oficiais e onde aparecem no app.