Costos
POST
Panel de costos
POST /api/costing/get-costs-overview
Descripción
Resumen de costos del restaurante en un periodo.
Detalles
Devuelve el valor del inventario por bodega y por categoría, el costo promedio de los platos frente a la meta y los platos que la superan. Incluye los insumos que más subieron y bajaron de costo y las compras con alerta del periodo. El costo promedio de los platos se pondera por lo vendido en el periodo.
Permisos requeridos
costs.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| days | int | No |
enum:7,30,90
default:30
|
Ejemplo de request
curl -X POST https://restofy.pro/api/costing/get-costs-overview \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>"Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
{
"days": 30
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"targetBasisPoints": 3000,
"kpis": {
"inventoryValueCents": 152830000,
"averageFoodCostBasisPoints": 8000,
"isWeightedBySales": 0,
"productsOverTarget": 1,
"productsWithoutRecipe": 17,
"itemsWithoutCost": 0,
"purchaseAlerts": 1
},
"valueByLocation": [
{
"name": "Bodega Principal",
"valueCents": 114750000
},
{
"name": "Cuarto Frío - Carnes",
"valueCents": 38000000
},
{
"name": "Bodega Bebidas",
"valueCents": 80000
},
{
"name": "Cuarto Frío - Mariscos",
"valueCents": 0
},
{
"name": "Bodega Principal",
"valueCents": 0
},
{
"name": "Cuarto Frío - Verduras",
"valueCents": 0
}
],
"valueByCategory": [
{
"name": "Carnes y Aves",
"valueCents": 152750000
},
{
"name": "Cat Insumo 6ae8d72eabd85",
"valueCents": 80000
}
],
"costIncreases": [
{
"inventoryItemId": 27,
"name": "Insumo Test 6ae8d72f0551d",
"countingSymbol": "g",
"fromCostCents": 100,
"toCostCents": 160,
"varianceBasisPoints": 6000,
"productsCount": 1
}
],
"costDecreases": [],
"productsOverTarget": [
{
"productId": 21,
"productUuid": "e3650f94-595d-4c3b-912d-af30ff51fd12",
"name": "Plato costo 6ae8d7303c119",
"categoryName": "Sopas y Cremas",
"priceCents": 10000,
"costCents": 8000,
"hasRecipe": 1,
"hasMissingCost": 0,
"foodCostBasisPoints": 8000
}
],
"purchaseAlerts": [
{
"purchaseUuid": "2ab59419-d116-11f1-8bb6-de64ef616b7c",
"invoiceNumber": "FC-6ae8d72fa62c9",
"supplierName": "Distribuidora 6ae8d72f340c7",
"inventoryItemId": 27,
"itemName": "Insumo Test 6ae8d72f0551d",
"varianceBasisPoints": 6000,
"isCostExcluded": 0,
"invoiceDate": "2026-11-02"
}
]
}
}