Devuelve los clientes de la empresa, ordenados por nombre. Los clientes eliminados no se incluyen.
v1/customers/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 customers con los campos del cliente. El campo total contiene el número total de clientes.
| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del cliente |
| name | string | Nombre |
| string | Correo electrónico | |
| phone | string | Teléfono |
| address_legal | string | Dirección fiscal |
| address_real | string | Dirección de entrega |
| 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,
"customers": [
{
"id": 513,
"name": "Ana García",
"email": "anna@example.com",
"phone": "+34 600 123 456",
"address_legal": "",
"address_real": "C/ Bauman 20, Valencia",
"agreement": "",
"manager_name": "",
"manager_post": "",
"notes": ""
},
{
"id": 512,
"name": "Patio del Mueble",
"email": "pedidos@patiomueble.com",
"phone": "+34 912 345 678",
"address_legal": "C/ Mayor 5, Madrid",
"address_real": "C/ Almacén 12, Madrid",
"agreement": "N.º 15 del 10/01/2026",
"manager_name": "Pedro Gómez",
"manager_post": "Director general",
"notes": ""
}
],
"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 |