AreaCacao Docs

Faça a gestão do preço de um ingrediente: cinco estratégias de cálculo, histórico de compras, quebra e registos manuais.

O que é

O ecrã de detalhe é onde gere o custo de um ingrediente concreto: escolhe com que estratégia é calculado o seu preço em vigor, regista as suas compras e referências manuais e aplica a quebra que encarece o preço efetivo.

No ecrã, esta vista aparece como Detalhe de custo (com o trilho de navegação Custos → Detalhe de custo) e o seu subtítulo é «Estratégia + histórico completo de compras.». Aqui chamamos-lhe Detalhe de um ingrediente como nome descritivo.

Como aceder

Rota: https://app.areacacao.com/costs/ingredients/[id]
Como lá chegar: em Preços de ingredientes, clique em Detalhe na linha do ingrediente. Volta à lista com a ligação Voltar à lista.

O que vê

Cabeçalho e KPI

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

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

Se o ingrediente ficar sem registos (por exemplo, depois de eliminar o último), aparece também o botão Retirar da tabela de preços. Pede confirmação («Este ingrediente não tem registos de preço. Retirá-lo da tabela de preços? As suas receitas não mudam.») e leva-o de volta à lista.

Receitas que usam este preço

Se alguma das suas receitas usar o ingrediente, um quadro azul indica-o: «Este preço é usado em N receitas» — «A ficha de custo de cada receita guarda o seu próprio preço, por isso não se atualiza sozinha. Abra a receita e o painel de Custos propõe-lhe aplicar o preço novo com um clique.» Por baixo aparecem até oito receitas, como ligações para o respetivo separador Custos (e, se houver mais, «e mais N receitas»).

Separadores

Dois separadores: Estratégia de preço e Histórico.

Estratégias de preço

O preço em vigor de um ingrediente não é um número fixo: é definido pela estratégia que escolher. No separador Estratégia de preço há cinco cartões:

Estratégia	O que faz
Última compra	Usa o preço do registo 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çamentar: protege as margens contra subidas.
Média ponderada	Média ponderada pela quantidade comprada. Atenua oscilações pontuais.
Manual	Introduz o preço e a quebra manualmente. Útil quando não há compras registadas ou quando pretende fixar uma referência.
Registo específico	Escolhe um registo concreto do histórico como preço em vigor.

As três primeiras (Última compra, Preço mais alto, Média ponderada) aplicam-se de imediato: basta clicar no cartão para que fique ativa.

As outras duas abrem um formulário contextual:

Manual — campos Preço base sem quebra (€/kg) (com a sua moeda e a unidade da tabela) e Quebra (%). O ecrã calcula e mostra o Preço final com quebra. Clique em Aplicar.
Registo específico — um seletor com os registos do histórico (formato data · fornecedor · preço final). Se o registo não tiver fornecedor, verá Sem fornecedor no seu lugar, e os registos de tipo manual acrescentam o sufixo (manual) no fim. Escolha um e clique em Aplicar este registo. Se não houver histórico, verá «Não há registos no histórico. Adicione pelo menos um para poder usar esta estratégia.»

A quebra

A quebra é a parte do ingrediente que se perde no processo (cascas, aparas, evaporação, acertos). Encarece o custo efetivo, porque para obter uma quantidade útil precisa de comprar mais.

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

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

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

Registar uma compra ou referência

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

Escolha o tipo de registo

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

Preencha os dados

Data (obrigatória).
Fornecedor — seletor; 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 escolher g ou ml, a janela mostra a equivalência na tabela de preços («Equivale a … /kg na tabela de preços.»).
Quantidade comprada — apenas na compra real.
Quebra % — se a indicar, a janela mostra um aviso com o Preço final com quebra.
Notas — opcional.

Guarde

Clique em Guardar registo (ou Cancelar para descartar). O registo entra no histórico e o preço em vigor é recalculado segundo a estratégia ativa.

Se introduzir um preço unitário inválido, a janela avisa com «Indique um preço unitário válido».

O histórico

O separador Histórico lista todos os registos com as colunas Data, Tipo, Fornecedor, Quantidade, Preço s/ quebra, Quebra %, Preço final e Ações.

O Tipo pode ser Compra (compra real) ou Manual (referência).
Nos registos por g ou por ml, por baixo do Preço final aparece o equivalente por kg ou por L, a unidade da tabela.
Em Fornecedor, os registos que chegaram do separador Custos de uma receita aparecem como Da receita; ao passar o rato por cima, uma dica mostra Definido na receita [id da receita].
Para eliminar um registo, use a respetiva ação de eliminar; a aplicação pede confirmação: «Eliminar este registo? O preço em vigor será recalculado.»

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

Detalhe de um ingrediente