BETA

Consultar el estado en el portal

GET /property-v1/properties/{paId}/publication/{portal}

Es la forma de saber cómo está el aviso del otro lado: si sigue online, cuál es su URL pública, cuántas visitas tuvo y si el portal registró algún error.

Esta llamada gasta una llamada de la cuota mensual del cliente en el portal, igual que publicar. Si sólo necesitás el último estado conocido, GET /properties/{paId} te lo da sin gastar nada.

curl https://property-api.mapaprop.com/property-v1/properties/01M41AQNXYG4W4SEEEEPHEDNX4/publication/zonapropapi \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-client-ref: cliente-42"
{
  "paId": "01M41AQNXYG4W4SEEEEPHEDNX4",
  "portal": "zonapropapi",
  "remoteStatus": "unpublished",
  "inSync": false,
  "remote": {
    "portalItemId": 60321762,
    "url": "https://www.zonaprop.com.ar/propiedades/clasificado/-60321762.html",
    "publicationState": "OFFLINE",
    "processingState": "PROCESADO",
    "onlineAt": "2026-10-03T17:14:06.000Z",
    "offlineAt": "2026-10-03T04:00:00.000Z",
    "createdAt": "2026-10-03T17:14:05.000Z",
    "modifiedAt": "2026-10-03T17:14:28.000Z",
    "visits": 0,
    "errors": [],
    "warnings": [],
    "imagesStatus": [],
    "exists": true,
    "checkedAt": "2026-10-03T18:42:57.716Z"
  },
  "quota": { "remaining": 1443, "limit": 1500 }
}

La URL del aviso

remote.url es dónde se ve el aviso publicado. No se puede construir desde tu lado: lleva el id interno del portal (remote.portalItemId), que es distinto del código con el que publicás.

remote.url viene en null si todavía no tenemos el id del portal, o si no podemos armar la URL con certeza para el país de la propiedad. No armamos una aproximada: un link que lleva a otro lado es peor que no tener link.

Las dos lecturas: una gratis y una fresca

Qué te devuelveCuota
GET /properties/{paId}el último estado que ya teníamos, en published.{portal}.remotegratis
GET …/publication/{portal} (esta página)le pregunta al portal ahora1 llamada

Para decidir entre las dos está remote.checkedAt: te dice de cuándo es el dato guardado. Si te alcanza, no hace falta volver a preguntar.

Si recorrés tu inventario entero consultando propiedad por propiedad, gastás una llamada por cada una. Con 400 propiedades son 400 llamadas del cupo mensual de tu cliente. Leé primero el estado guardado y consultá sólo lo que necesites fresco.

remoteStatus y inSync

remoteStatus es el estado del aviso, y esta llamada lo actualiza con lo que diga el portal.

Lo que dice el portalremoteStatus queda en
publicationState: ONLINEpublished
publicationState: OFFLINEunpublished
un PLAN (HOME_ZONA_DEMAND, SIMPLE…) con onlineAt y sin offlineAtpublished
un PLAN con offlineAtunpublished
un estado de la OPERACIÓN (reservado, vendido, alquilado)published — ver abajo
el aviso no existe en el portalunpublished
algo que no reconocemos y sin fechasno se toca

Un aviso con un estado de la operación sigue siendo published. Si marcaste la propiedad como vendida, el portal la oculta —eso es lo correcto— pero el aviso está: es nuestro y lo pusimos así a propósito.

"remoteStatus": "published",
"remote": { "publicationState": "VENDIDO", "visible": false }

Lo decimos así porque lo contrario te empujaría a republicar: si leyeras unpublished sobre un aviso que está perfecto, cada reintento tuyo intentaría volver a publicarlo. El publicationState te dice por qué no se ve, con el nombre del portal.

publicationState no siempre es un estado: mientras el aviso está online en un plan nombrado, el portal pone ahí el PLAN. Al darlo de baja vuelve a decir OFFLINE.

Cuando pasa eso, el estado lo resolvemos por las fechas (onlineAt / offlineAt), que es el registro que el portal lleva de cuándo entró y cuándo salió.

inSync contesta la pregunta que importa: ¿el aviso está como lo dejaste?

inSyncQué significaQué hacer
trueel portal coincide con lo que esperabasnada
falsecambió sin que lo pidieras — se cayó, o venció el planvolvé a publicar si lo querés arriba
nullel portal no nos dio con qué decidir: un estado que no interpretamos y sin onlineAtmirá remote completo y escribinos con el reference

Nosotros no volvemos a publicar por nuestra cuenta. Si el aviso se cayó, te lo decimos con inSync: false y la decisión es tuya: puede ser que ya no lo quieras arriba.

Los otros campos de remote

remote es lo que contesta el portal, así que su contenido cambia según el portal. Lo único que está en los dos es portalItemId, url, exists y checkedAt; el resto depende de qué informe cada uno. No asumas un campo porque lo viste en el otro portal.

ZonapropArgenprop
El estadopublicationState + las fechas (onlineAt / offlineAt)publicationState también, con su diccionario: VIGENTE · SUSPENDIDO · HISTORICO · RESERVADO · VENDIDO
Si se ve—visible — ⚠️ en un emprendimiento no significa eso, ver abajo
Métricasvisitspoints, los del aviso
ProcesamientoprocessingStateno informa
Imágenes y avisosimagesStatus · errors · warningsno informa

