Compras de insumos
POST
Listar compras
POST /api/purchases/list-purchases
Descripción
Listado paginado de compras del restaurante con búsqueda libre.
Detalles
Devuelve las compras registradas con su fecha, número de factura, total y estado. Admite búsqueda libre y ordenamiento por fecha, número, total o estado.
Permisos requeridos
purchases.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [invoiceDate, invoiceNumber, totalCents, status] |
Ejemplo de request
curl -X POST https://restofy.pro/api/purchases/list-purchases \
-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-09-13T21:05:19Z
HTTP 200
Request
{
"search": "FAC-6aa70fde01098"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"purchases": [
{
"purchaseId": 5,
"purchaseUuid": "888c87d9-acb4-11f1-b72d-f2569efa6eee",
"invoiceNumber": "FAC-6aa70fde01098",
"invoiceDate": "2026-09-04",
"totalCents": 1000,
"status": "pending",
"paymentTerm": "cash"
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}