Mapaprop

Mapaprop

Mapaprop es, además del sistema que estás integrando, uno de los destinos donde puede terminar tu propiedad. Y es el único que no tenés que pedir.

Si sos cliente de Mapaprop y generaste tu token desde la app (Mapaprop > App y Token), cada propiedad que cargues por esta API se da de alta sola en tu cuenta. No hay un paso que pedir ni un endpoint que llamar.

Si tu token no salió de una cuenta de Mapaprop —el caso de un integrador que publica en portales para clientes que no son clientes nuestros— nada de esta página te aplica: tus propiedades viven sólo en PropertyAPI y se publican en los portales que conectes.

Las dos cosas, que no son la misma

Es la distinción que conviene tener clara antes de seguir:

Qué esQuién lo dispara
El altala propiedad existe en tu cuenta de Mapaprop, como si la hubieras cargado desde la appsola, sin que pidas nada
La publicaciónesa propiedad sale publicada en tu sitio y en los portalesvos, con PUT …/publication/{portal}

Que esté dada de alta no significa que esté publicada. Queda en tu cuenta como cualquier propiedad cargada a mano, y publicarla es una decisión tuya — la misma que tomarías desde la app.

Cuándo pasa

El alta no es instantánea, y hay un motivo: las fotos.

1 · POST /properties        guardamos la propiedad y te devolvemos el paId
2 · bajamos las imágenes    las descargamos de donde las tengas y las alojamos nosotros
3 · alta en tu cuenta       ← se dispara sola cuando termina el paso 2

Una propiedad llega a tu cuenta con sus fotos ya cargadas, que es la única forma en que sirve. Por eso espera a que la ingesta termine en vez de crearse vacía y completarse después.

Cómo sabés que salió

En el bloque mapaprop, que viaja tanto en la respuesta del POST como en el GET de la propiedad:

{
  "mapaprop": {
    "state": "synced",
    "propertyId": 2619527,
    "branchId": 1,
    "message": "La propiedad existe en tu cuenta de Mapaprop con el id 2619527 (sucursal 1)…"
  }
}

El propertyId es el id de Mapaprop, distinto del paId de esta API. Es el que te sirve para encontrarla en la app.

statequé pasó
pendingtodavía no corrió: la ingesta de imágenes no terminó
syncedla propiedad existe en tu cuenta
rejectedalgo del objeto no se pudo guardar. El bloque nombra el campo
blockedla cuenta no está en condiciones. Lo resolvemos nosotros
exhaustedse agotaron los reintentos automáticos

Los estados, qué hacer con cada uno y cómo reintentar están en Reintentar el alta.

Verificá antes de postear. POST /properties/verify es gratis y revisa el objeto contra el mismo contrato, así que un valor que el alta no podría guardar te lo decimos en el momento, en vez de que te enteres minutos después en el bloque.

Qué entra con la propiedad

Todo lo que mandaste en el objeto, en la misma llamada:

Las fotoscon su rotación y su miniatura, como una foto cargada desde la app. La que marques main queda como principal
El planouno por propiedad. Tiene que ser una imagen, nunca un PDF
Los videosel link de la plataforma, no el archivo
Las expensas y los impuestoscon su moneda y el período de pago
Los precios alternativos"por semana", "por temporada" y los que declares

Si algo de esto falla y la propiedad sí se creó, el bloque mapaprop lo dice y el reintento manda sólo lo que falta — no vuelve a crear la propiedad.

En qué sucursal entra

En la que declares en branchId. Si no mandás ninguna, entra en la sucursal principal de la cuenta — y la respuesta te dice en cuál quedó, así que no tenés que adivinarlo.

Las sucursales de tu cuenta, con sus ids, salen de GET /branches.

Publicar en Mapaprop

Una vez dada de alta, se publica como cualquier otro destino, pasando mapaprop donde la ruta pide {portal}:

PUT    /property-v1/properties/{paId}/publication/mapaprop
GET    /property-v1/properties/{paId}/publication/mapaprop
DELETE /property-v1/properties/{paId}/publication/mapaprop

Relacionado