Lo que no cambia es remoteStatus, el campo de arriba: ése lo normalizamos nosotros a published / unpublished / null justamente para que no tengas que leer la forma de cada portal para saber si el aviso está arriba.

En un emprendimiento de Argenprop, visible: false es lo normal

Un emprendimiento publicado y visible en el sitio devuelve igual:

"remote": { "publicationState": "VIGENTE", "visible": false }

Medido contra el portal: para Argenprop visible y publicationState son dos ejes distintos, y en un emprendimiento —y en sus unidades— Visible viene en false aunque el aviso se vea. Nosotros transportamos ese valor tal cual, sin interpretarlo.

⇒ Para saber si está arriba, mirá remoteStatus (o publicationState), no visible. En un emprendimiento, visible: false no indica ningún problema y no hay nada que corregir.

La tabla que sigue es la de Zonaprop, que es el portal que más informa:

CampoQué es
portalItemIdel id que el portal le dio al aviso. Es lo que forma la URL. Está en los dos portales
publicationStateONLINE / OFFLINE, o el nombre del plan mientras está online. Ver la nota de arriba
processingStateen qué etapa del procesamiento está este aviso: ESPERANDO_PROCESAR (en cola), EN_PROCESO (procesándose) o PROCESADO (terminado). Es lo que el portal dice, sin interpretar — y el enum es suyo, así que puede crecer
onlineAt · offlineAtcuándo salió y cuándo se dio de baja
createdAt · modifiedAtdel lado del portal, no del tuyo
visitsvisitas que registró el portal. null si no las informa
errors · warningstal como los manda el portal, sin traducir
imagesStatusqué hizo el portal con cada imagen
existsfalse si el aviso no está en el portal
checkedAtcuándo le preguntamos

errors puede traer cosas aunque la publicación haya salido bien: son anotaciones que el portal deja por su cuenta. Van sin interpretar porque el texto del portal es más preciso que cualquier traducción nuestra.

Qué contesta processingState, y qué no

Son tres preguntas distintas y el campo contesta una:

La preguntaEl campo
¿el aviso está arriba?remoteStatus (y publicationState con las fechas, de donde sale)
¿en qué etapa está este aviso?processingState
¿ya puedo volver a escribir?🔴 ningún campo lo contesta. Se contesta reintentando

processingState no entra en el veredicto de publicación, y es a propósito. En un desarrollo el portal deja PROCESADO antes y después de darlo de baja, así que un estado deducido de ahí diría "publicado" para siempre sin fallar nunca. El veredicto sale de las fechas.

Y PROCESADO tampoco significa "ya podés escribir" en un desarrollo.

En un desarrollo grande la publicación se procesa en diferido: el aviso padre llega a PROCESADO mientras las unidades siguen en cola, y el candado de escritura del portal vive en el desarrollo completo, no en el aviso.

Con 20 unidades, PROCESADO llega a los 3 minutos y el portal sigue rechazando escrituras con 409 portal_processing casi 6 minutos más.

⇒ Si venís de un 409, el camino sigue siendo esperar y reintentar. Consultar el estado te dice en qué etapa está el aviso que preguntaste; no te dice cuándo el portal va a aceptar la próxima escritura, y no tenemos ese dato: el portal no lo manda.

Es el mismo campo y el mismo nombre en un aviso y en un desarrollo, así que la lectura que escribas te sirve para los dos — Publicar y despublicar un desarrollo.

Y antes de usarlo, mirá el costo: preguntar gasta una llamada del cupo de tu cliente; esperar es gratis. Para la ventana de procesamiento, el backoff del 409 sigue siendo lo recomendado — esto es la alternativa para quien prefiera saber en vez de esperar.

Códigos de respuesta

CódigoQué pasóQué hacer
200el estado del aviso—
403tu token no tiene el scope {portal}:publishescribinos para habilitarlo
404esa propiedad no está en tu inventariorevisá el paId y el x-client-ref
409la cuenta no está conectada al portalpedí un enlace de conexión
501todavía no podemos consultar el estado en ese portalel portal viene en portal
403ese aviso no figura en la cuenta de tu cliente en el portal (listing_not_found_or_not_yours)puede que no se haya publicado, que lo hayan dado de baja, o que esté bajo otra cuenta. El portal contesta lo mismo en los tres casos, así que no afirmamos cuál es
409el portal ya no reconoce la cuenta de tu cliente (portal_account_unlinked)volvé a conectarla: pedí un enlace
409el portal tiene la cuenta deshabilitada o bloqueada (portal_account_blocked)escribinos con el reference: el vínculo con el portal lo gestionamos nosotros
502no pudimos preguntarle al portalvolvé a intentar; no cambiamos nada de tu lado

Ninguno de esos tres cambia el estado que tenemos guardado. Un rechazo por el estado de la cuenta —o por un aviso que no figura— no dice nada sobre si el aviso está publicado, así que lo dejamos como estaba. Es la misma regla que el 502: no afirmamos lo que no pudimos medir.

El 501 no significa que el portal no exista: puede que publiques en él perfectamente y que lo que falte sea esta consulta. Hoy está disponible en Zonaprop.

Relacionado