Despublicar de un portal
Cuando querés que el aviso deje de estar publicado en el portal, esto lo da de baja.
No borra la propiedad: sigue en tu inventario y podés volver a publicarla cuando quieras.
DELETE /property-v1/properties/{paId}/publication/{portal}
Mismo scope que publicar ({portal}:publish), mismo paId, sin body.
curl -X DELETE "https://property-api.mapaprop.com/property-v1/properties/01M3Z4MF6S817S9V8QADXFFXN3/publication/zonapropapi" \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: $CLIENT_REF"
{ "status": "unpublished",
"portal": "zonapropapi",
"paId": "01M3Z4MF6S817S9V8QADXFFXN3",
"quota": { "remaining": 1479, "limit": 1500 } }
Una baja puede volver incompleta, y eso es un 200
{ "status": "partially_unpublished", "portal": "argenpropapi", "paId": "01M…",
"detail": "La baja quedó incompleta por el presupuesto de la llamada…" }
Pasa cuando el desarrollo tiene muchas unidades: bajarlo exige desconectar cada una, y eso no siempre
entra en una llamada. No es un error —el portal no rechazó nada— así que viene como 200.
| El aviso | sigue publicado, a propósito |
| Qué hacer | repetir la baja. Cada vez retoma donde quedó la anterior |
| Cuándo terminó | cuando el status vuelve unpublished |
| Cuántas vueltas | pocas: un desarrollo de 50 unidades se baja en ~5, no en decenas |
🔴 El aviso queda publicado porque bajarlo ahí sería peor. Si lo bajáramos con unidades todavía conectadas, el portal borraría esas unidades. Preferimos dejarlo publicado y que lo repitas.
Si bajás un desarrollo, la respuesta puede traer la cuenta aviso por aviso
Un desarrollo es una llamada pero varios avisos (el padre y sus unidades). Cuando el portal los
reporta uno por uno, te pasamos esa cuenta en un bloque development, y los tres números suman el
total: unpublished + withError + processing.
processing no es un fallo: el portal aceptó la baja y todavía está trabajando. Está separado de
withError justamente para que no lo leas como un error.
El desglose completo, con el ejemplo y las listas de códigos, está en publicar un desarrollo.
Es idempotente: llamalo las veces que quieras
Si el aviso ya no estaba publicado, igual recibís 200. No es un error: el resultado que buscabas ya se cumplió.
Eso hace que reintentar sea siempre seguro, incluso después de un 502 donde no sepas si la baja llegó.
La respuesta no te dice si la baja la hizo esta llamada o si el aviso ya estaba abajo, y es a propósito: el portal no lo distingue — contesta lo mismo en los dos casos. Un campo que prometiera esa diferencia sería una constante disfrazada de información.
Lo que sí podés mirar es quota: si bajó, la llamada tocó el portal.
Los errores
| Código | Qué pasó | Qué hacer |
|---|---|---|
404 | esa propiedad no está en tu inventario | revisá el paId |
409 | la cuenta no está conectada al portal | sin conexión no podemos nombrar el aviso del otro lado |
409 | el portal ya no reconoce la cuenta de tu cliente como parte de tu integración (portal_account_unlinked) | volvé a conectarla: pedí un enlace. Reintentar la baja no la recupera |
409 | el portal tiene la cuenta deshabilitada o bloqueada (portal_account_blocked) | escribinos con el reference; reintentar no la habilita, y el vínculo con el portal lo gestionamos nosotros |
502 | el portal rechazó la baja, o no respondió | si no respondió, puede haberse dado de baja igual: reintentá |
Los dos 409 son del estado de la CUENTA, no del aviso, así que no cambiamos nada de tu lado: el
aviso queda como estaba en nuestro registro. Cuando la cuenta se destrabe, repetí la baja.
Tres cosas que conviene tener presentes
- Gasta cuota. Una baja consume una llamada de las de tu cliente en el portal, igual que publicar.
- Despublicar no borra la propiedad. Sigue en tu inventario y podés volver a publicarla cuando quieras con el mismo
paId— el aviso se recrea, no se duplica. - 🔴 Una baja mientras el portal procesa la publicación anterior NO la cancela. El
200dice que el portal aceptó la baja, no que el aviso haya quedado abajo: si todavía tenía pendiente el publish —típico en desarrollos con muchas unidades, que van en diferido—, lo termina después y el aviso vuelve a quedar online. Es la misma ventana que produce el409 portal_processingdel publish. Medido el 2026-10-08 contra Zonaprop: baja a los 3 s de un publish en diferido → online de nuevo ~2,5 min más tarde. ⇒ Esperá a queprocessingStatedeje de decir que lo está procesando (lo trae la consulta de estado) y recién entonces bajalo.
Relacionado
- Publicar en un portal — el
PUT, y qué pasa al volver a llamarlo - La clave
publication— qué configurar dentro del objeto