Publicar un desarrollo
Un desarrollo es un edificio o un barrio con unidades adentro. Si ya leíste publicar un aviso, el flujo es el mismo con una diferencia que cambia todo el orden.
Las unidades se dan de alta ANTES del desarrollo que las agrupa. No es una recomendación de estilo: el desarrollo las referencia, así que si todavía no existen, no hay nada que referenciar. Es el error número uno de este flujo y no se arregla hacia adelante — hay que volver atrás.
El camino
1 · cada unidad, por separado POST /properties ← PRIMERO. Son propiedades normales
2 · el desarrollo que las agrupa POST /properties ← referencia a las del paso 1
3 · verificar POST /properties/verify gratis
4 · publicar PUT …/publication/{portal} ← y acá cambia según el portal
5 · estado y baja igual que un aviso
El paso 4 no es igual en los dos portales, y es la diferencia que más te cambia el código.
| Zonaprop | Argenprop | |
|---|---|---|
| Las unidades | viajan dentro de la publicación del desarrollo | ya tienen que estar publicadas: el desarrollo las toma |
| Cuántas llamadas hacés | una | una por unidad, y después la del desarrollo |
En Argenprop cada unidad es un aviso del portal por derecho propio, y el desarrollo las agrupa referenciándolas. Un desarrollo no puede tomar una unidad cuyo aviso todavía no existe.
1 · Las unidades primero
Cada unidad es una propiedad normal: se da de alta con el mismo
POST /properties que cualquier otra.
⚠️ Una unidad no es un desarrollo. Tiene su propio tipo de propiedad —departamento, casa, lote— y le hereda el del desarrollo sólo si te equivocás al armarla. Si pasa, el intento de publicar te lo marca unidad por unidad, nombrando el tipo que el portal no reconoce.
Guardá el código o el identificador de cada una: es con lo que el desarrollo las va a referenciar.
En Argenprop, además, cada unidad hay que publicarla. Darla de alta acá la crea del lado nuestro; el desarrollo sólo puede tomar unidades que ya tengan su aviso en el portal. Es el paso 4.
2 · El desarrollo
Otro POST /properties, con el
objeto de desarrollo y la lista de las unidades del paso 1.
Dos cosas que conviene saber antes:
- Una unidad pertenece a un solo desarrollo. Si ya es parte de otro, te lo decimos nombrando cuál — no la reasignamos por nuestra cuenta.
- Un desarrollo se puede guardar sin unidades y cargárselas después. Lo que no se puede es publicarlo vacío.
Si sos cliente de Mapaprop y generaste tu token desde la app, este mismo paso hace algo más: el desarrollo entra solo a tu cuenta de Mapaprop cuando terminan de procesarse las fotos, y sus unidades quedan vinculadas a él. Queda cargado, no publicado — publicarlo sigue siendo el paso 4.
El desarrollo no espera a las unidades que todavía no llegaron. Vincula las que ya están y te
devuelve las otras en units.pending, con el motivo de cada una: es lo normal cuando cargás las
unidades y el desarrollo una atrás de la otra, porque cada unidad espera a que terminen de cargarse
sus fotos. Para cerrarlas,
reintentá el alta — se vinculan sólo las que faltan.
El detalle del bloque mapaprop está en
Mapaprop.
3 · Verificar (gratis, y acá rinde más que nunca)
El verificador revisa el desarrollo y cada unidad, y no cuesta nada. En Zonaprop, donde publicar es una sola llamada, un problema en una sola unidad puede frenarlo todo; en Argenprop no frena el desarrollo, pero te deja una unidad afuera. En los dos casos enterarte antes es gratis y enterarte después cuesta cupo.
Las unidades tienen que existir ANTES de verificar. El verificador no inventa lo que no está:
si el desarrollo referencia una unidad que todavía no diste de alta, te lo dice como not_found
con el código que no encontró — y de ahí concluye, con razón, que al desarrollo le faltan unidades.
Así que el orden del paso 1 también vale para verificar, no sólo para publicar.
4 · Publicar
PUT …/publication/{portal} con el desarrollo. Qué pasa
con las unidades depende del portal, y es lo único de este flujo que no es igual en los dos.
En Zonaprop: una llamada, el padre y las unidades
Las unidades viajan adentro: no las publicás una por una.
| El cupo | es una llamada, no una por unidad. Un desarrollo de 40 unidades cuesta lo mismo que uno de 2 |
Un desarrollo grande en Zonaprop sigue siendo una llamada
Nada de lo que viene abajo le aplica: las unidades van adentro, así que el tamaño no cambia el número de llamadas.
En Argenprop: cada unidad primero, el desarrollo después
Cada unidad es un aviso del portal por derecho propio, así que la publicás como publicarías
cualquier aviso —el mismo PUT …/publication/argenpropapi
sobre la propiedad— y recién entonces publicás el desarrollo, que las toma.
por cada unidad PUT /properties/{paId}/publication/argenpropapi
y al final PUT /developments/{paId}/publication/argenpropapi
| El cupo | una llamada por unidad, más la del desarrollo. Un desarrollo de 40 unidades cuesta 41 |
| El orden | si publicás el desarrollo antes, las unidades que todavía no tienen aviso te vuelven como fallo, nombrando cuál — el desarrollo sí queda publicado |
| Reintentar es seguro | tomar una unidad que ya está tomada no la duplica ni te cuesta de más |
Por qué no las publicamos nosotros por dentro. Lo evaluamos y no entra: publicar 30 avisos en una sola llamada tuya tarda más de lo que una request puede durar, y el modo de falla sería el peor —algunas publicadas, otras no, y vos sin saber qué quedó hecho—. Haciéndolo una por una, cada unidad tiene su propio presupuesto de tiempo y el flujo escala sin techo.
Y en los dos, el plan
| El plan | los desarrollos consumen un plan propio, distinto del de un aviso suelto. Cuál es y cuántos tiene tu cliente lo ves con la consulta de planes |
Según cuántas unidades tenga, el portal puede contestar de dos formas: confirmando cada aviso, o confirmando sólo el desarrollo y procesando las unidades después. Lo que te devolvemos lo explica la respuesta del desarrollo; el modo no lo elegís vos.
¿Cómo sé que se publicó todo lo que mandé?
No lo cuentes a mano. Hay dos momentos para enterarte, y el primero es el que conviene:
Antes de publicar, el verificador ya te lista lo que vamos a mandar distinto de como lo declaraste y lo que no vamos a mandar, con el motivo de cada cosa. Es gratis, y es el momento útil: corregís el objeto y verificás de nuevo sin gastar cupo.
Después de publicar, la respuesta trae lo que el portal aceptó y conserva esa misma lista. Si una unidad no viajó, ahí está dicho cuál y por qué.
Un total que no coincide con lo que mandaste no es, por sí solo, un error. Puede ser una unidad que decidimos no publicar —la sección que sigue— o el modo donde el portal procesa después y todavía no terminó. Leé el motivo antes de reintentar: reintentar cuesta cupo y casi nunca es la respuesta.
🔴 En Argenprop, un desarrollo grande se publica REPITIENDO
Adoptar las unidades de a una no siempre entra en una sola llamada —una llamada tiene un tiempo máximo—, así que el publish de un desarrollo grande es naturalmente iterativo:
publicás el desarrollo → adopta las que entran, te dice cuántas quedaron
repetís → retoma donde quedó
repetís → …
hasta que no queden
| Repetir es seguro | se adoptan sólo las que faltan. No se duplica nada y el desarrollo no se re-crea |
| No es un error | lo que no entró viene identificado como no intentado, distinto de falló |
| Cuánto cuesta | cada vuelta son unas pocas llamadas del cupo de tu cliente. No conviene repetir en loop sin mirar: andá leyendo cuántas quedan |
| Cuándo terminó | cuando ya no quedan unidades sin adoptar |
Cuántas vueltas: depende de cuán rápido esté contestando el portal ese día, y varía bastante. Un desarrollo de pocas unidades suele cerrar en una; uno de 50 puede necesitar del orden de 15 a 20.
Si estás cargando un desarrollo grande por primera vez, dejá el bucle corriendo con una pausa entre vueltas y mirá el número de unidades que quedan: es el único indicador que necesitás.
⚠️ Esto es sólo de la carga inicial. Después, cambiar el precio de una unidad o agregar una sola es una llamada: comparamos contra lo que el portal ya tiene y tocamos nada más que la diferencia.
Una unidad que se vendió: marcala, no la saques
El desarrollo es el inventario completo, no la oferta del momento. Si vendiste 3 de 100 unidades, las 100 siguen siendo parte del desarrollo: marcás esas 3 como vendidas y listo. No las retires del objeto.
Por qué importa: el tamaño del desarrollo es un dato del edificio, y los números que calculamos — cuántas quedan, cuánto se comercializó — sólo tienen sentido si están todas. Un desarrollo que pasó de 100 a 97 unidades perdió la información de que vendió 3.
Y después cada portal decide qué hace con ellas. No es lo mismo en todos: hay portales que no tienen forma de mostrar una unidad no disponible, así que la mostrarían como si estuviera en venta. En esos, no la mandamos — y te lo decimos en la respuesta, con cuál y por qué. El total del desarrollo sigue siendo el real.
Si la unidad ya estaba publicada, marcarla no la baja. Dejar de mandarla saca su aviso de las próximas actualizaciones, pero el aviso que ya está arriba sigue arriba: dale de baja su publicación como a cualquier aviso. Son dos cosas distintas y conviene hacer las dos.
5 · Estado, actualizar y baja
Igual que un aviso: volver a publicar actualiza, la baja es idempotente, y el estado se lee gratis del lado nuestro o pagando una llamada al portal.
Hay una ventana entre publicar y poder volver a publicar, y acá es la más larga del flujo. Con muchas unidades el portal no termina en el momento: acusa recibo y sigue trabajando. Mientras lo hace, no acepta una segunda escritura del mismo desarrollo — así que una actualización enviada enseguida se rechaza.
No es un fallo y no perdiste el desarrollo: el primero sigue su curso. Te lo contestamos como algo temporal, con cuántos segundos conviene esperar.
⚠️ La decisión de diseño que esto te pide: si tu flujo publica y corrige en la misma ráfaga, tenés dos caminos y los dos son válidos — esperar y reintentar, o preguntarle al portal si ya terminó antes de reescribir. Tratarlo como un error definitivo es el único que sale mal. El contrato de la respuesta del publish está en publicar; el de la consulta, en la consulta de estado.
Preguntar cuesta una llamada del cupo de tu cliente; esperar es gratis.
Con muchas unidades, preguntar no te sirve para esto.
Cuando el desarrollo es grande, el portal lo procesa en diferido y termina con el aviso principal mucho antes que con el lote. Así que si preguntás, te va a contestar que ese aviso ya está listo mientras las unidades siguen en cola — y la próxima escritura se sigue rechazando.
| Unidades | Cuánto tardó en aceptar la siguiente escritura |
|---|---|
| 4 | ~1 minuto |
| 20 | más de 8 minutos (y el aviso principal se declaró listo a los 3) |
| 29 | 8 a 10 minutos |
⇒ Con un desarrollo grande, esperá y reintentá. El número que te devolvemos en la respuesta ya tiene en cuenta el tamaño: para un lote te sugerimos diez minutos, y para un aviso suelto o un desarrollo chico, uno.
Sigue siendo una sugerencia nuestra, no un dato del portal: no existe un campo que te diga el momento exacto — el portal no lo manda. Si al vencerse te vuelve el mismo rechazo, no está roto: es que todavía está procesando, y reintentar es seguro.
La ventana también afecta la BAJA, y ahí sorprende más. Si das de baja mientras el portal procesa, la baja contesta bien y el desarrollo puede volver a aparecer online cuando el portal termina el trabajo que tenía pendiente. No es que la baja falló: es que el publish anterior todavía estaba en curso y se completó después. Lo mismo en dar de baja.
⚠️ El desarrollo y sus unidades tienen estados separados. Consultá el del desarrollo por el desarrollo: preguntar por una unidad como si fuera un aviso suelto no te va a decir lo que buscás.
Los tres errores de orden, y cómo se ven
| Si… | Te lo decimos así |
|---|---|
| mandás el desarrollo antes de las unidades | no encontramos esas unidades, con el código que no existe |
| referenciás una unidad que ya es de otro desarrollo | te nombramos el desarrollo que la tiene |
| le heredás a las unidades el tipo del desarrollo | el intento marca cada unidad con el tipo que el portal no acepta |
Los tres salen antes de llegar al portal si verificaste. Si no verificaste, salen después de gastar la llamada.
Qué portales lo soportan
Publicar desarrollos no está disponible en todos los portales, y en los que sí, tu cliente necesita tener contratado el producto correspondiente — que es distinto del de avisos sueltos. La tabla está en Publicación; si el portal no lo soporta, el intento te lo dice sin gastar cupo.
Relacionado
- Publicar un aviso — el caso base
- El objeto del desarrollo · Verificar · La respuesta
- Publicar un desarrollo — el endpoint y su contrato