Clientes

La cartera: datos fiscales, vías de contacto, consentimientos RGPD y portal.

2 endpoints GET · 2 Solo lectura

De aquí salen los clienteId que aceptan como filtro todos los listados de documentos, y los datos con los que después se contacta.

Cada cliente llega con su email, teléfono y móvil y con sus consentimientos RGPD por canal (email, WhatsApp, SMS, imágenes). Ojo al tercer estado: null no es un "no", es que nunca se le ha preguntado — y para un envío comercial la diferencia importa.

Si el tenant tiene el portal del cliente configurado, cada ficha trae además su URL de acceso directo. Y si la cuenta comparte cartera con su empresa matriz, se listan los de la matriz, igual que en el panel.

Flujo típico

Un recorrido habitual por esta área, de principio a fin.

/api/v1/customers Sincronizas la cartera
/api/v1/customers/{id} Consultas una ficha concreta
/api/v1/invoices Miras qué le has facturado

Endpoints del área 2

GET /api/v1/customers

Listar clientes

Devuelve los clientes de facturación de tu cuenta, paginados y con identificadores cifrados, con buscador y filtro por fecha de alta.

GET /api/v1/customers/{id}

Obtener cliente

La ficha de un cliente por su identificador, con sus datos fiscales y su enlace al portal.

Antes de empezar

Todos estos endpoints comparten el mismo formato de llamada, autenticación por API key y envelope de respuesta: los tienes en Primeros pasos.