Real Estate Developments

A real estate development (or a real estate undertaking) is a type of real estate publication within Mercado Livre that allows seller to disclose and sell units of a new development, which can be in plans, under construction or built. The unit can have many features, known as variations. Each variation details a possible unit to be sold, with its attributes, plans, etc.

Packages

Seller needs to have a package of the “real estate development” type.
NOTE: To perform tests, you shall send your test user to the support channel in order to be activated as real estate, and also for them to associate such user to a real estate development package.

Each development is associated to a package (1-1 relation) and there cannot be two packages without associated items. There can only be one package with no item per user.

Categories

The integrator must search the right category under the category tree:

https://api.mercadolibre.com/sites/Site_id/categories

The category to be sent must always be a daughter. In the example below, the daughter category is MLA401805, which is the category associated to real estate developments.

Exemplo:
https://api.mercadolibre.com/sites/MLA/categories
https://api.mercadolibre.com/categories/MLA1459 – Inmuebles
https://api.mercadolibre.com/categories/MLA1472 – Departamentos
https://api.mercadolibre.com/categories/MLA1474 – Venta
https://api.mercadolibre.com/categories/MLA401805 – Emprendimientos Inmobiliarios

NOTE: Remember that for Brazil, you must use the MLB site, and not MLA.

Pictures

Pictures of variations (units) must be sent at the pictures API, as shown in the example below (in the one known as POST, but in a separate array).

Note that pictures whose IDs are listed in variations are not shown in the home page of the ad. Since they are pictures of variations, they are shown in the ad description and in the quotation page.

Pictures that are not listed in variations are shown in the in the upper part of the ad home page.

Publish a real estate development

A development must have at least one variation (unit) and all attributes and combinations of variations can be obtained through the category features/attributes, as shown in the example below:

https://api.mercadolibre.com/categories/{category_id}/attributes

A publication contains attributes at the item level, which are features of the development itself, and that are represented under the attributes tag. The title of the development, for example, is represented by the DEVELOPMENT_NAME attribute.

Each variation under the variations array represents a unit in itself. Then, a variation contains attribute_combinations, which would be a unit PK. There cannot be two variations with the same combination of values in the attributes used in attribute_combinations. For example, the UNIT_NAME value can be the differential.

Each variation has the attributes of the unit itself, which are added to the features of the general development.

Example

