Buscar órdenes por código o número de factura

Descripción

Busca órdenes que coincidan exactamente con un código de orden o número de factura.

Detalles

Retorna las órdenes cuyo código coincide exactamente con la búsqueda, o cuyo número de factura coincide exactamente. Cuando la búsqueda mide tres caracteres también acepta coincidencia por los tres primeros o tres últimos caracteres del código de orden. Una orden con varias facturas puede retornar varios resultados.

Permisos requeridos

orders.module

Request

Nombre	Tipo	Requerido	Reglas
query	string	Sí	min:3 max:50

Paginación

defaultLimit	25
maxLimit	100
allowedSorts	openedAt, invoiceIssueDate
defaultSort	openedAt
defaultDir	desc

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/search-orders \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "query": "string"
}'

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

Ejemplo de respuesta

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

HTTP 200

Request

{
    "query": "29N-K38"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "results": [
            {
                "orderId": 2,
                "orderUuid": "17502644-a75f-4b88-b65b-2c9faff641b6",
                "orderCode": "29N-K38",
                "lifecycleStatus": "open",
                "paymentStatus": "unpaid",
                "grandTotalCents": 2300000,
                "openedAt": "2026-09-08T16:33:27.000Z",
                "closedAt": null,
                "fulfillmentTypeCode": "fulfillment.dine.in",
                "fulfillmentTypeName": "En mesa",
                "invoiceId": null,
                "invoiceNumber": null,
                "invoiceIssueDate": null,
                "invoiceGrandTotalCents": null
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 25,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}