Cuando algo no sale
El orden de abajo no es arbitrario: va de gratis a caro y de lo que podés ver vos a lo que tenemos que mirar nosotros. Los dos primeros pasos resuelven la mayoría de los casos y no gastan nada del cupo de tu cliente.
El orden
1 · leé el error completo gratis — y casi siempre dice qué paso falta
2 · verificá el objeto gratis — POST /properties/verify
3 · leé lo que tenemos guardado gratis — GET /properties/{paId}
4 · preguntale al portal cuesta 1 llamada
5 · escribinos con la referencia del paso 1
1 · El error completo, no sólo el código
Nuestros errores están escritos para que digan qué hacer, no sólo que algo falló. Además del código traen una descripción y, cuando corresponde, el nombre del campo o del portal.
Lo más importante: un error de los nuestros te dice si el problema es tuyo (algo en lo que mandaste) o del paso anterior (falta la ficha, falta la conexión). Si dice que falta conectar la cuenta, no es un problema de permisos de tu token.
2 · Verificar el objeto (gratis)
POST /properties/verify con el mismo objeto que te falló.
Te dice, portal por portal, qué falta. No le pregunta nada al portal, así que no gasta cupo ni
depende de que el portal esté arriba.
Separa dos cosas que conviene no mezclar:
- Lo que falta en el objeto → está en tu control.
- Lo que falta de la cuenta (el plan, la sucursal) → sale de la conexión, no de la propiedad.
3 · Lo que tenemos guardado (gratis)
GET /properties/{paId} te muestra lo que registramos: si
la propiedad existe, qué portales tiene, y qué pasó en el último intento de publicación.
Es el paso que contesta "¿llegó mi llamada?" sin gastar nada.
4 · Preguntarle al portal (1 llamada)
GET …/publication/{portal} es lo único que sabe si el
aviso está online ahora y cuál es su URL.
Dejalo para el final: es lo único que cuesta, y los tres pasos anteriores suelen explicar el problema sin él.
Los casos que más aparecen
| Lo que ves | Por dónde empezar |
|---|---|
| "Publiqué y no veo el aviso" | El portal puede tardar en mostrarlo. El paso 4 te dice si él ya lo tiene; si dice que sí, es tiempo de publicación del portal, no un problema de la integración |
| "Volví a publicar enseguida y me lo rechazó" | El portal procesa de a una por aviso: mientras termina la anterior, no acepta la siguiente. Te lo decimos como temporal, con cuántos segundos esperar — esperá y reintentá, no cambies nada. Pasa más con desarrollos grandes, donde el portal trabaja en diferido |
| "Lo dí de baja y volvió a aparecer online" | La baja llegó mientras el portal todavía procesaba la publicación: contestó bien, y después el portal terminó su trabajo pendiente y lo volvió a publicar. Esperá a que deje de estar procesando y bajalo de nuevo. Pasa con desarrollos grandes, donde el diferido es de minutos |
| El plan que pedí no está disponible | La respuesta del publish te dice cuáles sí tiene tu cliente. Si no esperabas eso, refrescá los planes contra el portal: pudo haber consumido o vencido alguno |
Un 403 | Mirá qué scope dice que falta. Si nombra un portal, tu token no está habilitado para ese portal — es distinto de no poder leer o escribir |
| Dice que la cuenta no está conectada | Pedí la ficha del cliente (gratis) y mirá el estado de sus conexiones. Puede que tu cliente la haya desconectado del lado del portal |
| 🔴 "Andaba, y de golpe me rechaza TODO" — publicar, bajar, consultar y leer planes, al mismo tiempo, sin que hayas tocado nada | Casi siempre es que la cuenta de tu cliente se reconectó desde otro lado. Hay portales que admiten una sola conexión por inmobiliaria —Zonaprop es uno—, así que la última apaga la anterior. Se arregla volviendo a conectarla por la API: Conectar con un enlace. El detalle, en Zonaprop |
| Una lista de consultas vacía | Antes de asumir que no hay, chequeá qué modo soporta ese portal: puede que ahí las consultas no se pidan, sino que lleguen solas |
Dice que la zona no existe (zone2, rule: not_found) | El value trae el código de 4 segmentos que buscamos. Compará contra el catálogo de zonas: o la zona cambió, o tu tabla de equivalencias quedó vieja. La jerarquía también cuenta: una zone2 correcta colgada de otra zone1 no existe |
Un atributo no se publicó (attributes[n].id, rule: unknown) | Ese id no existe en el catálogo de ese país — y los catálogos son distintos entre países. Pedí el catálogo con el país de la propiedad y comparalo |
| Un dato que mandaste no aparece | Verificá (paso 2): si el portal no soporta ese campo, te lo decimos ahí en vez de descartarlo en silencio |
| "Asigné puntos y la posición no cambió" | Mirá el saldo, no la posición. El portal tarda en recalcular: si el saldo bajó, se aplicó. La posición se actualiza más tarde — y el número de la simulación es la estimación, no una promesa. Pagar por posición |
La simulación vuelve vacía con segment_insufficient_data | El mercado de esa propiedad es muy chico para que el portal tenga estadísticas. No hay números que darte — no es un fallo nuestro ni algo que puedas reintentar |
La simulación vuelve vacía con not_indexed | Publicaste hace muy poco. El saldo y la posición vienen igual; esperá y volvé a pedirla |
No obtuvimos respuesta del portal (portal_unreachable) | No significa que tu dato esté mal: significa que no sabemos qué pasó. La escritura pudo entrar o no. Reintentá — repetir la misma llamada no duplica nada (abajo) |
| Parte de un desarrollo quedó sin asociar | El desarrollo queda publicado y lo que falló te vuelve por unidad con su motivo. Repetí el publish del desarrollo: se re-hace sólo lo que falta |
Reintentar es seguro, y sólo re-hace lo que falta
Vale para todos los portales, no es particular de ninguno: repetir una operación de publicación no duplica avisos ni rehace trabajo ya hecho. Antes de escribir, comparamos contra lo que el portal tiene y actuamos sobre la diferencia.
| Si repetís… | Qué pasa |
|---|---|
| el publish de un aviso que ya está publicado | se actualiza, no se crea otro |
| el publish de un desarrollo | el padre se actualiza, y de las unidades se tocan sólo las que faltan |
| una baja de algo que ya no estaba | contesta bien igual. No tenés que llevar la cuenta |
El alta en Mapaprop tiene su propio reintento
Si tu token fue emitido desde una cuenta de Mapaprop, la propiedad se da de alta ahí sola. Cuando eso
se frena, el bloque mapaprop del GET dice por qué y
POST /properties/{paId}/mapaprop lo vuelve a intentar.
state | qué hacer |
|---|---|
rejected | corregí el objeto con el PUT y después reintentá: el bloque nombra el campo |
blocked | no reintentes: es el estado de la cuenta y lo resolvemos nosotros |
synced sin imágenes | reintentá: manda sólo los accesorios, no crea la propiedad de nuevo |
⚠️ Lo que sí cuesta es el cupo de tu cliente: cada llamada al portal se le cobra a él, así que reintentar en loop no es gratis aunque sea seguro. Si un error te dijo que esperes, esperá ese tiempo.
🔴 Y la distinción que más confunde: que el portal rechace tu dato y que no nos contesten no son lo mismo, aunque los dos lleguen como un fallo de esa unidad.
| Qué significa | Qué hacer | |
|---|---|---|
| el portal rechazó | tu dato o tu cuenta: falta algo, sobra algo, el aviso no existe todavía | corregir y volver |
| no obtuvimos respuesta | no sabemos si entró. El motivo es portal_unreachable | reintentar, sin cambiar nada |
Lo que conviene descartar antes de escribirnos
- ¿El error decía que era TEMPORAL? Si te dijimos que esperes y reintentes —y cuántos segundos—, probá eso primero: hay rechazos que se resuelven solos y no hay nada que arreglar.
- ¿Verificaste el objeto? Es gratis y contesta la mayoría.
- ¿El error nombra un paso anterior (ficha, conexión)? Entonces el problema no está donde estás mirando.
- ¿Estás usando el identificador que te devolvimos, y no uno tuyo, donde la ruta pide el nuestro?
- ¿El portal soporta eso? No todos soportan todo, y lo que no, lo decimos sin gastar cupo.
5 · Escribinos
El soporte sube por la cadena: tu cliente te escribe a vos, y vos nos escribís a nosotros. No hace falta —ni conviene— que tu cliente le escriba al portal por algo de la integración.
El motivo es estructural, no una preferencia nuestra: el vínculo con el portal lo tiene Mapaprop. Tu sistema no figura como integración del lado del portal, así que un reclamo presentado a su nombre cae en una conversación que del otro lado nadie puede ubicar. Vos nos escribís y nosotros lo encauzamos.
⚠️ Esto no cambia lo que tu cliente contrata. Su cuenta, su abono y su plan los sigue teniendo con el portal, directamente — eso nunca pasó por nosotros. Lo que sube por la cadena es el problema de la integración, no la relación comercial.
dev@mapaprop.com. Lo que más acelera la respuesta:
- La referencia que vino en el error. Con eso encontramos tu llamada exacta en nuestros registros — es la diferencia entre mirar el caso y pedirte que lo reproduzcas.
- Qué esperabas y qué pasó, en ese orden.
- El
clientRefy el identificador de la propiedad.
No nos mandes tu token ni la credencial de tu cliente. No los necesitamos para diagnosticar, y si los mandaste por error, decinos para que te ayudemos a rotarlos.
Relacionado
- Buenas prácticas — los flujos completos
- Verificar — el paso 2, el más rentable
- Publicación — qué soporta cada portal