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 clienteClientes — la ficha de la inmobiliaria, una vez por cliente
2 · Conectar su cuentaConectar con un enlace — Zonaprop se conecta con un enlace que abre tu cliente, no con credenciales que mandes vos
3 · Cargar la propiedadAlta de propiedades · Verificar antes
4 · PublicarPublicar — 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 renuevaCupo mensual y límites
Los planes de publicación de tu cliente y cuántos le quedanLos 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 unidadesPublicar un desarrollo
Las consultas que deja la gente en los avisosLeads
Los usuarios de tu cliente en el portal — para elegir el asesor del avisoLos 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 sistemaconectarlo 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ísQué te daCupo
GET .../customers/zonapropapi/usersTodos los usuarios con su correo y su rol — que es lo único que necesitás para agentEmail0 llamadas
El mismo, con ?detail=trueAdemás el nombre y los teléfonos de los asesores1 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