Zonaprop

A Zonaprop é um dos portais em que a PropertyAPI publica. Não tem endpoints próprios: publica-se com os mesmos métodos de qualquer outro portal, passando zonapropapi onde a rota pede {portal}.

PUT    /property-v1/properties/{paId}/publication/zonapropapi
GET    /property-v1/properties/{paId}/publication/zonapropapi
DELETE /property-v1/properties/{paId}/publication/zonapropapi

Por onde começar

1 · Declarar o clienteClientes — a ficha da imobiliária, uma vez por cliente
2 · Conectar a conta deleConectar com um link — a Zonaprop é conectada com um link que o seu cliente abre, e não com credenciais que você envie
3 · Carregar o imóvelCadastro de imóveis · Verificar antes
4 · PublicarPublicar — e o estado do que o portal diz
5 · Escolher o nível (decide-se no passo 4)Na Zonaprop a posição é paga com o plano do anúncio, e o plano viaja dentro da publicação — não há um passo posterior. Os planos que o seu cliente tem estão em Os planos do seu cliente; o mecanismo, em Pagar por posição

O que é próprio da Zonaprop

O queOnde
🔴 A cota mensal — 1.500 chamadas por imobiliária, o que a consome e como se renovaCota mensal e limites
Os planos de publicação do seu cliente e quantos lhe restamOs planos do seu cliente
Como a conta é conectada (com link, não com credencial)Conectar com um link
Empreendimentos — uma chamada publica o pai e as suas unidadesPublicar um empreendimento
As consultas que as pessoas deixam nos anúnciosLeads
Os usuários do seu cliente no portal — para escolher o corretor do anúncioOs usuários do seu cliente

🔴 O seu cliente tem UMA única conexão na Zonaprop

É a primeira coisa que convém saber, porque muda a forma como você oferece o serviço: a Zonaprop admite um único sistema conectado por imobiliária. Dois não convivem.

Se o seu cliente já publica a partir de outro sistemaconectá-lo pela API o desconecta daquele. Combine isso com ele antes, não depois
Se o seu cliente também usa o aplicativo da Mapaprop e conecta a Zonaprop a partir daliessa passa a ser a conexão válida e a sua deixa de funcionar

Este último é o caso que mais surpreende, porque nada falha no seu código: as suas chamadas começam a voltar recusadas de um momento para o outro, sem que você tenha mexido em nada.

Como isso aparece

O portal recusa as chamadas dizendo que aquela imobiliária não é da sua integração:

{ "code": "error", "message": "La inmobiliaria [...] no pertenece a la integracion ..." }

Afeta tudo ao mesmo tempo: publicar, dar baixa, consultar a situação e ler os planos do seu cliente. Se você vir isso em uma chamada, vai ver em todas.

O que fazer

Conectar a conta pela API novamente — Conectar com um link. O seu cliente abre o link, autoriza, e a conta dele volta a ficar associada à sua integração.

Se o seu cliente usa as duas coisas, convém decidir qual publica. Alterná-las significa que a última conexão desliga a anterior todas as vezes. Não é um problema da API: é como a conta funciona no portal.

As zonas não são mapeadas por API. Os mapeamentos zona Mapaprop → zona Zonaprop somos nós que mantemos; você envia a sua zona e resolvemos o resto. Se uma zona sua não estiver mapeada, o verificador avisa antes de publicar. Os catálogos de localização estão em Zonas.

O corretor do anúncio, e quando custa uma chamada

No Zonaprop cada anúncio tem um corretor responsável, e você pode escolhê-lo ao publicar enviando o e-mail dele em branch.agentEmail (Publicar).

🔴 Esse e-mail precisa ser o de um usuário que exista na conta do seu cliente no portal. Se você enviar outro, o Zonaprop não devolve erro: substitui pelo do administrador da conta e a publicação sai 200. Por isso convém olhar a lista antes.

E olhar não precisa custar nada:

O que você pedeO que trazCota
GET .../customers/zonapropapi/usersTodos os usuários com e-mail e papel — que é tudo o que você precisa para agentEmail0 chamadas
O mesmo, com ?detail=trueAlém disso, o nome e os telefones dos corretores1 chamada

Para publicar basta o primeiro. O segundo serve se você também quiser enviar o nome e o telefone do corretor no anúncio, porque o portal não os deduz do e-mail: se você escolher um corretor e não enviar os outros dois, o anúncio sai com os dados da ficha do seu cliente.

O nível gratuito traz mais gente do que o que custa: o detalhe existe apenas para os usuários com papel de corretor, então o administrador aparece somente no primeiro — e é justamente aquele que o portal usa quando não reconhece o e-mail que você enviou.

Os usuários são cadastrados no painel do Zonaprop, não por esta API, e para figurarem na lista precisam ter papel de corretor atribuído. Se o seu cliente adicionar um corretor no CRM dele e não o cadastrar no portal, o e-mail dele não vai funcionar como agentEmail.

Relacionado