Argenprop
O Argenprop é um dos portais em que a PropertyAPI publica. Não tem endpoints próprios: usam-se os
mesmos métodos que para qualquer outro portal, passando argenpropapi onde a rota pede {portal}.
PUT /property-v1/properties/{paId}/publication/argenpropapi
GET /property-v1/properties/{paId}/publication/argenpropapi
DELETE /property-v1/properties/{paId}/publication/argenpropapi
Publicar no Argenprop ainda não está disponível por esta API: hoje você pode declarar o
cliente, conectar a conta dele e verificar as propriedades, e o verificador já diz, anúncio por
anúncio, se ele sairia no Argenprop. As três rotas acima respondem 400 até que seja habilitado.
Isso significa que você pode ter a sua integração pronta —e as conexões dos seus clientes já feitas— antes de o portal ser habilitado. Escreva para dev@mapaprop.com se quiser que a gente avise.
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 — o seu cliente escreve a credencial de integração dele numa página nossa; você não a vê |
| 3 · Carregar a propriedade | Cadastro de propriedades · Verificar antes |
| 4 · Publicar | ⏳ ainda não — veja o aviso acima |
O que é próprio do Argenprop
Trabalha com PONTOS, não com planos
É a diferença de fundo em relação aos outros portais, e explica quase todo o resto.
| Como funciona | |
|---|---|
| Outros portais | o seu cliente contrata N publicações ou um plano, e cada anúncio consome uma |
| Argenprop | o seu cliente contrata uma assinatura com uma quantidade de pontos e os reparte entre os anúncios para posicioná-los: mais pontos num anúncio, melhor posição |
Consequências para a sua integração:
- O saldo de pontos não se consulta por API. Ele aparece no painel do Argenprop. Por isso, em
a ficha do cliente, os campos
plansequotadeargenpropapivêm sempre emnull: não é que não saibamos lê-los, é que o portal não os publica. - O saldo se descobre ao publicar. Se o seu cliente ficou sem pontos, o anúncio não é criado e a gente avisa com o motivo do portal.
- A assinatura é gerida com o Argenprop, não com a gente: contratá-la, renová-la e cancelá-la são assuntos entre o seu cliente e o portal.
Somente para imobiliárias da Argentina
O Argenprop opera unicamente na Argentina, e as credenciais de integração são entregues a imobiliárias argentinas. Se o seu cliente não é da Argentina, este portal não se aplica — veja Publicação para os que se aplicam.
A credencial não é a da conta dele no portal
O Argenprop entrega credenciais de integração à parte, por e-mail: um usuário com formato
xxx@api.com, uma senha, e um número que o e-mail chama de IdAnunciante —e também de
IdVendedor: são o mesmo dado.
Se o seu cliente escrever o e-mail e a senha com que entra no site do Argenprop, a conexão fica registrada e depois as publicações falham por permissões. A página de conexão avisa isso a ele; se você vir esse erro reportado, a primeira coisa a revisar é com qual usuário ele se conectou.
O seu cliente as escreve na nossa página de conexão —você não as vê e a gente não guarda a senha— e o que fica guardado é a permissão que o portal devolve. Detalhe: Conectar com um link.
Ao conectar, o portal pode derrubar os anúncios do CRM anterior
Se o seu cliente vinha publicando no Argenprop por outro meio —o painel do próprio portal ou outro CRM—, o Argenprop pode dar baixa nesses anúncios quando a conta passa a ser gerida a partir de um sistema novo. É política do portal para evitar anúncios duplicados ao republicar, e quem a executa é o Argenprop: não é algo que a Mapaprop ou a sua integração faça.
Avise o seu cliente antes de conectar, e já conte com republicar a carteira dele a partir do seu sistema depois de conectado.
E a contrapartida: o portal não recomenda gerir a mesma conta por dois meios ao mesmo tempo (o painel dele e a sua integração) — isso produz dessincronização e anúncios duplicados. O esperado é que, uma vez conectada, tudo seja gerido de um só lugar.
Quais dados próprios ele aceita em publication
| Campo | O que é |
|---|---|
advertiserId | O identificador da imobiliária no portal |
visible | Se o anúncio é publicado visível |
O que cada um significa e como se manda:
a chave publication.
As zonas não se mapeiam por API. Os mapeamentos zona sua → zona Argenprop são mantidos por nós; você manda a sua zona e a gente resolve o resto. Se uma zona não estiver mapeada, o verificador avisa antes de publicar. Os catálogos de localização estão em Zonas.
Relacionado
- PropertyAPI — o índice de toda a API
- Publicação — os portais disponíveis e o que os diferencia
- Zonaprop — o outro portal com seção própria