Devuelve los proveedores de la empresa, ordenados por nombre. Los proveedores eliminados no se incluyen.
v1/suppliers/get_list.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| limit | int | No | Tamaño de página, de 1 a 1000 |
| offset | int | No | Cuántos registros omitir |
Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales.
Respuesta
Un array suppliers con los campos del proveedor. El campo total contiene el número total de proveedores.
| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del proveedor |
| name | string | Nombre |
| string | Correo electrónico | |
| phone | string | Teléfono |
| address | string | Dirección |
| agreement | string | Acuerdo |
| manager_name | string | Responsable |
| manager_post | string | Puesto del responsable |
| notes | string | Notas |
Ejemplo de solicitud
{
"limit": 100,
"offset": 0
}
Ejemplo de respuesta
{
"success": true,
"suppliers": [
{
"id": 46,
"name": "Suministros Herrajes",
"email": "hardware@example.com",
"phone": "+34 931 000 170",
"address": "C/ Paz 14, Sevilla",
"agreement": "",
"manager_name": "",
"manager_post": "",
"notes": ""
},
{
"id": 45,
"name": "Maderas García",
"email": "mayoreo@maderasgarcia.com",
"phone": "+34 915 000 222",
"address": "C/ del Puerto 8, Barcelona",
"agreement": "N.º 7 del 15/02/2026",
"manager_name": "Óscar Ruiz",
"manager_post": "Director",
"notes": "Entregas los martes"
}
],
"total": 2
}
Errores
| Error | Motivo |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |