Mapaprop

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}  ← UNA llamada: padre + unidades
5 · estado y baja                 igual que un aviso

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.

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.

3 · Verificar (gratis, y acá rinde más que nunca)

El verificador revisa el desarrollo y cada unidad. Como publicarlo es una sola llamada al portal, un problema en una sola unidad puede frenarlo todo — y verificar no cuesta nada.

El verificador trabaja sobre el objeto que le mandás, no sobre lo que ya guardamos. Para chequear un desarrollo que ya existe, mandalo con sus unidades actuales: como ya pertenecen a ese mismo desarrollo, te las va a marcar. Es un límite conocido y no es un error tuyo.

4 · Publicar: una llamada, el padre y las unidades

PUT …/publication/{portal} con el desarrollo. Las unidades viajan adentro: no las publicás una por una.

Eso tiene dos consecuencias que conviene tener claras:

El cupoes una llamada, no una por unidad. Un desarrollo de 40 unidades cuesta lo mismo que uno de 2
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.

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.

⚠️ 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