Zonaprop
Zonaprop es uno de los portales en los que PropertyAPI publica. No tiene endpoints propios: se
publica con los mismos métodos que cualquier otro portal, pasando zonapropapi donde la ruta pide
{portal}.
PUT /property-v1/properties/{paId}/publication/zonapropapi
GET /property-v1/properties/{paId}/publication/zonapropapi
DELETE /property-v1/properties/{paId}/publication/zonapropapi
Por dónde se empieza
| 1 · Declarar el cliente | Clientes — la ficha de la inmobiliaria, una vez por cliente |
| 2 · Conectar su cuenta | Conectar con un enlace — Zonaprop se conecta con un enlace que abre tu cliente, no con credenciales que mandes vos |
| 3 · Cargar la propiedad | Alta de propiedades · Verificar antes |
| 4 · Publicar | Publicar — y el estado de lo que el portal dice |
| 5 · Elegir el nivel (se decide en el paso 4) | En Zonaprop la posición se paga con el plan del aviso, y el plan viaja en la publicación — no hay un paso posterior. Los planes que tiene tu cliente están en Los planes de tu cliente; el mecanismo, en Pagar por posición |
Lo propio de Zonaprop
| Qué | Dónde |
|---|---|
| 🔴 El cupo mensual — 1.500 llamadas por inmobiliaria, qué lo consume y cómo se renueva | Cupo mensual y límites |
| Los planes de publicación de tu cliente y cuántos le quedan | Los planes de tu cliente |
| Cómo se conecta la cuenta (con enlace, no con credencial) | Conectar con un enlace |
| Desarrollos inmobiliarios — una llamada publica el padre y sus unidades | Publicar un desarrollo |
| Las consultas que deja la gente en los avisos | Leads |
| Los usuarios de tu cliente en el portal — para elegir el asesor del aviso | Los usuarios de tu cliente |
🔴 Tu cliente tiene UNA sola conexión en Zonaprop
Es lo primero que conviene saber, porque cambia cómo le ofrecés el servicio: Zonaprop admite un solo sistema conectado por inmobiliaria. No conviven dos.
| Si tu cliente ya publica desde otro sistema | conectarlo por la API lo desconecta de ese otro. Acordalo con él antes, no después |
| Si tu cliente también usa la app de Mapaprop y conecta Zonaprop desde ahí | esa pasa a ser la conexión válida y la tuya deja de funcionar |
Esto último es el caso que más sorprende, porque no hay nada que falle en tu código: tus llamadas empiezan a volver rechazadas de un momento a otro, sin que vos hayas tocado nada.
Cómo se ve cuando pasa
El portal rechaza las llamadas diciendo que esa inmobiliaria no es de tu integración:
{ "code": "error", "message": "La inmobiliaria [...] no pertenece a la integracion ..." }
Afecta a todo a la vez: publicar, dar de baja, consultar el estado y leer los planes de tu cliente. Si lo ves en una llamada, lo vas a ver en todas.
Qué hacer
Volver a conectar la cuenta por la API — Conectar con un enlace. Tu cliente abre el enlace, autoriza, y su cuenta vuelve a quedar asociada a tu integración.
Si tu cliente usa las dos cosas, conviene decidir cuál publica. Que las alterne significa que la última conexión apaga la anterior cada vez. No es un problema de la API: es cómo funciona la cuenta en el portal.
Las zonas no se mapean por API. Los mapeos zona Mapaprop → zona Zonaprop los mantenemos nosotros; vos mandás tu zona y resolvemos el resto. Si una zona tuya no está mapeada, el verificador te lo dice antes de publicar. Los catálogos de localización están en Zonas.
El asesor del aviso, y cuándo te cuesta una llamada
En Zonaprop cada aviso tiene un asesor responsable, y podés elegirlo al publicar mandando su
correo en branch.agentEmail (Publicar).
🔴 Ese correo tiene que ser el de un usuario que exista en la cuenta de tu cliente en el portal.
Si mandás otro, Zonaprop no devuelve error: lo reemplaza por el del administrador de la cuenta y
la publicación sale 200. Por eso conviene mirar el padrón antes.
Y mirarlo no tiene por qué costarte nada:
| Qué pedís | Qué te da | Cupo |
|---|---|---|
GET .../customers/zonapropapi/users | Todos los usuarios con su correo y su rol — que es lo único que necesitás para agentEmail | 0 llamadas |
El mismo, con ?detail=true | Además el nombre y los teléfonos de los asesores | 1 llamada |
Para publicar alcanza con el primero. El segundo sirve si además querés mandar el nombre y el teléfono del asesor en el aviso, porque el portal no los deduce del correo: si elegís un asesor y no mandás los otros dos, el aviso sale con los datos de la ficha de tu cliente.
El nivel gratis trae más gente que el que cuesta: el detalle sólo existe para los usuarios con rol de asesor, así que el administrador aparece únicamente en el primero — y es justo el que el portal usa cuando no reconoce el correo que mandaste.
Los usuarios se dan de alta en el panel de Zonaprop, no por esta API, y para que figuren en el
padrón tienen que tener rol de asesor asignado. Si tu cliente suma un agente a su CRM y no lo carga
en el portal, su correo no va a funcionar como agentEmail.
Relacionado
- PropertyAPI — el índice de toda la API
- Publicación — los portales disponibles y qué los diferencia