BETA

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 avisosigue publicado, a propósito
Qué hacerrepetir la baja. Cada vez retoma donde quedó la anterior
Cuándo terminócuando el status vuelve unpublished
Cuántas vueltaspocas: 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ódigoQué pasóQué hacer
404esa propiedad no está en tu inventariorevisá el paId
409la cuenta no está conectada al portalsin conexión no podemos nombrar el aviso del otro lado
409el 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
409el 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
502el 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 200 dice 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 el 409 portal_processing del 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 que processingState deje de decir que lo está procesando (lo trae la consulta de estado) y recién entonces bajalo.

Relacionado