BETA

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.

ZonapropArgenprop
Las unidadesviajan dentro de la publicación del desarrolloya tienen que estar publicadas: el desarrollo las toma
Cuántas llamadas hacésunauna 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 cupoes 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 cupouna llamada por unidad, más la del desarrollo. Un desarrollo de 40 unidades cuesta 41
El ordensi 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 segurotomar 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 planlos 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 segurose adoptan sólo las que faltan. No se duplica nada y el desarrollo no se re-crea
No es un errorlo que no entró viene identificado como no intentado, distinto de falló
Cuánto cuestacada 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.

UnidadesCuánto tardó en aceptar la siguiente escritura
4~1 minuto
20más de 8 minutos (y el aviso principal se declaró listo a los 3)
298 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 unidadesno encontramos esas unidades, con el código que no existe
referenciás una unidad que ya es de otro desarrollote nombramos el desarrollo que la tiene
le heredás a las unidades el tipo del desarrolloel 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