Buscar contactos

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

Descripción

Endpoint para buscar contactos de forma avanzada.

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)

Además, se pueden limitar los campos devueltos mediante el parámetro campos.

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	❌	Lista de campos separados por comas
`columnaBusqueda`	string	❌	Campo sobre el que realizar la búsqueda (ej: `comisionista`)
`valorBusqueda`	string	❌	Valor a buscar
`tipoBusqueda`	enum	❌	Puedes hacer búsquedas exactas, parciales o que no contengan ese o eso valores.
`codigoEmpresa`	int	✅ (si es multiempresa)	Código de la empresa

El tipoBusqueda puede ser:

Ejemplo con filtros

# Buscar comisionistas por nombre
curl -X GET "https://api.tandem.com/api/common/ventas/contactos/buscarcontacto?page=1&pageSize=50&columnaBusqueda=nombreContactoLc&valorBusqueda=Ariadna%20Areces&tipoBusqueda=Completa&codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Contactos encontradas",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "codigoCliente": "1008",
        "contactoPosicionLc": 22,
        "codigoCargoLc": "ADM",
        "nombreContactoLc": "Ariadna Areces",
        "codigoAreaContactoLc": "",
        "codigoCortesiaLc": "3",
        "telefonoContactoLc": "",
        "telefono2ContactoLc": "",
        "telefono3ContactoLc": "",
        "faxContactoLc": "",
        "eMail1": "",
        "email2": "",
        "tipoDomicilio": "E",
        "numeroDomicilio": 0,
        "observaciones": null,
        "nombreUsuarioWEBLc": "",
        "passwordUsuarioWEBLc": "3200",
        "firmaAutorizaEMailLc": 0,
        "enviarNoticiasLc": 0,
        "manLc": 0,
        "esAdminClienteLc": 0,
        "esContactoComercialLc": 0,
        "esContactoOperativoLc": 0,
        "bajaEmpresaLc": 0,
        "fechaNacimiento": null,
        "idContacto": "00078bb7-38ae-45a6-9388-73c52a9482e6",
        "nombre": "",
        "apellido1": "",
        "apellido2": "",
        "social1": "",
        "social2": "",
        "social3": "",
        "social4": "",
        "telefonoAccion": "Defecto",
        "telefono2Accion": "Defecto",
        "telefono3Accion": "Defecto",
        "social1Accion": "Defecto",
        "social2Accion": "Defecto",
        "social3Accion": "Defecto",
        "social4Accion": "Defecto",
        "excluirPorLOPDLc": 0
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 50
  }
}