Desarrollos inmobiliarios

Un desarrollo (o emprendimiento) inmobiliario es un tipo de publicación de inmueble dentro de Mercado Libre que permite al vendedor mostrar una unidad a desarrollar. La unidad puede tener una o varias opciones, conocidas como variaciones. Cada variación detalla una posible unidad a ser construida, con sus atributos, planos, etc.

Paquetes

Para el vendedor, es necesario tener un paquete del tipo desarrollo.
NOTA: Para realizar pruebas, deberás enviar el usuario de test al canal de soporte para que sea activado como real state y asignar un paquete de desarrollos.

Cada desarrollo está a asociado a un paquete (relación 1 a 1) y no pueden coexistir dos paquetes sin items asignados.

Categorías

El integrador debe buscar la categoría correcta dentro del árbol de categorías:

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

Una categoría hija debe ser enviada. En el ejemplo siguiente, la categoría hija es MLA401805.

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

Fotos

Las fotos de las variaciones tienen que ser generadas mediante la API de pictures, como figura en el ejemplo de abajo (son enviados en el mismo POST, en el array de pictures).

Las fotos donde el ID no está en las variaciones, no se muestra en la “home” del desarrollo. Pero las que tienen el ID en las variaciones, se ven en la descripción y cotización.

Pública un desarrollo inmobiliario

Un emprendimiento tiene que tener como mínimo una variación y todos los atributos y combinaciones de variaciones, se pueden obtener desde el recurso /attributes de la categoría:

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

Una publicación contiene atributos a nivel ítem, que son las características propias del emprendimiento, representadas dentro de “attributes”. El título del desarrollo será un atributo: DEVELOPMENT_NAME.

Cada variación dentro de “variations” representa a la unidad en sí. Entonces, una variación contiene “attribute_combinations” que sería la PK de la unidad. No pueden existir dos variaciones con la misma combinación de valores en los atributos utilizados en attribute_combinations. Por ejemplo, el valor “UNIT_NAME” suele ser el diferencial.

A su vez, cada variación tiene sus propios atributos que dependen del emprendimiento en general.

Ejemplo

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

Cotizaciones

Una cotización ocurre cuando un posible comprador realiza una consulta en un anuncio del tipo “desarollo inmobiliario”.

Él elige la planta y la unidad, y partir de ahí, puede saber el precio. En este momento, Mercado Libre puede generar un evento que será enviado al integrador a través de una notificación. Para saber más detalles de las notificaciones de Mercado Libre, clic aquí.

Una cotización es un documento que contiene información del vendedor, del ítem y del comprador en el momento que es creada. Cuando el usuario solicita una cotización, la información del ítem es congelada y se mantiene para garantizar el precio del momento en que la cotización fue realizada.
Para algunos métodos el integrador debe enviar la variable “caller.type” para identificar quién es el generador de la acción. Puede ser un vendedor o un usuario. Generalmente. para las aplicaciones de lanzamientos será el el vendedor.

Crear una cotización

Se debe utilizar un HTTP POST en el siguiente formato:

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

Eliminar una cotización

Para eliminar una cotización utilizando la API de Mercado Libre se debe enviar un HTTP PUT con el siguiente formato:

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

Buscar una cotización

Para buscar una cotización utilizando la API de Mercado Libre deberás hacer un HTTP GET utilizando el siguiente formato:

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

Buscar una cotización por item ID

Para obtener todas las cotizaciones existentes por item ID, se deberá enviar un HTTP GET usando el siguiente formato:

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

La consulta acepta varios items IDs. Por ejemplo:

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

Consultar un reporte de cotización por vendedor

Para consultar este número deberás realizar un GET con el siguiente formato:

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

Consultar el número de cotizaciones por vendedor

Para consultar el número de cotizaciones por vendedor deberás realizar el siguiente GET:

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

Por favor califica del 1 al 5