Buscar clientes potenciales

GET /api/common/ventas/clientespotenciales/buscar?page={page}&pageSize={pageSize}&nombre={nombre} V4

Descripción

Endpoint para buscar clientes por nombre (razón social). El parámetro “nombre” permite buscar de manera parcial, de modo que si escribiesesmos “pru” nos saldrían todos los clientes que contengan “pru” en el nombre, como “prueba” o “cliente prueba”.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
page	int	✅	Número de página
pageSize	int	✅	Cantidad de elementos por página
nombre	string	✅	Nombre del cliente (puede introducirse parcialmente)
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

# Buscar clientes por nombre
curl -X GET "https://api.tandem.com/api/common/ventas/clientespotenciales/buscar?page=1&pageSize=10&nombre=pru" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Clientes encontrados",
  "result": {
    "data": [
      {
        "codigoCliente": "000127",
        "razonSocial": "Cliento pot de prueba",
        "cifDni": "12133144L"
      }
    ],
    "totalRecords": 20,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 20
  }
}