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
pageSize	int	✅	Cantidad de elementos por página
nombre	string	✅	Nombre del cliente (puede introducirse parcialmente)
codigoEmpresa	int	✅	Obligatorio si el cliente es multiempresa

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