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](https://developers.controlata.com/hc/api-docs/articles/api-rules-es).

## 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 |
| email | 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 |
