Publicación
Cuando la propiedad ya está cargada y la cuenta del portal conectada, acá se publica — y se da de baja.
Las tres operaciones van a la misma ruta, y lo que cambia es el método:
/property-v1/properties/{paId}/publication/{portal}
Los tres métodos
| Qué hace | Scope | |
|---|---|---|
PUT | Publica la propiedad. Volver a llamarlo actualiza, no duplica | {portal}:publish |
DELETE | Da de baja el aviso. Idempotente: si ya no estaba, igual contesta 200 | {portal}:publish |
GET | Le pregunta al portal cómo está el aviso: su URL, si sigue online, las visitas. ⚠️ gasta cupo | {portal}:publish |
GET/PUT …/positioning | Pagar por posición: el saldo, el techo, dónde está el aviso y una simulación de qué posición conseguirías. ⚠️ gasta cupo, y la simulación cuesta una llamada por valor | {portal}:publish |
Los tres usan el mismo scope: quien puede publicar puede despublicar y consultar.
📌 No hay un cuarto método para el ESTADO de la propiedad (reservada, vendida, alquilada): viaja
en el objeto y se aplica dentro del PUT —
el estado de la propiedad en el portal.
El GET de esta ruta no es el de /properties/{paId}.
Ése lee lo que ya tenemos guardado y es gratis; éste le pregunta al portal y gasta una llamada del
cupo del cliente. Son dos operaciones distintas.
Los portales
Esta tabla es la referencia: el resto de la documentación es genérica a propósito y te manda acá en vez de repetir el dato de un portal como si valiera para todos.
| Portal | {portal} en la ruta | Clave en publication | Publicar |
|---|---|---|---|
| Zonaprop | zonapropapi | zonaprop | ✅ disponible |
| Argenprop | argenpropapi | argenprop | ✅ disponible — avisos sueltos y emprendimientos |
| Cabaprop | cabapropapi | cabaprop | ⏳ todavía no |
| MercadoLibre | mercadolibreapi | mercadolibre | ⏳ todavía no |
| Mapaprop | mapapropapi | — | ✅ disponible — ver abajo: no es un portal externo |
Mapaprop está en la tabla pero no es un portal externo, y la diferencia cambia tres cosas:
no hay cuenta que conectar (es la cuenta de tu cliente, la misma de la app), no gasta cuota de
nadie, y no tiene clave en publication porque no hay nada que configurar. Lo que sí tiene de
propio: publicar ahí también publica en las redes donde tu cliente esté, y despublicar no
baja los avisos de los portales externos. El detalle está en
Mapaprop.
El portal tiene dos nombres y no son intercambiables. En la ruta va el nombre de la API
(zonapropapi); dentro de la clave publication
va el nombre corto (zonaprop). Si los cruzás te lo decimos con el nombre puesto: dentro de
publication sale portal desconocido. Válidos: argenprop, zonaprop, cabaprop, mercadolibre, y en
la ruta sale portal_no_soportado.
Hoy PropertyAPI publica en Argentina. Los cuatro portales son argentinos o están habilitados sólo ahí: Argenprop y Cabaprop no existen en otros países, y en Zonaprop y MercadoLibre la habilitación por país es un paso que todavía no dimos. Si tu cliente no es de Argentina podés cargar y verificar su inventario igual — lo que no tiene es portal al que publicar. Escribinos a dev@mapaprop.com si necesitás otro país: nos ayuda a priorizarlo.
"Todavía no" aplica sólo a publicar. Lo demás ya funciona en los cuatro: podés conectar la cuenta, cargar la propiedad y verificarla — el verificador te dice, portal por portal, si ese aviso saldría. Así podés tener tu integración lista antes de que el portal se habilite.
Qué cambia en cada portal
| Zonaprop | Argenprop | Cabaprop | MercadoLibre | |
|---|---|---|---|---|
| Cómo se conecta | un enlace que abre tu cliente | un enlace o credencial — el enlace es el camino recomendado | credencial (OAuth) | credencial (OAuth) |
| La credencial | no existe: la autorización queda del lado del portal | la obtenés vos y la guardamos cifrada | ídem | ídem |
| Cupo de llamadas | 1.500 por mes y por inmobiliaria | lo define el portal | lo define el portal | lo define el portal |
| Planes de publicación | nombrados y consultables | no usa planes: puntos de abono, que el portal no publica por API | — | — |
Sus datos propios en publication | plan · branch · developmentCategory | advertiserId · visible | branchOfficeId | listingTypeId · condition · sellerContact |
| Emprendimientos | ✅ las unidades viajan dentro de la publicación del desarrollo: una sola llamada | ✅ pero cada unidad se publica primero y después el desarrollo las toma: el flujo lo explica | ⏳ todavía no | ⏳ todavía no |
| Qué acepta cambiar un re-publish | sin medir | todo menos el type — incluida la zona. El tipo de propiedad no se puede cambiar sobre un aviso que ya existe: hay que dar de baja y volver a publicar | — | — |
El cupo es del cliente, no tuyo ni nuestro. Lo contrata él con el portal, lo gasta tu integración, y cada portal lo define a su manera — el número de Zonaprop no es la norma de la API. Detalle de ese caso: Cupo mensual y límites.
De los datos propios, publication controla el tipo, no la presencia: si mandás advertiserId
como texto te lo marca, pero no te exige mandarlo. Lo que cada portal necesite de verdad lo dice el
PUT cuando falta — en su 409, con el nombre del campo. Qué significa cada uno:
la clave publication.
Cada portal con sección propia tiene lo suyo ahí: Zonaprop · Argenprop · Cabaprop todavía no tiene sección propia.
Y la configuración
La clave publication — el plan y los datos de portal que viajan dentro del objeto, para no tener que mandarlos en cada llamada.
Antes de publicar
Tres cosas, en este orden:
- La ficha de tu cliente — Clientes
- Su cuenta del portal conectada — Conectar con un enlace o con la credencial
- La propiedad cargada, con su
paId— Alta de propiedades