Skip to content
Documentación API

Buscar clientes

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

Descripción

Section titled “Descripción”

Endpoint para buscar clientes de forma avanzada.

A diferencia del endpoint anterior, este permite realizar búsquedas dinámicas indicando:

  • La columna sobre la que buscar (columnaBusqueda)
  • El valor a buscar (valorBusqueda)
  • El tipo de búsqueda (tipoBusqueda)

Esto permite realizar consultas mucho más flexibles que la búsqueda tradicional por nombre.

Parámetros de consulta

Section titled “Parámetros de consulta”
ParámetroTipoRequeridoDescripción
pageint✅Número de página
pageSizeint✅Cantidad de elementos por página
camposstring❌Lista de campos separados por comas
columnaBusquedastring❌Campo sobre el que realizar la búsqueda (ej: razonSocial, codigoCliente)
valorBusquedastring❌Valor a buscar
tipoBusquedaenum❌Puedes hacer búsquedas exactas, parciales o que no contengan ese o eso valores.
codigoEmpresaint✅ (si es multiempresa)Código de la empresa

El tipoBusqueda puede ser:

Ejemplos de uso

Section titled “Ejemplos de uso”

🔍 Búsqueda por nombre (equivalente al endpoint antiguo)

Section titled “🔍 Búsqueda por nombre (equivalente al endpoint antiguo)”
Terminal window
curl -X GET "https://api.tandem.com/api/common/ventas/clientes/buscarcliente?page=1&pageSize=10&columnaBusqueda=razonSocial&valorBusqueda=prueba&tipoBusqueda=Parcial&codigoEmpresa=9999" \
  -H "accept: */*" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

