Listar proveedores — Restofy Docs

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://app.restofy.co/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-07-15T13:20:48Z

HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "suppliers": [
            {
                "supplierId": 1,
                "partyId": null,
                "name": "Proveedor Test",
                "phone": "***",
                "supplierCode": "SUP-001",
                "contactPersonName": "Juan Proveedor",
                "contactPersonPhone": "3000000077",
                "paymentTermsDays": 30,
                "isAvailable": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 50,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}