O objeto JSON do empreendimento

Um empreendimento imobiliário —um prédio na planta, um condomínio fechado, uma torre em construção— é enviado com o mesmo endpoint que um imóvel: POST /property-v1/properties. Não há um endpoint à parte nem um modelo novo para aprender.

O que o torna um empreendimento é um grupo development dentro do objeto:

{
  "code": "TORRE-NORTE",
  "type": 23,
  "operation": 1,
  "title": "Torre Norte — Empreendimento na planta",
  // … o resto dos campos de sempre …

  "development": {
    "totalBuildingArea": 7400,
    "totalFloors": 12,
    "apartmentsPerFloor": 4,
    "units": ["TORRE-NORTE-4B", "TORRE-NORTE-5A"]
  }
}

Duas regras que convém ter claras desde o começo:

1. Os campos do grupo development

Todos descrevem o projeto, não uma unidade.

Os total* são do conjunto; os min* são o "a partir de" que o anúncio mostra.

Se faltar um obrigatório, o erro o nomeia pelo seu caminho no seu JSON (development.minRooms): algo que você pode procurar literalmente no que enviou.

⚠️ totalHouses / totalLots e os campos de prédio não convivem. Um condomínio fechado é descrito com casas e lotes; um prédio com andares, apartamentos por andar e elevadores. Se você enviar dos dois lados devolvemos o conflito nomeando os campos de cada um, para que você deixe só os de um.

2. As unidades: units

As unidades são imóveis normais do seu mesmo cliente, que você já cadastrou. No empreendimento você apenas as referencia:

"units": ["TORRE-NORTE-4B", "TORRE-NORTE-5A", "01M43Y1T192XEXJCV6Y6C4QTNB"]

Você pode usar o code que você deu a elas ou o paId que devolvemos ao cadastrá-las. Os dois valem, e na resposta devolvemos os dois para que você possa cruzá-los com a sua base.

A ordem importa: primeiro as unidades, depois o empreendimento

Uma unidade precisa existir antes de você referenciá-la. O fluxo é:

1. POST /properties de cada unidade → guarde o paId
2. POST /properties do empreendimento, com os códigos delas em units

Um empreendimento pode nascer sem unidades

units é opcional. Você pode cadastrar o empreendimento vazio e carregar as unidades depois com PUT: é o fluxo normal quando o projeto é publicado antes de a tipologia estar fechada.

⚠️ O PUT substitui a lista completa, não acrescenta. Se o empreendimento tem 10 unidades e você envia um PUT com 3, ele fica com 3 — as outras 7 são liberadas. Envie sempre a lista inteira.

O limite: 100 unidades que MUDAM, não que ele tem

Uma única operação pode movimentar até 100 unidades. O que conta são as que entram e saem, não as que o empreendimento já tem: uma unidade que já era dele e continua sendo não custa nada.

Por isso "envie sempre a lista inteira" e o limite convivem. Com um empreendimento de 150:

O único caso que não passa é carregar mais de ~92 unidades novas de uma só vez. Resolve-se em duas etapas e depois não incomoda mais:

POST /properties   → o empreendimento com as primeiras 90
PUT  /properties/{paId} → a lista das 150

A partir daí você pode fazer PUT das 150 quantas vezes quiser: nenhuma se movimenta.

As sete regras de uma unidade

Uma unidade que não cumprir uma destas é reportada a você com o seu motivo, e o empreendimento é salvo mesmo assim: o que não dá é publicá-lo.

Uma unidade pertence a um único empreendimento. Se quiser movê-la, tire-a antes do anterior.

📌 Um empreendimento pode ser unidade de outro (um condomínio com torres dentro). Nesse caso conta como uma unidade: não descemos até as unidades dos seus filhos, porque somar o filho e as unidades dele contaria duas vezes a mesma coisa.

3. Amenidades próprias do empreendimento

Um empreendimento usa o mesmo attributes que qualquer imóvel e, além disso, tem 16 amenidades próprias: as do empreendimento, não as de uma unidade. Uma academia ou um campo de golfe são do complexo; o ar-condicionado é do apartamento.

Elas vêm no catálogo com group_subtype: "development":

São booleanos e são enviadas em attributes igual ao resto, sem nada de especial:

"attributes": [
  { "id": "gym",        "key_legacy": "gym",        "group_sub": "label", "group_subtype": "development", "selected": true },
  { "id": "clubhouse",  "key_legacy": "clubhouse",  "group_sub": "label", "group_subtype": "development", "selected": true }
]

Estão nos 15 países. Baixe-as do catálogo junto com o resto —não as escreva à mão— e filtre por group_subtype:

GET /property-attributes — o catálogo completo: tipos, operações, estados e amenidades

4. O objeto completo

