Órdenes
POST
Listar repartidores disponibles
POST /api/pos-order/list-couriers
Descripción
Devuelve los repartidores disponibles para asignar a una entrega a domicilio.
Detalles
Retorna el listado paginado de repartidores activos con búsqueda por nombre, pensado para elegir a quién entregar el pedido a domicilio. Incluye el nombre, el teléfono de contacto y la plataforma asociada a cada repartidor.
Permisos requeridos
orders.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [name, platform] |
Ejemplo de request
curl -X POST https://app.restofy.co/api/pos-order/list-couriers \
-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
{
"search": "Repartidor 756800"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"couriers": [
{
"courierId": 2,
"courierUuid": "ac2915fe-7eb3-11f1-ac02-f2368af4d8ac",
"partyId": 3,
"name": "Repartidor 756800",
"phone": "***",
"platform": "Propio",
"isAvailable": 1
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}