Saltar al contenido
Facturador

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.