Section titled “Respuesta exitosa (200)”
{
  "success": true,
  "message": "Clientes encontrados",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "idDelegacion": "",
        "codigoCliente": "000063",
        "siglaNacion": "ES",
        "cifDni": "CC000063",
        "cifEuropeo": "ES",
        "fechaAlta": "2025-05-20T00:00:00",
        "codigoProveedor": "",
        "codigoContable": "430000063",
        "codigoCadena_": "",
        "codigoCategoriaCliente_": "CLI",
        "codigoDefinicion_": "",
        "referenciaEdi_": "",
        "activarLogicNet": 0,
        "usuarioLogicNet": "",
        "contraseñaLogicNet": "",
        "codigoExportacion_": "",
        "condicionExportacion_": "",
        "codigoDivisa": "",
        "codigoCondiciones": 0,
        "codigoIdioma_": "",
        "razonSocial": "CLIENTE DE PRUEBA",
        "razonSocial2": "",
        "nombre": "CLIENTE DE PRUEBA T2",
        "domicilio": "",
        "domicilio2": "",
        "actividad": "",
        "tipoCliente": "",
        "codigoSector_": "",
        "marca": "",
        "cargo1": "",
        "nombre1": "",
        "cargo2": "",
        "nombre2": "",
        "cargo3": "",
        "nombre3": "",
        "formadePago": "",
        "domicilioEnvio": 0,
        "domicilioFactura": 0,
        "domicilioRecibo": 0,
        "codigoBanco": "",
        "codigoAgencia": "",
        "dc": "",
        "ccc": "",
        "iban": "",
        "bloqueoPedido": 0,
        "bloqueoAlbaran": 0,
        "codigoCanal": "",
        "codigoProyecto": "",
        "codigoSeccion": "",
        "codigoDepartamento": "",
        "tarifaPrecio": 0,
        "tarifaDescuento": 0,
        "mantenerCambio_": -1,
        "indicadorIva": "I",
        "grupoIva": 0,
        "%Descuento": 0,
        "%ProntoPago": 0,
        "%Retencion": 0,
        "%Financiacion": 0,
        "%Rappel": 0,
        "codigoComisionista": 0,
        "codigoComisionista2_": 0,
        "codigoComisionista3_": 0,
        "codigoComisionista4_": 0,
        "codigoJefeZona_": 0,
        "%Comision": 0,
        "%Comision2_": 0,
        "%Comision3_": 0,
        "%Comision4_": 0,
        "comisionSobreZona%_": 0,
        "codigoZona": 0,
        "codigoRuta_": "",
        "codigoTransportista": 0,
        "tipoPortes": "D",
        "observacionesCliente": "",
        "comentarios": "",
        "periodicidadFacturas": 0,
        "agruparAlbaranes": 0,
        "agruparAbonos": 0,
        "albaranValorado": -1,
        "servirCompleto": 0,
        "mascaraOferta_": "",
        "mascaraPedido_": "",
        "mascaraAlbaran_": "",
        "mascaraFactura_": "",
        "mascaraRecibo_": "",
        "serieOferta_": "",
        "seriePedido_": "",
        "serieAlbaran_": "",
        "copiasAlbaran": 0,
        "copiasFactura": 0,
        "copiasOferta": 0,
        "copiasPedido": 0,
        "codigoSigla": "",
        "viaPublica": "",
        "numero1": "",
        "numero2": "",
        "escalera": "",
        "piso": "",
        "puerta": "",
        "letra": "",
        "codigoPostal": "",
        "codigoMunicipio": "",
        "municipio": "",
        "colaMunicipio": "",
        "codigoProvincia": "",
        "provincia": "",
        "codigoNacion": 108,
        "nacion": "ESPAÑA",
        "telefono": "",
        "telefono2": "",
        "telefono3": "",
        "fax": "",
        "email1": "",
        "email2": "",
        "bajaEmpresaLc": 0,
        "fechaBajaLc": null,
        "codigoMotivoBajaClienteLc": "",
        "comercialAsignadoLc": 0,
        "codigoTipoClienteLc": "",
        "fechaUltimaAccionLc": null,
        "personaClienteLc": "",
        "codigoActividadLc": "",
        "codigoSubActividadLc": "",
        "codigoCargo1": "",
        "codigoCargo2": "",
        "codigoCargo3": "",
        "codigoDivisionLc": "",
        "codigoAmbitoClienteLc": "",
        "codigoClaseClienteLc": "",
        "codigoGrupoClienteLc": "",
        "idDelegacionCentralLc": "",
        "horarioDomicilioLc": "",
        "codigoColectivoClienteLc": "",
        "codigoTipoPrimerContactoLc": "",
        "fechaProximaAccionLc": null,
        "autorizacionLOPDLc": 0,
        "fechaAutorizacionLOPDLc": null,
        "excluirPorLOPDLc": 0,
        "fechaExcluirPorLOPDLc": null,
        "riesgoMaximo": 0,
        "referenciadelProveedor": "",
        "destinoEdi": 0,
        "codigoNaturaleza": "",
        "codigoTransporte": "",
        "codigoPuerto": "",
        "codigoRegimenEstadistico": "",
        "envioEFactura": 0,
        "emailEnvioEFactura": "",
        "guiaXMLEFactura": "",
        "departamentoEdi": "",
        "sabadosFestivos": -1,
        "domingosFestivos": -1,
        "formatoEFactura": 0,
        "noTraspasarSFA": 0,
        "cuentaProvision": "",
        "liquidacionEnDespacho": 0,
        "codigoContableANT_": "",
        "cuentaProvisionANT_": "",
        "formatoEnvio": "",
        "puntosSR": 0,
        "tarjetaSR": "",
        "fechaNacimiento": null,
        "personaAsignada": "",
        "asesorNominaLW": "",
        "empresaNominaLWin": "",
        "codigoEmpleado": 0,
        "idCliente": "5ecf5d62-1ca6-4ead-8716-789386b27148",
        "publicarGCRM": -1,
        "referenciaMandato": "",
        "social1": "",
        "social2": "",
        "social3": "",
        "social4": "",
        "telefonoAccion": "Defecto",
        "telefono2Accion": "Defecto",
        "telefono3Accion": "Defecto",
        "social1Accion": "Defecto",
        "social2Accion": "Defecto",
        "social3Accion": "Defecto",
        "social4Accion": "Defecto",
        "cuentaGasto": "",
        "comentarioAsiento": "",
        "diRe": "",
        "idClientePago": "00000000-0000-0000-0000-000000000000",
        "statusWF": 0,
        "noIdentificado": 0,
        "claveIVA": 0,
        "causaExencion": "",
        "tipoNoSujeta": "",
        "codigoMotivoAbono": "",
        "tS_DiasCaducidad": 0,
        "cP_FechaAniversario": null,
        "cP_MARCA": "",
        "tS_Custom": ""
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}