Buscar clientes para vender
GET /api/document/search-customers
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Busca clientes por nombre o número de documento (coincidencia parcial). Con document_type_id=01 (factura) se limita a clientes con RUC; con otro valor admite DNI, carné de extranjería, RUC, pasaporte y sin documento.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: estándar {success, data, message?} (registro único). Los clientes vienen en data.customers (sin paginación).
Nota: la coincidencia por nombre puede traer personas que no son clientes o con otro tipo de documento; verifica identity_document_type_id antes de emitir una factura.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
input |
query | sí | XYZ |
Texto a buscar (nombre o número). |
document_type_id |
query | no | 01 |
Comprobante que vas a emitir: 01 solo RUC; 03/80 cualquier documento. |
Respuestas
200 — Clientes
{
"success": true,
"data": {
"customers": [
{
"id": 1,
"description": "20501973522 - EMPRESA XYZ S.A.C.",
"name": "EMPRESA XYZ S.A.C.",
"number": "20501973522",
"identity_document_type_id": "6",
"identity_document_type_code": "6",
"identity_document_type_description": "RUC",
"address": "Av. 2 de Mayo 123, Lima",
"telephone": "014271148",
"country_id": "PE",
"district_id": "150101",
"email": "facturacion@xyz.com.pe",
"selected": false,
"addresses": [
{
"id": 4,
"location_id": [
"15",
"1501",
"150101"
],
"address": "Jr. Ica 450, Lima",
"code": "0001",
"has_consigned": false
}
]
}
]
}
}
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.