Obtener clientes

GET /api/common/ventas/clientes?page={page}&pageSize={pageSize} V4

Descripción

Endpoint para listar todos los clientes registrados en el sistema.

Incluye como campos base “CódigoCliente”, “razonSocial” y “cifDni”. Si se especifica el parámetro “campos”, se añadirán los campos que se indiquen a los campos base.

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
campos	string	❌	Campos que se quieren añadir a los campos base
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

# Obtener clientes de forma paginada
curl -X GET "https://api.tandem.com/api/common/ventas/clientes?page=1&pageSize=5" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Clientes encontrados",
  "result": {
    "data": [
      {
        "codigoCliente": "000001",
        "razonSocial": "AMAZON SPAIN",
        "cifDni": "30999999B"
      },
      {
        "codigoCliente": "000002",
        "razonSocial": "DEMO TANDEM DOS, SL",
        "cifDni": "12345678Z"
      },
      {
        "codigoCliente": "000004",
        "razonSocial": "CLIENTE DE PRUEBAS CONDICIONES ESPECIALE",
        "cifDni": "74923747M"
      },
      {
        "codigoCliente": "000005",
        "razonSocial": "CLIENTE PRUEBA ALERTA ENVIO.",
        "cifDni": "23456"
      }
    ],
    "totalRecords": 60,
    "totalPages": 12,
    "currentPage": 1,
    "pageSize": 5
  }
}