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 cliente | Clientes — a ficha da imobiliária, uma vez por cliente |
| 2 · Conectar a conta dele | Conectar 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óvel | Cadastro de imóveis · Verificar antes |
| 4 · Publicar | Publicar — 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 que | Onde |
|---|---|
| 🔴 A cota mensal — 1.500 chamadas por imobiliária, o que a consome e como se renova | Cota mensal e limites |
| Os planos de publicação do seu cliente e quantos lhe restam | Os 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 unidades | Publicar um empreendimento |
| As consultas que as pessoas deixam nos anúncios | Leads |
| Os usuários do seu cliente no portal — para escolher o corretor do anúncio | Os 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 sistema | conectá-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 dali | essa 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ê pede | O que traz | Cota |
|---|---|---|
GET .../customers/zonapropapi/users | Todos os usuários com e-mail e papel — que é tudo o que você precisa para agentEmail | 0 chamadas |
O mesmo, com ?detail=true | Além disso, o nome e os telefones dos corretores | 1 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
- PropertyAPI — o índice de toda a API
- Publicação — os portais disponíveis e o que os diferencia