Introdução
INTRO
Resumo de avisos (imoveis)
ANUNCIOS
Criação / modificação da API
configuracao-callbacks
vendas
authentication-application
imobiliarias
contatos
informacao
anuncios
inventario
Respostas da API
RESPONSES
Powered by Stoplight

Resumo de avisos on-line


Como saber quais anúncios estão online?

Após executar operações diferentes com relação aos anúncios, é desejável saber se elas foram aplicadas corretamente, e para obter informações dos anúncios on-line, pode-se utilizar o endpoint GET /v1/imobiliarias/{codigoImobiliaria}/anuncios/online/resumo, que fornece uma lista de anúncios on-line para uma determinada imobiliária. O usuário tem a possibilidade de obter todos os anúncios on-line ou filtrá-los por alguma característica de seu interesse, e assim realizar a pesquisa mais personalizada.

Requisição

Com relação aos filtros, eles podem ser aplicados juntos ou simplesmente com um filtro de cada vez. Lembre-se de que, ao aplicar vários filtros ao mesmo tempo, os anúncios devem estar em conformidade com cada um deles. Alguns dos filtros permitem enviar mais de um valor para pesquisar, nesses casos, o anúncio pode corresponder a um único valor.

Os filtros que podem ser aplicados são os seguintes:

  • idAvisoNavplat: Esse ID é interno à equipe do Open Navent. Pode ser obtido logo após a publicação do anúncio. Você pode pesquisar apenas com um idAvisoNavplat.
  • codigoAviso: Este código é compartilhado entre ambas as partes para a identificação de um anúncio. Somente um codigoAviso pode ser enviado.
  • idUbicacion: ID do local a pesquisar. Você pode enviar IDs diferentes, os valores separados por "," da forma valor[, valor].
  • titulo: Você pode enviar o título de um anúncio ou palavras/texto para pesquisar nos títulos.
  • operacion: Tipo de operação. Você pode obtê-los com o endpoint /v1/operacoes. Somente uma operação pode ser enviada.
  • idTipoDePropiedad: ID tipo da propriedade. Ids diferentes podem ser enviados, os valores separados por "," da forma valor[, valor].
  • precioDesde: Preço mínimo para a pesquisa.
  • precioHasta: Preço máximo para a pesquisa.
  • codigoMoneda: Insira o ID da moeda que pode ser obtido em /v1/moedas

Informação

O idAvisoNavplat é predominante, ou seja, no caso de o codigoAviso ser enviado, em conjunto com o idAvisoNavplat, será levado em conta o idAvisoNavplat somente. Em seguida, os filtros podem ser combinados da maneira que o integrador deseja.



Resposta

Em relação à resposta do endpoint, é uma lista de anúncios, com algumas informações sobre eles. A estrutura da resposta é a seguinte:

[{
 "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"
 }
}]


Melhoria

Um novo endpoint foi adicionado, trazendo um resumo de todos os lançamentos e suas unidades

GET /v1/imobiliarias/{codigoImobiliaria}/lancamentos/online/resumo


Informação

A informação mostrada no campo de imagem é sobre a imagem principal do anúncio.

ATENÇÃO

Os filtros são todos aplicados ao mesmo tempo, ou seja, um aviso deve estar em conformidade com todos eles para que seja obtido. Se algum dos filtros estiver errado e/ou inválido, a pesquisa retornará um erro ou todos os anúncios da imobiliária.