Restofy Docs
Toma de pedidos POST

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

POST /api/pos-order/search-orders

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 o número de factura coincide exactamente. Con tres caracteres también acepta los tres primeros o tres últimos del código. Una orden con varias facturas puede retornar varios resultados. Sin permiso para ver todas las numeraciones, lo cobrado con una numeración distinta a la predeterminada de la caja aparece solo con el código completo.

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>" \
  -d '{
    "query": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-11-02T19:00:57Z
HTTP 200

Request

{
    "query": "25U",
    "limit": 100
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "results": [],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 0,
            "totalPages": 0,
            "hasNext": false,
            "hasPrev": false
        }
    }
}