Ingredientes personalizados

O que é

O catálogo de ingredientes é uma base global e compartilhada de mais de 10.000 fichas verificadas, somente leitura para todos os usuários. Os ingredientes personalizados são o outro lado: fichas que você cria, privadas da sua conta, com a mesma riqueza de dados das do catálogo.

Eles servem para tudo o que a base global não cobre: uma matéria-prima de um fornecedor específico, um preparo próprio, um produto regional ou qualquer insumo com os seus valores nutricionais e o seu custo. Depois de criados, são usados nas suas receitas e formuladores como qualquer ingrediente do catálogo.

Como acessar

• URL: https://app.areacacao.com/ingredients
• Como chegar: menu lateral → seção FORMULAÇÃO → Ingredientes.
• Disponibilidade: qualquer conta conectada, sem restrição por plano.

A tela se chama Catálogo de ingredientes e tem um seletor de duas abas:

• Catálogo — a base global, somente leitura.
• Meus ingredientes — os ingredientes personalizados da sua conta.

O botão Novo ingrediente fica no cabeçalho, à direita, ao lado de Campos personalizados e Importar / Exportar.

Criar um ingrediente

Campos da ficha

Todos os valores nutricionais são por 100 g. Os campos numéricos aceitam vírgula decimal (por exemplo 2,5).

Identificação

• Nome (obrigatório)
• Código próprio — o seu SKU ou referência interna.
• Nomes alternativos — separados por vírgulas.
• Categoria — campo de texto livre: você pode escrever qualquer valor ou escolher uma das sugestões da lista, que são categorias do catálogo (Derivados do cacau, Laticínios, Adoçantes, Gorduras e óleos, Oleaginosas e sementes, Frutas, Condimentos, Aditivos e agentes de textura, Bebidas alcoólicas). As sugestões aparecem no idioma da interface; se você escolher uma, a ficha fica nessa categoria do catálogo e o nome dela é traduzido quando você muda de idioma.
• Subcategoria
• Marca
• Fornecedor — seletor com busca ligado à sua lista de fornecedores: escolha um existente, Sem fornecedor, ou digite um nome novo e clique em Criar “…”.

Informação nutricional (por 100 g)

Água, gorduras, gorduras saturadas, carboidratos, açúcares, proteína, fibra, sal, álcool (etanol), calorias (kcal), manteiga de cacau e cacau total (%).

• Manteiga de cacau: só a gordura que vem do cacau (chocolate, cobertura, manteiga de cacau); em laticínios e manteiga, deixe em branco.
• Álcool (etanol): gramas de etanol por 100 g, para vinhos e licores.
• Água não informada: se você não informar a água, nenhum valor é salvo e a validação a trata como desconhecida, não como 0. Se o ingrediente não tem água, escreva 0.
• Estimativa da água: com gorduras, carboidratos e proteína preenchidos (um 0 conta), o formulário oferece uma “Estimativa indicativa por diferença” (100 − gorduras − carboidratos totais − proteína − sal, subtraindo também a fibra e o álcool declarados) com um botão Usar. Se você usar, o campo passa a se chamar Água (estimada) e a ficha a salva marcada como estimada. Quando há fibra, você escolhe se no seu rótulo ela vem separada dos carboidratos (rotulagem da UE: é subtraída) ou incluída neles (EUA ou Canadá: não é subtraída de novo). Em uma bebida alcoólica, a estimativa só aparece se você declarar o álcool.
• Energia calculada: com as calorias em branco e gorduras, carboidratos e proteína preenchidos, o formulário propõe a energia segundo o Regulamento (UE) 1169/2011, anexo XIV (9 × gorduras + 4 × carboidratos + 4 × proteína + 2 × fibra + 7 × álcool), também com um botão Usar. Nada é preenchido sozinho.
• Tabela vazia: se você não informar nenhum valor nutricional, o formulário avisa que a validação não vai conseguir contar este ingrediente na composição das suas receitas.

Micronutrientes

Seção recolhível, fechada por padrão, com 20 micronutrientes e mais dois valores adicionais:

