BETA

PUT /properties/{paId}

Es REEMPLAZO TOTAL: mandás el objeto completo, igual que en el alta. Lo que no mandes, se vacía.

Por eso la respuesta trae un diff, y los campos que se vaciaron van aparte en cleared.

Resource URL

PUT https://property-api.mapaprop.com/property-v1/properties/{paId}

Autenticación

Authorization: Bearer <tu token>. Requiere el scope property-api-update.

curl -X PUT https://property-api.mapaprop.com/property-v1/properties/01M3PTZ8YBMM5DSNW03WP8VD9E \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d @propiedad.json

El cuerpo

El mismo objeto del alta, completo, en canonical:

{
  "canonical": { "…el objeto de la propiedad, entero…" }
}

Los campos están en El objeto JSON de la propiedad.

No es un PATCH. Mandar {"canonical": {"price": 230000}} no cambia sólo el precio: borra todo lo demás. Si querés cambiar un campo, tomá el objeto que te devuelve el GET, modificá ese campo y mandá el objeto entero.

La respuesta

La respuesta trae el clientRef, el mismo que mandaste en el sobre. Te lo devolvemos en los seis caminos (verify, alta, consulta, listado, edición y borrado) para que puedas cruzarlo con tu base sin tener que recordar con qué clientRef preguntaste.

200 OK. Es la respuesta del alta —object, portals, summary— más el acuse y el diff:

{
  "paId": "01M3PTZ8YBMM5DSNW03WP8VD9E",
  "updated": true,
  "updatedAt": "2026-09-29T23:41:02.118Z",
  "status": "active",
  "diff": {
    "property": {
      "price":       { "from": 245000, "to": 230000 },
      "description": { "from": "Departamento de 2 ambientes en el corazón…(1240 ch)", "to": "…(1310 ch)" },
      "toilettes":   { "from": 2, "to": null }
    },
    "assets":  { "added": 2, "removed": 1, "unchanged": 7, "reordered": false },
    "cleared": ["toilettes"],
    "changed": 6
  },
  "images": { "status": "processing", "total": 9, "processed": 7 }
}

diff.property — qué campos cambiaron

Uno por campo, con su valor anterior y el nuevo. El texto largo se resume con su largo real (…(1240 ch)) para que la respuesta siga siendo leíble.

images y blueprint no aparecen acá: tienen su propio bloque.

🔑 diff.cleared — qué se vació

La lista de campos que tenían valor y ahora no. Es la consecuencia del reemplazo total, puesta aparte para que se vea de un golpe.

Si cleared trae algo que no querías vaciar, mandá el PUT otra vez con ese campo incluido. Nada se publicó todavía.

diff.assets — las fotos

"assets": { "added": 2, "removed": 1, "unchanged": 7, "reordered": false }

Se comparan por URL, no por posición. Reordenar tus fotos sin cambiarlas da unchanged y reordered: true — no cuenta como fotos nuevas.

CampoQué es
addedURLs que no estaban antes: son las que bajamos
removedURLs que ya no están en el objeto
unchangedLas que siguen. No se vuelven a bajar
reorderedLas mismas fotos en otro orden. Importa: la primera es la principal

Las imágenes nuevas pasan por el mismo ciclo

Si el PUT trae URLs nuevas, images.status vuelve a processing y la propiedad queda bloqueada mientras las bajamos — igual que en el alta. Las que ya estaban alojadas no se vuelven a bajar.

Lo que el PUT cambia en tu cuenta de Mapaprop

Si la propiedad ya está dada de alta en tu cuenta de Mapaprop, el PUT propaga el cambio allá: el título, la descripción, los metros, el precio y su historial, los precios alternativos, los videos, el plano y las fotos. Es una sola llamada: no hay endpoints aparte para el precio o para las fotos.

Tu objeto es la realidad completa de la propiedad. Lo que mandás reemplaza lo que hay en la cuenta — también si alguien lo editó a mano desde Mapaprop. Si corrigieron el precio en la webapp y después mandás un PUT, queda el precio de tu objeto.

Lo mismo vale para el estado comercial: si tu objeto dice que la propiedad no está vendida, queda no vendida, aunque en la cuenta figurara como vendida. Tu sistema es la fuente.

Dos cosas que el PUT no toca:

  • La publicación. Si la propiedad estaba publicada, sigue publicada; si no lo estaba, sigue sin publicar. Publicar es una acción aparte.
  • Lo que resolvemos nosotros: la zona, y las URLs de las fotos que ya alojamos.

Cuánto tarda en verse en tu cuenta

El PUT te contesta en cuanto guarda la propiedad; el cambio viaja a la cuenta de Mapaprop después. Medido en producción: unos 8 segundos para un cambio que no trae fotos nuevas.

Si el PUT trae fotos nuevas, primero las descargamos —images.status te dice cómo va— y el cambio llega a la cuenta cuando termina ese procesamiento.

Esos segundos son una referencia, no una garantía: dependen de cuántas fotos mandes. La señal que manda es el GET, no un reloj — si el bloque mapaprop trae update con status: "pending", el cambio todavía está en camino; si trae status: "failed", no llegó y te dice por qué.

Los desarrollos: las unidades también se reemplazan

Si el objeto es un desarrollo, la lista development.units manda igual que el resto:

units en tu objetoQué pasa
no vienelas unidades vinculadas quedan como están
[] (lista vacía)se desvinculan todas
[A, B]quedan vinculadas exactamente esas dos

Desvincular una unidad no la borra: sigue siendo una propiedad tuya, sólo deja de pertenecer al desarrollo.

Las fotos: ausente no es lo mismo que vacío

images en tu objetoQué pasa
no vienelas fotos quedan como están
[] (lista vacía)se borran todas
[a, b]quedan exactamente esas dos, en ese orden

Las fotos nuevas se descargan antes de llegar a la cuenta, así que el cambio aparece cuando termina ese procesamiento. Las que ya estaban alojadas no se vuelven a bajar.

Recién diste de alta la propiedad: esperá el alta

Un PUT disparado en los segundos siguientes al POST se cruza con el alta, que todavía está escribiendo los precios y las fotos en la cuenta. En ese caso te devolvemos 409 registration_in_progress con retryAfterSeconds: reintentá el PUT pasados esos segundos.

{
  "error": "registration_in_progress",
  "detail": "La propiedad se está dando de alta en Mapaprop en este momento…",
  "retryAfterSeconds": 8
}

Si querés evitar el reintento, esperá a que el GET devuelva el bloque mapaprop con state: "synced" y accessories antes de mandar el PUT.

Errores

CódigoCuándo
400 canonical_missingFalta canonical en el body
401Token ausente, vencido o inválido
403 missing_scopeFalta el scope property-api-update
404Ese paId no existe, o está borrado
409Otra propiedad tuya ya usa ese code — el código es único por cuenta. Te devolvemos el paId de la que lo tiene
409images_processing — la propiedad está procesando sus imágenes
409registration_in_progress — el alta en Mapaprop todavía está escribiendo. Reintentá pasados los retryAfterSeconds

Un PUT sobre una propiedad borrada devuelve 404: no la resucita. Para volver a tenerla, dala de alta de nuevo — te va a dar un paId nuevo.

Lo que el PUT todavía NO hace

No republica en los portales. Guarda la propiedad y te dice qué cambió, pero el aviso que ya esté publicado en un portal no se actualiza solo. Eso llega con el paso de publicación.

Relacionados