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
  }
}