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

inventory.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://app.restofy.co/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-07-15T13:20:48Z

HTTP 200

Request

[]

Response

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