Obtener lista de clientes

Obtiene una lista paginada de clientes del negocio actual.

Autenticación requerida: Este endpoint requiere autenticación Bearer Token. Usar el campo tokenCurrent obtenido del servicio de login (/login) en el header: Authorization: Bearer {tokenCurrent}

Características:

• Soporta paginación para manejo eficiente de grandes listas
• Incluye filtros de búsqueda por nombre, teléfono, documento, email
• Búsqueda flexible con múltiples palabras clave
• Ordenación automática por nombre
• Respeta configuración de compartir clientes con negocio padre

Limitaciones plan trial: Las cuentas en periodo de prueba solo pueden ver clientes de las últimas 24 horas.

Ejemplos de Uso

1. Obtener todos los clientes (primera página)

GET /clients?pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui

Obtiene los primeros 10 clientes ordenados por nombre.

2. Buscar cliente por nombre

GET /clients?filter=Juan&pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui

Busca clientes que contengan "Juan" en nombre o apellido.

3. Búsqueda por múltiples palabras

GET /clients?filter=Maria Lopez&pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui

Busca clientes que contengan tanto "Maria" como "Lopez".

4. Búsqueda por teléfono

GET /clients?filter=300123&pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui

Busca clientes por número de teléfono (búsqueda flexible con espacios).

5. Búsqueda avanzada por datos generales

GET /[email protected]&pagination=true&limit=10&page=0
Authorization: Bearer tu_token_aqui

Busca en todos los campos del cliente (nombre, apellido, documento, email, teléfono, dirección).