curl -X POST -H "Content-Type: application/json" -d {

  "title": "Item de prueba - no ofertar - test - Domus 2222",
  "category_id": "MLA401806",
  "price": 157000,
  "currency_id": "USD",
  "available_quantity": 2,
  "buying_mode": "classified",
  "listing_type_id": "gold_premium",
  "condition": "new",
"location": {
    "address_line": "Solís 2222",
    "zip_code": "",
    "neighborhood": {
      "id": "TUxBQk9MSTgzODNa",
      "name": "Olivos"
    },
    "city": {
      "id": "TUxBQ1ZJQ2E3MTQz",
      "name": "Vicente López"
    },
    "state": {
      "id": "TUxBUEdSQWU4ZDkz",
      "name": "Bs.as. G.b.a. Norte"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "open_hours": "",
    "latitude": -34.5101161,
    "longitude": -58.4765109
  },

"description": {"plain_text": "Una descripción de prueba  \n"},
  "pictures": [
    {
      "id": "872895-MLA26491094940_122017",
      "url": "http://mla-s2-p.mlstatic.com/872895-MLA26491094940_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/872895-MLA26491094940_122017-O.jpg",
      "size": "500x312",
      "max_size": "1200x750",
      "quality": ""
    },
    {
      "id": "681776-MLA26491106096_122017",
      "url": "http://mla-s2-p.mlstatic.com/681776-MLA26491106096_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/681776-MLA26491106096_122017-O.jpg",
      "size": "500x236",
      "max_size": "1200x567",
      "quality": ""
    },
    {
      "id": "925912-MLA26491099329_122017",
      "url": "http://mla-s2-p.mlstatic.com/925912-MLA26491099329_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/925912-MLA26491099329_122017-O.jpg",
      "size": "500x236",
      "max_size": "1200x567",
      "quality": ""
    },
    {
      "id": "614472-MLA26491102287_122017",
      "url": "http://mla-s2-p.mlstatic.com/614472-MLA26491102287_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/614472-MLA26491102287_122017-O.jpg",
      "size": "500x312",
      "max_size": "1200x750",
      "quality": ""
    },
    {
      "id": "657426-MLA26491106124_122017",
      "url": "http://mla-s2-p.mlstatic.com/657426-MLA26491106124_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/657426-MLA26491106124_122017-O.jpg",
      "size": "500x312",
      "max_size": "1200x750",
      "quality": ""
    },
    {
      "id": "600555-MLA26491106130_122017",
      "url": "http://mla-s2-p.mlstatic.com/600555-MLA26491106130_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/600555-MLA26491106130_122017-O.jpg",
      "size": "500x312",
      "max_size": "1200x750",
      "quality": ""
    },
    {
      "id": "919897-MLA26491061564_122017",
      "url": "http://mla-s2-p.mlstatic.com/919897-MLA26491061564_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/919897-MLA26491061564_122017-O.jpg",
      "size": "500x353",
      "max_size": "1200x848",
      "quality": ""
    },
    {
      "id": "674837-MLA26491070000_122017",
      "url": "http://mla-s2-p.mlstatic.com/674837-MLA26491070000_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/674837-MLA26491070000_122017-O.jpg",
      "size": "500x353",
      "max_size": "1200x848",
      "quality": ""
    },
    {
      "id": "913036-MLA26491092856_122017",
      "url": "http://mla-s2-p.mlstatic.com/913036-MLA26491092856_122017-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/913036-MLA26491092856_122017-O.jpg",
      "size": "500x353",
      "max_size": "1200x848",
      "quality": ""
    }
  ],
  "shipping": {
    "mode": "not_specified",
    "methods": [],
    "tags": [],
    "dimensions": null,
    "local_pick_up": false,
    "free_shipping": false,
    "logistic_type": "not_specified",
    "store_pick_up": false
  },

  "seller_address": {
    "comment": "",
    "address_line": "Av. Libertador 4189",
    "zip_code": "1636",
    "city": {
      "id": "TUxBQ1ZJQ2E3MTQz",
      "name": "Vicente López"
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    }
    
  },

  "attributes": [
    {
      "id": "AVAILABLE_PARKING_SLOTS",
      "name": "Cocheras disponibles",
      "value_id": null,
      "value_name": "82",
      "value_struct": null,
      "attribute_group_id": "ADDITIONAL_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características adicionales del desarrollo"
    },
    {
      "id": "HAS_LIFT",
      "name": "Ascensor",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "ADDITIONAL_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características adicionales del desarrollo"
    },
    {
      "id": "PARKING_PRICE_FROM",
      "name": "Precio cochera (Desde)",
      "value_id": null,
      "value_name": "30000",
      "value_struct": null,
      "attribute_group_id": "ADDITIONAL_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características adicionales del desarrollo"
    },
    {
      "id": "HAS_BARBECUE_AREA",
      "name": "Área de parrillas",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_BUSINESS_CENTER",
      "name": "Business center",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_CINEMA_HALL",
      "name": "Área de cine",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_CISTERN",
      "name": "Cisterna",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_COMMON_LAUNDRY",
      "name": "Laundry",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_FIRE_SYSTEM",
      "name": "Sistema contra incendio",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_GUEST_PARKING",
      "name": "Estacionamiento para visitantes",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_GYM",
      "name": "Gimnasio",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_JACUZZI",
      "name": "Jacuzzi",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_JOGGING_TRACK",
      "name": "Pista de jogging",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_LOBBY",
      "name": "Lobby",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_MULTIPURPOSE_ROOM",
      "name": "Salón de usos múltiples",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_PLAYGROUND",
      "name": "Área de juegos infantiles",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_SECURITY",
      "name": "Seguridad",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_STRIP_MALL",
      "name": "Locales comerciales",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_SWIMMING_POOL",
      "name": "Pileta",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "HAS_TENNIS_COURT",
      "name": "Cancha de tenis",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "COMOYAMEN",
      "attribute_group_name": "Comodidades y amenities"
    },
    {
      "id": "MAX_BATHROOMS",
      "name": "Cantidad máxima de baños",
      "value_id": null,
      "value_name": "2",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MAX_BEDROOMS",
      "name": "Cantidad máxima de dormitorios",
      "value_id": null,
      "value_name": "3",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MAX_COVERED_AREA",
      "name": "Cantidad máxima de metros cubiertos",
      "value_id": null,
      "value_name": "176 m²",
      "value_struct": {
        "number": 176,
        "unit": "m²"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MAX_ROOMS",
      "name": "Cantidad máxima de ambientes",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MAX_TOTAL_AREA",
      "name": "Cantidad máxima de metros totales",
      "value_id": null,
      "value_name": "194 m²",
      "value_struct": {
        "number": 194,
        "unit": "m²"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MIN_BATHROOMS",
      "name": "Cantidad mínima de baños",
      "value_id": null,
      "value_name": "1",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MIN_BEDROOMS",
      "name": "Cantidad mínima de dormitorios",
      "value_id": null,
      "value_name": "1",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MIN_COVERED_AREA",
      "name": "Cantidad mínima de metros cubiertos",
      "value_id": null,
      "value_name": "40.79 m²",
      "value_struct": {
        "number": 40.79,
        "unit": "m²"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MIN_ROOMS",
      "name": "Cantidad mínima de ambientes",
      "value_id": null,
      "value_name": "1",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MIN_TOTAL_AREA",
      "name": "Cantidad mínima de metros totales",
      "value_id": null,
      "value_name": "55.15 m²",
      "value_struct": {
        "number": 55.15,
        "unit": "m²"
      },
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "SELECTED_PACKAGE",
      "name": "Paquete seleccionado",
      "value_id": null,
      "value_name": "1673515",
      "value_struct": null,
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "OPERATION",
      "name": "Operación",
      "value_id": "242075",
      "value_name": "Venta",
      "value_struct": null,
      "attribute_group_id": "MAIN",
      "attribute_group_name": "Principales"
    },
    {
      "id": "OPERATION_SUBTYPE",
      "name": "Subtipo de operación",
      "value_id": "245034",
      "value_name": "Emprendimiento inmobiliario",
      "value_struct": null,
      "attribute_group_id": "MAIN",
      "attribute_group_name": "Principales"
    },
    {
      "id": "PROPERTY_TYPE",
      "name": "Inmueble",
      "value_id": "242062",
      "value_name": "Departamento",
      "value_struct": null,
      "attribute_group_id": "MAIN",
      "attribute_group_name": "Principales"
    },
    {
      "id": "DEVELOPMENT_NAME",
      "name": "Nombre del emprendimiento",
      "value_id": null,
      "value_name": "item de test - no ofertar - DOMUS 2222",
      "value_struct": null,
      "attribute_group_id": "MAIN_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características principales del desarrollo"
    },
    {
      "id": "POSSESSION_DATE",
      "name": "Fecha de entrega",
      "value_id": null,
      "value_name": "Enero 2019",
      "value_struct": null,
      "attribute_group_id": "MAIN_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características principales del desarrollo"
    },
    {
      "id": "POSSESSION_STATUS",
      "name": "Entrega",
      "value_id": "242414",
      "value_name": "Preventa",
      "value_struct": null,
      "attribute_group_id": "MAIN_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características principales del desarrollo"
    },
    {
      "id": "SUITABLE_FOR_MORTGAGE_LOAN",
      "name": "Apto crédito",
      "value_id": "242084",
      "value_name": "No",
      "value_struct": null,
      "attribute_group_id": "MAIN_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características principales del desarrollo"
    },
    {
      "id": "UNITS",
      "name": "Unidades totales",
      "value_id": null,
      "value_name": "66",
      "value_struct": null,
      "attribute_group_id": "MAIN_CHARACTERISTICS_OF_DEVELOPMENT",
      "attribute_group_name": "Características principales del desarrollo"
    }
  ],
  "variations": [
    {
      "price": 158000,
      "attribute_combinations": [
        {
          "id": "ROOMS",
          "name": "Ambientes",
          "value_id": null,
          "value_name": "2",
          "value_struct": null
        },
        {
          "id": "FULL_BATHROOMS",
          "name": "Baños",
          "value_id": null,
          "value_name": "1",
          "value_struct": null
        },
        {
          "id": "PARKING_LOTS",
          "name": "Cocheras",
          "value_id": null,
          "value_name": "0",
          "value_struct": null
        },
        {
          "id": "BEDROOMS",
          "name": "Dormitorios",
          "value_id": null,
          "value_name": "1",
          "value_struct": null
        },
        {
          "id": "UNIT_NAME",
          "name": "Nombre de la unidad",
          "value_id": null,
          "value_name": "110",
          "value_struct": null
        },
        {
          "id": "MODEL_NAME",
          "name": "Nombre del modelo",
          "value_id": null,
          "value_name": "2 AMBIENTES",
          "value_struct": null
        },
        {
          "id": "COVERED_AREA",
          "name": "Superficie cubierta",
          "value_id": null,
          "value_name": "51 m²",
          "value_struct": {
            "number": 51,
            "unit": "m²"
          }
        },
        {
          "id": "TOTAL_AREA",
          "name": "Superficie total",
          "value_id": null,
          "value_name": "57 m²",
          "value_struct": {
            "number": 57,
            "unit": "m²"
          }
        }
      ],
      "available_quantity": 1,
      "sold_quantity": 0,
      "sale_terms": [],
      "picture_ids": [
        "674837-MLA26491070000_122017"
      ]
      
    },
    {
      "price": 161000,
      "attribute_combinations": [
        {
          "id": "ROOMS",
          "name": "Ambientes",
          "value_id": null,
          "value_name": "1",
          "value_struct": null
        },
        {
          "id": "FULL_BATHROOMS",
          "name": "Baños",
          "value_id": null,
          "value_name": "1",
          "value_struct": null
        },
        {
          "id": "PARKING_LOTS",
          "name": "Cocheras",
          "value_id": null,
          "value_name": "0",
          "value_struct": null
        },
        {
          "id": "BEDROOMS",
          "name": "Dormitorios",
          "value_id": null,
          "value_name": "1",
          "value_struct": null
        },
        {
          "id": "UNIT_NAME",
          "name": "Nombre de la unidad",
          "value_id": null,
          "value_name": "3 OESTE",
          "value_struct": null
        },
        {
          "id": "MODEL_NAME",
          "name": "Nombre del modelo",
          "value_id": null,
          "value_name": "1 AMBIENTE",
          "value_struct": null
        },
        {
          "id": "COVERED_AREA",
          "name": "Superficie cubierta",
          "value_id": null,
          "value_name": "40.79 m²",
          "value_struct": {
            "number": 40.79,
            "unit": "m²"
          }
        },
        {
          "id": "TOTAL_AREA",
          "name": "Superficie total",
          "value_id": null,
          "value_name": "55.15 m²",
          "value_struct": {
            "number": 55.15,
            "unit": "m²"
          }
        }
      ],
      "available_quantity": 1,
      
      
      "picture_ids": [
        "913036-MLA26491092856_122017"
      ]
      
      
    }
  ]
  }

https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Quotations

A quotation occurs when a potential buyer makes a quotation in an ad of the “real estate development” type.

He chooses the plan and the unit, and, therefrom, he can know the price. Then, Mercado Livre can generate an event that can be sent to the integrator, through a notice. For further information on notices of Mercado Livre, click here.

A quotation is a document containing seller, item and buyer information, at the time the quotation is created. When a user requests a quotation, the item information is “frozen” and kept like this to secure the price of the time in which the quotation was made, if there are any later changes.

For some methods below, the integrator must send a caller.type variable to identify who is calling the action. It may be seller or user. In general, for development applications, such person will be seller.

Create a quotation

A HTTP POST must be used in the following format:

curl -X POST -d ‘{
“user_id”: $buyerId
“item_id”: $itemId
“variation_id”:$realStateDevelopmentVariationId
}’ ‘htts://api.mercadolibre.com/quotations?access_token=$access_token’

Delete a quotation

A HTTP PUT must be used in the following format:

curl -X PUT -d ‘{
“delete” : true
}’ ‘htts://api.mercadolibre.com/quotations/$quotationId?access_token=$access_token&caller.type=$caller.type’

Search a quotation

To search this number, use a HTTP GET in the following format:

curl https://api.mercadolibre.com/quotations/$quotationId?caller.type=$caller.type&access_token=$access_token’

Search quotations per item id

To search this number, use a HTTP GET in the following format:

https://api.mercadolibre.com/quotations/items_ids?access_token=$access_token&query=$query’’

This variable supports multiple ids. Example:

https://api.mercadolibre.com/quotations/items_ids?access_token=myAccessToken&query=itemId1,Itemid2,Itemid3’

Search report of quotations per seller

To search this number, use a HTTP GET in the following format:

https://api.mercadolibre.com/quotations/report?access_token=$access_token&seller.id=$seller.id

Search number of quotations per seller

To search this number, use a HTTP GET in the following format:

https://api.mercadolibre.com/quotations/report?access_token=$access_token&seller.id=$seller.id

Please rate this