AreaCacao Docs

Gerencie o preço de um ingrediente: cinco estratégias de cálculo, histórico de compras, perda e registros manuais.

O que é

A tela de detalhe é onde você gerencia o custo de um ingrediente específico: escolhe com qual estratégia o preço vigente dele é calculado, registra as suas compras e referências manuais, e aplica a perda que encarece o preço efetivo.

Na tela, esta visualização aparece como Detalhe de custo (com o breadcrumb Custos → Detalhe de custo) e o subtítulo dela é “Estratégia + histórico completo de compras.”. Aqui a chamamos de Detalhe de um ingrediente como nome descritivo.

Como acessar

Caminho: https://app.areacacao.com/costs/ingredients/[id]
Como chegar: em Preços de ingredientes, clique em Detalhe na linha do ingrediente. Você volta à lista pelo link Voltar à lista.

O que você vê

Cabeçalho e KPIs

No topo você vê o ícone, o nome, o identificador e a categoria do ingrediente, junto ao botão Adicionar registro. Abaixo, quatro indicadores:

Preço atual — o preço vigente de acordo com a estratégia ativa, na moeda do seu perfil e por quilo (/kg), ou por litro (/L) se todos os registros do ingrediente estiverem em volume.
Média ponderada — média dos preços do histórico, ponderada pela quantidade comprada, na mesma unidade.
Registros — quantas entradas o histórico tem.
Última compra — data do registro de compra mais recente.

Se o ingrediente ficar sem registros (por exemplo, depois de você excluir o último), aparece também o botão Remover da tabela de preços. Ele pede confirmação (“Este ingrediente não tem registros de preço. Removê-lo da tabela de preços? Suas receitas não mudam.”) e leva você de volta à lista.

Receitas que usam este preço

Se alguma das suas receitas usar o ingrediente, um quadro azul avisa: “Este preço é usado em N receitas” — “A ficha de custo de cada receita guarda o próprio preço, então ela não se atualiza sozinha. Abra a receita e o painel de Custos oferece aplicar o preço novo com um clique.” Abaixo aparecem até oito receitas como links para a aba Custos delas (e, se houver mais, “e mais N receitas”).

Abas

Duas abas: Estratégia de preço e Histórico.

Estratégias de preço

O preço vigente de um ingrediente não é um número fixo: ele é determinado pela estratégia que você escolher. Na aba Estratégia de preço há cinco cartões:

Estratégia	O que faz
Última compra	Usa o preço do registro de compra mais recente. Reflete o custo de aquisição atual.
Preço mais alto	Usa o preço mais alto do histórico. Conservador para orçar: protege as margens contra aumentos.
Média ponderada	Média ponderada pela quantidade comprada. Suaviza oscilações pontuais.
Manual	Você informa o preço e a perda manualmente. Útil quando não há compras registradas ou quando você quer fixar uma referência.
Registro específico	Você escolhe um registro específico do histórico como preço vigente.

As três primeiras (Última compra, Preço mais alto, Média ponderada) são aplicadas na hora: você clica no cartão e ela fica ativa.

As outras duas abrem um formulário contextual:

Manual — campos Preço-base sem perda (€/kg) (com a sua moeda e a unidade da tabela) e Perda (%). A tela calcula e mostra o Preço final com perda. Clique em Aplicar.
Registro específico — um seletor com os registros do histórico (formato data · fornecedor · preço final). Se o registro não tiver fornecedor, você verá Sem fornecedor no lugar, e os registros do tipo manual ganham o sufixo (manual) no final. Escolha um e clique em Aplicar este registro. Se não houver histórico, você verá “Não há registros no histórico. Adicione pelo menos um para poder usar esta estratégia.”

A perda

A perda é a parte do ingrediente que se perde no processo (cascas, aparas, evaporação, ajustes). Ela encarece o custo efetivo, porque para obter uma quantidade útil você precisa comprar mais.

O AreaCacao a aplica com esta fórmula sobre o preço-base:

preço final = preço-base / (1 - perda/100)

Por exemplo, com um preço-base de € 10/kg e uma perda de 20%, o preço final é 10 / (1 - 0,20) = € 12,50/kg.

Registrar uma compra ou referência

Clique em Adicionar registro (ou Primeiro registro / Adicionar primeiro registro se o histórico estiver vazio). Abre-se o modal Novo registro de preço, com o subtítulo “Uma compra real ou uma referência manual do preço do ingrediente.”

Escolha o tipo de registro

Um seletor entre Compra real e Referência manual. Uma compra real reflete uma aquisição concreta; uma referência manual é um preço indicativo para quando você não comprou.

Preencha os dados

Data (obrigatória).
Fornecedor — seletor; você pode deixar — sem fornecedor —.
Preço unitário (obrigatório).
Unidade (obrigatória): por g, por kg, por ml, por L ou por unidade. Se você escolher g ou ml, o modal mostra a equivalência na tabela de preços (“Equivale a … /kg na tabela de preços.”).
Quantidade comprada — só em compra real.
Perda % — se você a informar, o modal mostra um aviso com o Preço final com perda.
Observações — opcional.

Salve

Clique em Salvar registro (ou Cancelar para descartar). O registro entra no histórico e o preço vigente é recalculado de acordo com a estratégia ativa.

Se você informar um preço unitário inválido, o modal avisa com “Informe um preço unitário válido”.

O histórico

A aba Histórico lista todos os registros com as colunas Data, Tipo, Fornecedor, Quantidade, Preço s/ perda, Perda %, Preço final e Ações.

O Tipo pode ser Compra (compra real) ou Manual (referência).
Nos registros por g ou por ml, abaixo do Preço final aparece o equivalente por kg ou por L, a unidade da tabela.
Em Fornecedor, os registros que vieram da aba Custos de uma receita aparecem como Da receita; ao passar o mouse por cima, uma dica mostra Definido na receita [id da receita].
Para excluir um registro, use a ação de excluir dele; o app pede confirmação: “Excluir este registro? O preço vigente será recalculado.”

Se o histórico estiver vazio, você verá “Ainda sem registros. Adicione compras reais ou referências manuais de preço para calcular o custo deste ingrediente nas suas receitas.”

Detalhe de um ingrediente