Buscar domicilios

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

Descripción

Endpoint para buscar domicilios 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: `viaPublica`)
`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:

Ejemplos de uso

🔍 Búsqueda por vía pública

curl -X GET "https://api.tandem.com/api/common/ventas/domicilios/buscardomicilio?page=1&pageSize=10&columnaBusqueda=viapublica&valorBusqueda=Avenida%20la%20cartuja&tipoBusqueda=Parcial&codigoEmpresa=9999" \
  -H "accept: */*" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Domicilios encontrados",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "tipoDomicilio": "E",
        "codigoCliente": "000001",
        "numeroDomicilio": 5,
        "codigoTransportista": 0,
        "tipoPortes": "D",
        "nombre": "",
        "razonSocial": "EMPRESA JAÉN",
        "razonSocial2": "",
        "codigoSigla": "",
        "viaPublica": "Avenida la cartuja",
        "numero1": "3",
        "numero2": "",
        "escalera": "",
        "piso": "",
        "puerta": "",
        "letra": "",
        "domicilio": "Avenida la cartuja,3",
        "domicilio2": "",
        "codigoPostal": "12344",
        "codigoMunicipio": "23005",
        "municipio": "ANDÚJAR",
        "colaMunicipio": "",
        "codigoProvincia": "23",
        "provincia": "JAÉN",
        "codigoNacion": 108,
        "nacion": "ESPAÑA",
        "telefono": "",
        "telefono2": "",
        "telefono3": "",
        "fax": "",
        "horarioDomicilioLc": "",
        "personaClienteLc": "",
        "referenciaEdi_": "",
        "idDomicilio": "555e61eb-f01d-4dfb-976e-cdd06995c921",
        "observacionesCliente": "",
        "emailConfirmacion": "",
        "descripcionDelegacion": "",
        "eMail1": ""
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}