Listar compras — Restofy Docs

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>" \
  -H "X-Tenant-Key: <tenantKey>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z

HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "purchases": [
            {
                "purchaseId": 1,
                "purchaseUuid": "ffffffff-ffff-ffff-ffff-ffffffffff01",
                "invoiceNumber": "FAC-001",
                "invoiceDate": "2026-09-03",
                "totalCents": 1190000,
                "status": "pending",
                "paymentTerm": "credit"
            },
            {
                "purchaseId": 2,
                "purchaseUuid": "ffffffff-ffff-ffff-ffff-ffffffffff02",
                "invoiceNumber": "FAC-002",
                "invoiceDate": "2026-09-06",
                "totalCents": 595000,
                "status": "paid",
                "paymentTerm": "cash"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 50,
            "total": 2,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}