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
purchases.module
parties.module
El usuario solo necesita uno de los permisos listados.
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-11-02T19:00:57Z
HTTP 200
Request
{
"search": "Distribuidora 6ae8d72f340c7"
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"suppliers": [
{
"supplierId": 2,
"partyId": 3,
"name": "Distribuidora 6ae8d72f340c7",
"phone": "***",
"supplierCode": null,
"contactPersonName": null,
"contactPersonPhone": null,
"paymentTermsDays": 0,
"isAvailable": 1
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
}