Este é um empreendimento inteiro, com todos os seus campos. É o objeto que usamos para testar.

{
  "code": "DEV-TORRE-NORTE",
  "type": 23,
  "development": {
    "totalBuildingArea": 126,
    "totalLandArea": 189,
    "totalGarages": 2,
    "minAmbiences": 2,
    "minRooms": 3,
    "minBathrooms": 1,
    "units": [
      "TORRE-NORTE-4B",
      "TORRE-NORTE-5A",
      "TORRE-NORTE-PH-A"
    ],
    "totalFloors": 12,
    "apartmentsPerFloor": 4,
    "totalApartments": 96,
    "totalTowers": 3,
    "totalElevators": 4,
    "totalOffices": 2,
    "totalCommercialUnits": 3,
    "deliveryDate": "2027-06-30",
    "logoUrl": "https://cdn.inmobiliaria-modelo.com/torre-norte/logo.png",
    "commercialTagline": "Torre Norte — 96 unidades frente al parque, entrega 2027"
  },
  "operation": 1,
  "title": "Torre Norte — desarrollo de 48 unidades en Nordelta",
  "address": "Av. Santa Fe 4271",
  "mapLatitude": -34.5828,
  "mapLongitude": -58.4206,
  "zone0": 1,
  "zone1": 2,
  "zone2": 189,
  "description": "Desarrollo de 48 unidades distribuidas en 12 pisos, con amenities completos. Unidades de 1, 2 y 3 ambientes.",
  "descriptionFormatted": "<p>Desarrollo de 48 unidades distribuidas en 12 pisos, con amenities completos.</p>",
  "zipcode": "1684",
  "betweenStreets": "Entre Av. Pueyrredón y Av. Coronel Díaz",
  "urlWebExternal": "https://ejemplo-inmobiliaria.com/propiedad-dev",
  "conditions": "Contado",
  "yearsOld": 16,
  "floors": 2,
  "dependencies": 1,
  "toilettes": 2,
  "currency": "USD",
  "price": 120000,
  "zone3": 973,
  "rented": false,
  "sold": false,
  "reserved": false,
  "suspended": false,
  "occupancy": null,
  "images": [
    {
      "url": "https://images.mapaprop.app/photos/1/33616/213831.jpg",
      "description": "Imagen principal",
      "main": true
    },
    {
      "url": "https://images.mapaprop.app/photos/1/33616/1950514.jpg",
      "description": "Imagen 2",
      "main": false
    },
    {
      "url": "https://images.mapaprop.app/photos/1/33616/1950515.jpg",
      "description": "Imagen 3",
      "main": false
    }
  ],
  "blueprint": {
    "url": "https://images.mapaprop.app/photos/1/33616/1950516.jpg"
  },
  "videos": [
    {
      "source": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "description": "Recorrido"
    }
  ],
  "prices": {
    "expensesCurrency": "ARS",
    "expensesPrice": 500,
    "taxCurrency": "ARS",
    "taxPrice": 200,
    "paymentPeriod": 1
  },
  "altPrices": [
    {
      "description": "Alquiler por semana",
      "currency": "ARS",
      "price": 100000
    }
  ],
  "publication": {
    "api": {
      "argenprop": {
        "advertiserId": 99999,
        "visible": true,
        "token": "<tu-token-de-argenprop>"
      },
      "zonaprop": {
        "plan": {
          "plan": "DESARROLLOS_DESTACADO"
        },
        "developmentCategory": "vertical",
        "token": "<tu-token-de-zonaprop>"
      },
      "cabaprop": {
        "branchOfficeId": 42,
        "token": "<tu-token-de-cabaprop>"
      },
      "mercadolibre": {
        "listingTypeId": "gold_special",
        "condition": "used",
        "token": "<tu-token-de-mercadolibre>"
      }
    }
  },
  "attributes": [
    {
      "locale": "es_AR",
      "country": "ar",
      "id": "accessible",
      "label": "Accesible",
      "group": "propertyAttribute",
      "group_sub": "label",
      "group_subtype": "ammenities",
      "type": "bool",
      "key_legacy": "accessible",
      "selected": true,
      "status": true
    },
    {
      "locale": "es_AR",
      "country": "ar",
      "id": "statusUnderConstruction",
      "label": "En Construcción",
      "group": "propertyStatus",
      "group_sub": "status",
      "type": "list",
      "key_legacy": "6",
      "value": 6
    },
    // … e mais 54 entradas, uma por atributo do empreendimento
  ]
}

5. E depois

POST /properties/verify para um empreendimento — teste o objeto antes de cadastrar qualquer coisa

developmentStats — os números calculados das suas unidades

O objeto JSON do imóvel — os campos de sempre, que um empreendimento também leva