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 devuelve | Cuota | |
|---|---|---|
GET /properties/{paId} | el último estado que ya teníamos, en published.{portal}.remote | gratis |
GET …/publication/{portal} (esta página) | le pregunta al portal ahora | 1 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 portal | remoteStatus queda en |
|---|---|
publicationState: ONLINE | published |
publicationState: OFFLINE | unpublished |
un PLAN (HOME_ZONA_DEMAND, SIMPLE…) con onlineAt y sin offlineAt | published |
un PLAN con offlineAt | unpublished |
| un estado de la OPERACIÓN (reservado, vendido, alquilado) | published — ver abajo |
| el aviso no existe en el portal | unpublished |
| algo que no reconocemos y sin fechas | no 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?
inSync | Qué significa | Qué hacer |
|---|---|---|
true | el portal coincide con lo que esperabas | nada |
false | cambió sin que lo pidieras — se cayó, o venció el plan | volvé a publicar si lo querés arriba |
null | el portal no nos dio con qué decidir: un estado que no interpretamos y sin onlineAt | mirá 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.
| Zonaprop | Argenprop | |
|---|---|---|
| El estado | publicationState + 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étricas | visits | points, los del aviso |
| Procesamiento | processingState | no informa |
| Imágenes y avisos | imagesStatus · errors · warnings | no 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:
| Campo | Qué es |
|---|---|
portalItemId | el id que el portal le dio al aviso. Es lo que forma la URL. Está en los dos portales |
publicationState | ONLINE / OFFLINE, o el nombre del plan mientras está online. Ver la nota de arriba |
processingState | en 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 · offlineAt | cuándo salió y cuándo se dio de baja |
createdAt · modifiedAt | del lado del portal, no del tuyo |
visits | visitas que registró el portal. null si no las informa |
errors · warnings | tal como los manda el portal, sin traducir |
imagesStatus | qué hizo el portal con cada imagen |
exists | false si el aviso no está en el portal |
checkedAt | cuá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 pregunta | El 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ódigo | Qué pasó | Qué hacer |
|---|---|---|
200 | el estado del aviso | — |
403 | tu token no tiene el scope {portal}:publish | escribinos para habilitarlo |
404 | esa propiedad no está en tu inventario | revisá el paId y el x-client-ref |
409 | la cuenta no está conectada al portal | pedí un enlace de conexión |
501 | todavía no podemos consultar el estado en ese portal | el portal viene en portal |
403 | ese 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 |
409 | el portal ya no reconoce la cuenta de tu cliente (portal_account_unlinked) | volvé a conectarla: pedí un enlace |
409 | el portal tiene la cuenta deshabilitada o bloqueada (portal_account_blocked) | escribinos con el reference: el vínculo con el portal lo gestionamos nosotros |
502 | no pudimos preguntarle al portal | volvé 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
- Publicación en portales — los tres métodos del mismo endpoint
PUTpublicar ·DELETEdespublicarGET /properties/{paId}— la lectura que no gasta cuota