Buscar clientes

GET /api/common/ventas/clientes/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/clientes/buscar?page=1&pageSize=20&nombre=pru" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Clientes encontrados",
  "result": {
    "data": [
      {
        "codigoCliente": "000073",
        "razonSocial": "CLIENTE DE PRUEBA T1",
        "cifDni": "30999999A"
      },
      {
        "codigoCliente": "000075",
        "razonSocial": "CLIENTE DE PRUEBA DEMO",
        "cifDni": "30999999A"
      },
      {
        "codigoCliente": "000091",
        "razonSocial": "Persona de prueba",
        "cifDni": "30922800G"
      },
      {
        "codigoCliente": "000093",
        "razonSocial": "pruebaPostPC",
        "cifDni": "30900800H"
      },
      {
        "codigoCliente": "000094",
        "razonSocial": "Otro cliente de prueba",
        "cifDni": "40500600A"
      },
      {
        "codigoCliente": "000098",
        "razonSocial": "Persona de prueba",
        "cifDni": "40500600L"
      },
      {
        "codigoCliente": "000102",
        "razonSocial": "Prueba con CE",
        "cifDni": "CC000102"
      },
      {
        "codigoCliente": "000105",
        "razonSocial": "Otro cliente de pruebas para ver CE",
        "cifDni": "30500600L"
      },
      {
        "codigoCliente": "123123",
        "razonSocial": "CLIENTE DE PRUEBA",
        "cifDni": "CC123123"
      }
    ],
    "totalRecords": 20,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 20
  }
}