Listar proveedores
POST /api/parties/list-suppliers-admin
Descripción
Listado paginado de proveedores del directorio.
Detalles
* Devuelve los proveedores con paginación y búsqueda por nombre. * Incluye el código de proveedor, los términos de pago y los datos de la persona de contacto. * El nombre se resuelve desde el contacto vinculado cuando existe; si no, usa el nombre propio del proveedor.
Permisos requeridos
parties.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| search | string | No |
max:100
|
Paginación
| defaultLimit | 50 |
| maxLimit | 100 |
| defaultDir | asc |
| withTotal | true |
| allowedSorts | [name, supplierCode, paymentTermsDays] |
Ejemplo de request
curl -X POST https://restofy.pro/api/parties/list-suppliers-admin \
-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-09-13T21:05:19Z
HTTP 200
Request
{
"search": "Prov Test 6aa70fd859ed1"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"suppliers": [
{
"supplierId": 2,
"partyId": 3,
"name": "Prov Test 6aa70fd859ed1",
"phone": "***",
"supplierCode": null,
"contactPersonName": null,
"contactPersonPhone": null,
"paymentTermsDays": 0,
"isAvailable": 1
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}