Vendeya: buscar clientes
GET /api/sellnow/customers
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Mismo comportamiento que Buscar clientes (formato API de comprobantes) (sección Clientes y proveedores).
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: listado de cantidad fija (take/limit): devuelve como máximo N registros, sin metadatos de paginación. Envuelto en {success, customers[]}; máximo limit registros (30 por defecto, tope 50).
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
input |
query | no | PEDRO |
Número de documento o nombre. |
identity_document_type_id |
query | no | 1 |
Filtra por tipo de documento. |
limit |
query | no | 30 |
Máximo de registros (1 a 50). |
Respuestas
200 — Clientes
{
"success": true,
"customers": [
{
"id": 26,
"codigo_tipo_documento_identidad": "1",
"numero_documento": "45678912",
"apellidos_y_nombres_o_razon_social": "PEDRO QUISPE MAMANI",
"codigo_pais": "PE",
"direccion": "AV. PRINCIPAL 123, LIMA",
"correo_electronico": "compras@comercialnorte.pe",
"telefono": "987654321"
}
]
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.