¿Comó saber qué avisos estan online?
Luego de realizar distintas operaciones con respecto a los avisos, es deseable saber si estas fueron aplicadas correctamente, y para obtener información de los avisos online, se puede utilizar el endpoint:
GET /v1/inmobiliarias/{codigoInmobiliaria}/avisos/online/resumen.
El cual brinda una lista de los avisos online para una determinada inmobiliaria. El usuario tiene la posibilidad de obtener todos los avisos online, o filtrarlos por alguna caracteristica de su interés, y asi realizar la búsqueda más personalizada.
Request
Con respecto a los filtros, estos pueden ser aplicados en conjunto o simplemente con un filtro a la vez. Hay que tener en cuenta que al aplicar muchos filtros al mismo momento, los avisos deben cumplir cada uno de ellos. Algunos de los filtros permiten enviar más de un valor para buscar, para estos casos, los aviso pueden coincidir con un solo valor .
Los filtros que pueden aplicarse son los siguientes:
- idAvisoNavplat: Este id es interno para el equipo de Open Navent. Se puede obtener luego de que el aviso fue puesto Online. Solo se puede buscar con un idAvisoNavplat.
- codigoAviso: Este código es el compartido entre ambas partes para la identificacion de un aviso. Solo se puede enviar un solo codigoAviso.
- idUbicacion: id de la ubicacion a buscar. Se pueden enviar distintos ids, los valores separados por ‘,’, de la forma valor[,valor]
- titulo: Se puede enviar el título de un aviso o palabras/texto a buscar en los titulos.
- operacion: tipo de operación. Se pueden obtener las mismas con el endpoint /v1/operaciones. Solo se pueden enviar una operacion.
- idTipoDePropiedad: id tipo de la propiedad. Se pueden enviar distintos ids, los valores separados por ‘,’, de la forma valor[,valor]
- precioDesde: precio base para la búsqueda.
- precioHasta: precio tope para la búsqueda.
- codigoMoneda: Ingresar el id de la moneda se puede obtener en /v1/monedas
Información
El idAvisoNavplat es predominante, es decir, en el caso de que se envie el codigoAviso, en conjunto con el idAvisoNavplat, se tendra en cuenta el idAvisoNavplat solamente. Luego los filtros pueden combinarse de la forma que el integrador desee.
Response
Con respecto a la respuesta del endpoint, es una lista de los avisos, con cierta informacion de los mismos. La estructura de la respuesta es la siguiente:
“claveInterna”: “string”,
“codigoAviso”: “string”,
“codigoDesarrollo”: “string”,
“fechaModificacion”: “2019-11-28T13:04:21.210Z”,
“fechaModificado”: “string”,
“idAvisoNavplat”: 0,
“idDesarrolloNavplat”: 0,
“imagen”: {
“titulo”: “string”,
“urlImagenOriginal”: “string”,
“urlImagenPortal”: “string”
},
“publicacion”: “string”,
“tipoDeAviso”: “string”,
“tipoDePropiedad”: 0,
“titulo”: “string”,
“ubicacion”: {
“codigoPostal”: “string”,
“direccion”: “string”,
“idUbicacion”: “string”,
“latitud”: “string”,
“longitud”: “string”,
“muestraMapa”: “string”,
“ubicacion”: “string”
}
}]
Actualización
Se añadio un nuevo endpoint que trae un resumen de todos los desarrollos y sus unidades
GET /v1/inmobiliarias/{codigoInmobiliaria}/desarrollos/online/resumen
Información
La información que se muestra en el campo imagen, es sobre la imagen principal del aviso.
ATENCIÓN
Los filtros son todos aplicados al mismo tiempo, es decir que un aviso debe cumplirlos todos para poder obtenerse. Si alguno de los filtros, es erróneo y/o invalido, la búsqueda devolverá error, o todos los avisos de la inmobiliaria.