• Vitaminas (11): A, D, E, K, C, B1 (tiamina), B2 (riboflavina), B3 (niacina), B6, B9 (folato) e B12.
• Minerais (9): cálcio, ferro, magnésio, fósforo, potássio, zinco, cobre, manganês e selênio.
• Outros (2): colesterol e cafeína.

Alergênicos

Seleção por caixas da lista oficial da UE (14): glúten, crustáceos, ovos, peixe, amendoim, soja, leite, castanhas e nozes, aipo, mostarda, gergelim, sulfitos, tremoço e moluscos. É um modelo simples de “contém”: a ficha do ingrediente não registra traços (os traços são marcados na receita). Veja Alergênicos UE-14.

Há três situações possíveis:

• Com alergênicos marcados: a ficha contém esses alergênicos.
• Nenhum marcado: ao salvar, você confirma que ele não contém nenhum dos 14 (“Nenhum alergênico marcado: ao salvar, você confirma que este ingrediente não contém nenhum dos 14.”).
• Ainda não conheço os alergênicos dele (ficam não declarados): caixa que desativa a lista. A ficha não é salva como “sem alergênicos”: as receitas que levarem este ingrediente vão avisar que a declaração de alergênicos está incompleta até você declará-los.

Conservantes

Seção recolhível e opcional Este ingrediente tem conservante?, com quatro respostas: Não sei (a inicial), Não tem conservante, É um conservante e Tem um entre os ingredientes. As duas últimas pedem a substância e, no último caso, a quantidade. Veja Como usar o semáforo de conservantes.

Propriedades físicas

• Unidade base — gramas por padrão.
• Densidade (g/ml) — necessária para converter volumes (ml, L) em peso.
• Peso por unidade (g) — necessário para converter unidades em peso.

Custo

• Preço por kg — um custo de referência para a ficha, na moeda da sua conta. O histórico de compras e a estratégia de preço por fornecedor ficam no módulo de Custos.

Observações

Texto livre para qualquer observação.

Ver, editar e excluir

Na aba Meus ingredientes você verá a lista das suas fichas. Se ainda não criou nenhuma, a aba mostra um estado vazio com o título “Você ainda não tem ingredientes próprios”, o texto “Crie fichas sob medida com seus macros, alergênicos e preços. Elas ficarão disponíveis nas suas receitas e formulações.” e um botão Novo ingrediente.

Quando há fichas, o mesmo lembrete de revisão do formulário aparece acima da tabela. Na tabela, quando uma ficha tem Código próprio, ele aparece como um selo ao lado do nome, e a coluna Alergênicos mostra o número de alergênicos, um traço (nenhum) ou Não declarados. Para cada linha:

• Ver — clique na linha para abrir a ficha completa.
• Editar — o botão com ícone de lápis reabre o formulário com os dados carregados.
• Excluir — o botão com ícone de lixeira a remove (com confirmação).

Usar em uma receita

Ao adicionar ingredientes no editor de receitas ou nos formuladores, a busca de ingredientes mostra também os seus ingredientes personalizados, marcados com a etiqueta Meu para distingui-los do catálogo global.

Eles são adicionados e calculados exatamente como os do catálogo: somam os seus macros ao total da receita e participam da conversão de unidades por densidade ou peso por unidade. Por isso vale a pena declarar a densidade e o peso por unidade se você for usar o ingrediente em mililitros ou unidades.

Ingredientes personalizados vs. campos personalizados

São duas coisas diferentes e complementares:

Resumindo: os ingredientes personalizados acrescentam fichas; os campos personalizados acrescentam campos a essas fichas.

Referência técnica

Para integrações ou suporte. A API é autenticada com a sessão do usuário (o userId é obtido pelo servidor, nunca pelo cliente):

• IDs: prefixo ci_ (o catálogo global usa outros identificadores).
• Persistência: tabela custom_ingredients; os campos desta ficha foram implantados com a migração Drizzle 0070 (em produção). Macros e micronutrientes são salvos em JSON; os alergênicos, como uma lista restrita aos UE-14, ou null quando não foram declarados.
• Validação: o backend usa um esquema estrito (rejeita campos desconhecidos) e limita os alergênicos à lista oficial.

Próximos passos