Open é o conjunto de sistemas do Grupo QuintoAndar dedicado a oferecer serviços e soluções de integração de conteúdo para nossos portais imobiliários, focado em melhorar e facilitar a experiência dos nossos clientes.

Marcas Open Classifieds.svg

Quais são nossos serviços de integração?

Para a integração dos anúncios oferecemos dois serviços: API e arquivos XML com as informações dos anúncios. Cada integrador pode combinar ambos os serviços da maneira que preferir.

API

Este serviço permitirá que você publique e despublique anúncios no ato. Além disso, você pode:

Consultar os anúncios que estão online.
Consultar a qualidade dos anúncios.
Consultar a qualidade das imobiliárias.
Consultar o stock.
Consultar os contatos.
Consultar a informação da ferramenta “Acerca do interessado” / “User profile”.
Consultar os catálogos para montar os anúncios.
Associar anúncios publicados no portal ao seu CRM.
Obter um token de autenticação.

Você poderá encontrar mais informações acessando a seção de API.

XML

Este serviço permitirá que você mantenha atualizada a listagem dos anúncios que devem estar online no portal. Você só precisa criar um XML com o formato da documentação e nos indicar onde podemos obtê-lo.

Você poderá encontrar mais informação acessando a seção de integração XML.

<aside> ❗

Mudanças em anúncios

Ao usar o processo de integração XML deve-se ter muita precaução com a informação dos anúncios, ela tem que ser correta e estar atualizada em cada envio do XML, já que, se a informação de algum anúncio não for enviada no XML, este mudará seu estado de publicação para offline.

Com a API isso não acontece, já que só são atualizados os anúncios que você deseja e os demais ficam no mesmo estado.

</aside>

Que serviço é mais vantajoso escolher?

Muitos se perguntam o que convém usar, isso depende do que cada integrador prefere e não é necessário escolher um só serviço. Podem ter as seguintes combinações:

Somente API para consultas e manutenção de anúncios.
Somente integração XML para manutenção de anúncios.
API para consultas e integração XML para sincronizar de forma massiva os anúncios.
Integração XML para sincronização massiva e API Rest para consulta e modificações de anúncios pontuais.

Caso prefira a última combinação, é preciso ter cuidado para não perder as mudanças que foram feitas com a API. Para isso, recomendamos:

Atualizar o XML com a mudança do anúncio que se deseja realizar.
Fazer a mudança do anúncio com a API Rest.

No XML há um campo com a data. O sistema validará que, se o anúncio tiver uma modificação a partir da API ou a partir do Painel de Anúncios, a data seja maior que a data da mudança. Desta maneira, tomando essa data do arquivo, seria possível evitar a mudança involuntária em anúncios.

É importante levar em conta que se toma de maneira global a todos os anúncios do XML e não podem ser atribuídas mudanças individualmente por anúncio.

Quais são os tipos de configuração de integração?

Há dois tipos de configuração ou modos de integração: "Solo lectura" (Somente leitura) e "Escritura y lectura" (Escrita e leitura). Dependendo da região, você poderá acessar uma ou outra, depende da disponibilidade e do habilitado pelo Grupo Quinto Andar.

Solo Lectura (Somente Leitura):

Esta integração está destinada à administração de leads (seção contatos). Com este tipo de integração é possível:

Consultar interessados.
Consultar a informação da ferramenta Acerca del interesado.
Conectar os anúncios publicados no portal ao seu CRM.

Além disso, com a configuração de callbacks você pode receber as notificações geradas pelas consultas dos usuários no portal. Também é possível consultar o catálogo e a informação dos campos.

Este tipo de configuração só pode ser atribuído a uma integração com API ou usando Callbacks.

Lectura y Escritura (Leitura e Escrita):

Esta integração tem os mesmos permissões que a de somente leitura e são somados outros para o manejo de anúncios e a consulta de stock. O primeiro inclui dar de alta/baja (publicar/despublicar), realizar modificações e consultar a informação completa dos mesmos. Enquanto o segundo, serve para fazer a consulta acerca dos créditos contratados pelo cliente. Com este tipo de integração é possível: