AreaCacao Docs

Gestiona el precio de un ingrediente: cinco estrategias de cálculo, historial de compras, merma y registros manuales.

Qué es

La pantalla de detalle es donde gestionas el coste de un ingrediente concreto: eliges con qué estrategia se calcula su precio vigente, registras sus compras y referencias manuales, y aplicas la merma que encarece el precio efectivo.

En pantalla, esta vista aparece como Detalle de coste (con el breadcrumb Costes → Detalle de coste) y su subtítulo es "Estrategia + historial completo de compras.". Aquí la llamamos Detalle de un ingrediente como nombre descriptivo.

Ruta de acceso

Ruta: https://app.areacacao.com/costs/ingredients/[id]
Cómo se llega: desde Precios de ingredientes, pulsa Detalle en la fila del ingrediente. Vuelves al listado con el enlace Volver al listado.

Lo que ves

Cabecera y KPIs

Arriba ves el icono, el nombre, el identificador y la categoría del ingrediente, junto al botón Añadir registro. Debajo, cuatro indicadores:

Precio actual — el precio vigente según la estrategia activa, en la moneda de tu perfil y por kilo (/kg), o por litro (/L) si todos los registros del ingrediente están en volumen.
Promedio ponderado — promedio de los precios del historial, ponderado por la cantidad comprada, en la misma unidad.
Registros — cuántas entradas tiene el historial.
Última compra — fecha del registro de compra más reciente.

Si el ingrediente se queda sin registros (por ejemplo, tras borrar el último), aparece además el botón Quitar del libro de precios. Pide confirmación ("Este ingrediente no tiene registros de precio. ¿Quitarlo del libro de precios? Tus recetas no cambian.") y te devuelve al listado.

Recetas que usan este precio

Si alguna de tus recetas usa el ingrediente, un recuadro azul lo indica: «Este precio se usa en N recetas» — "El escandallo de cada receta guarda su propio precio, así que no se actualiza solo. Abre la receta y el panel de Costes te ofrece aplicar el precio nuevo en un clic." Debajo aparecen hasta ocho recetas como enlaces a su pestaña Costes (y, si hay más, "y N recetas más").

Pestañas

Dos pestañas: Estrategia de precio e Historial.

Estrategias de precio

El precio vigente de un ingrediente no es un número fijo: lo determina la estrategia que elijas. En la pestaña Estrategia de precio hay cinco tarjetas:

Estrategia	Qué hace
Última compra	Usa el precio del registro de compra más reciente. Refleja el coste de adquisición actual.
Precio más alto	Usa el precio más alto del historial. Conservador para presupuestar: protege márgenes ante subidas.
Promedio ponderado	Promedio ponderado por cantidad comprada. Suaviza fluctuaciones puntuales.
Manual	Introduces el precio y la merma a mano. Útil cuando no hay compras registradas o quieres fijar una referencia.
Registro específico	Eliges un registro concreto del historial como precio vigente.

Las tres primeras (Última compra, Precio más alto, Promedio ponderado) se aplican al instante: pulsas la tarjeta y queda activa.

Las otras dos abren un formulario contextual:

Manual — campos Precio base sin merma (€/kg) (con tu moneda y la unidad del libro) y Merma (%). La pantalla calcula y muestra el Precio final con merma. Pulsa Aplicar.
Registro específico — un selector con los registros del historial (formato fecha · proveedor · precio final). Si el registro no tiene proveedor verás Sin proveedor en su lugar, y los registros de tipo manual añaden el sufijo (manual) al final. Elige uno y pulsa Aplicar este registro. Si no hay historial, verás "No hay registros en el historial. Añade al menos uno para poder usar esta estrategia."

La merma

La merma es la parte del ingrediente que se pierde en el proceso (cáscaras, recortes, evaporación, ajuste). Encarece el coste efectivo, porque para obtener una cantidad útil necesitas comprar más.

AreaCacao la aplica con esta fórmula sobre el precio base:

precio final = precio base / (1 - merma/100)

Por ejemplo, con un precio base de 10 €/kg y una merma del 20 %, el precio final es 10 / (1 - 0,20) = 12,50 €/kg.

Registrar una compra o referencia

Pulsa Añadir registro (o Primer registro / Añadir primer registro si el historial está vacío). Se abre el modal Nuevo registro de precio, con el subtítulo "Una compra real o una referencia manual del precio del ingrediente."

Elige el tipo de registro

Un conmutador entre Compra real y Referencia manual. Una compra real refleja una adquisición concreta; una referencia manual es un precio orientativo cuando no compraste.

Rellena los datos

Fecha (obligatoria).
Proveedor — selector; puedes dejar — sin proveedor —.
Precio unitario (obligatorio).
Unidad (obligatoria): por g, por kg, por ml, por L o por unidad. Si eliges g o ml, el modal muestra su equivalencia en el libro de precios ("Equivale a … /kg en el libro de precios.").
Cantidad comprada — solo en compra real.
Merma % — si la indicas, el modal muestra un aviso con el Precio final con merma.
Notas — opcional.

Guarda

Pulsa Guardar registro (o Cancelar para descartar). El registro entra en el historial y el precio vigente se recalcula según la estrategia activa.

Si introduces un precio unitario no válido, el modal avisa con "Indica un precio unitario válido".

El historial

La pestaña Historial lista todos los registros con las columnas Fecha, Tipo, Proveedor, Cantidad, Precio s/ merma, Merma %, Precio final y Acciones.

El Tipo puede ser Compra (compra real) o Manual (referencia).
En los registros por g o por ml, debajo del Precio final aparece su equivalente por kg o por L, la unidad del libro.
En Proveedor, los registros que llegaron desde la pestaña Costes de una receta aparecen como Desde receta; al pasar el ratón por encima, un aviso muestra Definido desde receta [id de la receta].
Para borrar un registro usa su acción de eliminar; la app pide confirmación: "¿Eliminar este registro? El precio vigente se recalculará."

Si el historial está vacío verás "Sin registros aún. Añade compras reales o referencias manuales de precio para calcular el coste de este ingrediente en tus recetas."

Detalle de un ingrediente