Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 28/08/2024

Publica inmuebles

Importante:
A partir de julio/2024, los anuncios deben cumplir con la regla de formato correcto en el campo "address_line", que consiste en calle + número según lo detalla nuestra documentación. Los anuncios que no cumplan con esta normativa serán moderados y sus ítems correspondientes se pausarán. Por favor, ajuste sus anuncios según sea necesario para evitar interrupciones en el servicio.

En general, los inmuebles y vehículos son el único tipo de publicación que permite a los usuarios mostrar su información de contacto al público. Por eso, cuando los usuarios buscan propiedades para alquilar o comprar y les interesa una publicación, pueden ponerse en contacto contigo de inmediato.

Notas:
- Agregamos un nuevo substatus para las publicaciones que superen el cupo del paquete asignado al cliente y puede suceder en el proceso masivo de publicación. Los articulos pasarán de "not_yet_active" a “closed” con substatus "pack_quota_exceeded” el mismo día de la creación.


Consultar inmuebles

Solo debes conocer el item_id asociado a la publicación y, como es público, puedes obtenerlo desde la página de la publicación. El item_id, lo encontrarás en la parte superior de la página. Debes agregar el site_id antes del número que ves y listo. Ahora puedes llamar al recurso Artículos para obtener toda la información que necesites:

Llamada:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Ejemplo:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA839018613

Respuesta:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.000Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "condition": "not_specified",
    "permalink": "https://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "secure_thumbnail": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "size": "500x438",
            "max_size": "548x481",
            "quality": ""
        }
    ],
    "video_id": "gqkEN9poKM;matterport",
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        },
        "latitude": -34.556595,
        "longitude": -58.48787,
        "id": 1087750186
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "country_code": "",
        "area_code": "",
        "phone": "",
        "country_code2": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "My property address NEW 111",
        "zip_code": "5000",
        "neighborhood": {
            "id": "TUxBQlBBTDI1MTVa",
            "name": "Palermo"
        },
        "city": {
            "id": "TUxBQ0NBUGZlZG1sYQ",
            "name": "Capital Federal"
        },
        "state": {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5780655,
        "longitude": -58.4265317
    },
    "geolocation": {
        "latitude": -34.5780655,
        "longitude": -58.4265317
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.000Z",
    "last_updated": "2020-02-13T19:49:09.226Z",
    "health": null,
    "catalog_listing": false
}


Atributos

A continuación mencionamos los campos más importantes que deben enviarse. Recuerde que, además de ellos, también deben enviarse los campos complementarios (atributos) en el array de atributos. Para obtener más información, puedes leer la guía de categorías y atributos.

Nota:
- Al realizar el POST debes especificar el channel al cual estás publicando, asegurate de enviar marketplace para no obtener error al publicar un item clasificado. Ademas puedes ver el campo en el ejemplo del POST.

- Agregamos un nuevo atributo inscription_number, debes indicarlo solo si el alquiler temporario está en la Ciudad Autónoma de Buenos Aires.

-A partir del 17 de julio los campos Gastos común, Mascotas, Estacionamiento, Bodega, Baños y Amoblado serán obligatorios y deberán ser enviados al crear la publicación.


Título

Evitar adjetivos y abreviaciones. El título correcto debe tener tipo de operación ( alquiler/venta/alquiler temporario ) + tipo de propiedad + ambientes + barrio. Las palabras del titulo son muy importantes ya que son las que coinciden con la palabra de búsqueda del usuario entonces cuanto mayor esta coincidencia más arriba aparece la publicación.
Ejemplo: Venta Departamento 4 ambientes Recoleta


Descripción

Nota:
Para crear la descripción, antes debes crear la publicación sin descripción y luego, enviar la descripción mediante un POST al recurso /items/$ITEM_ID/description.

Conoce cómo agregar la descripción al ítem publicado.


Nota:
La descripción del producto deberá ser en texto sin formato. Tampoco enviar información de contacto, como teléfono, dirección y sitio en este campo. En caso de que se envíe, aceptaremos la publicación, pero será penalizada o moderada y tendrá un mal clasificado en las búsquedas. Para consultar las publicaciones moderadas consulta Gestiona moderaciones.

Conoce cómo consultar una descripción mediante un GET al recurso /items/$ITEM_ID/description.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/description

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLC614111912/description

Respuesta:

{
	"text": "",
	"plain_text": "Excelente casa, con ubicación nororiente. Texto TEST.
	"date_created": "2021-05-19T19:56:12.000Z",
	"snapshot": {}
}


Ubicación

Al publicar un anuncio clasificado, es obligatorio que envíes tu ubicación. La ubicación de Mercado Libre posee 4 niveles: country, state, city y neighborhood. Debes enviar, como mínimo, city o neighborhood. Ejemplo:

location: {
    address_line: "Avenida Jurucê, 436",
    zip_code: "04080011",
    neighborhood: {
      id: "TUxCQklORHduMDB0"
    },
    "city": {
      "id": "TUxCQ1NQLTkxMjE",
    },
    "state": {
    "id": "TUxCUFNBT085N2E4",
    },
    "country": {
    "id": "BR",
    },
  },

Siempre recuerda enviar la id de cada ubicación enviada, según el ejemplo precedente. Para el campo “address_line”, siempre envía la calle seguida del número (el número de la calle siempre debe ser la última información enviada en este campo).

Ejemplo correcto: Avenida Jurucê, 436

Ejemplo incorrecto: Avenida Jurucê, 436 Moema.


Importante:
Por favor, observen que, si no respetan esta regla, todos sus artículos que violen las directrices serán moderados y pausados.

Para saber cómo consultar los códigos de ubicaciones de Mercado Libre, visita Localiza inmuebles.


Contactos del vendedor

Son los datos de contacto del vendedor propietario del anuncio. Estos valores son opcionales y, si no se los informa, Mercado Libre utilizará los datos de la cuenta del vendedor. Ejemplo:

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Nota:
Cuando hay preguntas de compradores en los anuncios, Mercado Libre las envía al correo electrónico del vendedor (consignado en el campo seller_contact.email). En caso de que no se lo informe, Mercado Libre utilizará el correo electrónico de la cuenta del vendedor en el sitio. Para gestionar preguntas por API utilice nuestra guía Gestiona preguntas y respuestas.
En caso de que el campo este como "seller_contact": "not_allowed" la categoría no permitirá cargar información al respecto.
Los campos country_code2, area_code2, phone2 pueden ser usados para que el vendedor reciba contactos por WhatsApp.


Imágenes

Las buenas imágenes pueden hacer que tu propiedad sea más atractiva y ofrecer a los usuarios una idea más certera de cómo es. Es necesario consultar por la categoría la cantidad de imágenes que si puede publicar, por los campos max_pictures_per_item y max_pictures_per_item_var. Este es un atributo obligatorio de acuerdo al grupo por tipo de propiedad.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

Te recomendamos no utilizar servidores lentos para alojar tus imágenes porque pueden generar desventajas al momento de publicar. También puedes agregar o cambiar las imágenes de tu artículo más tarde. Por favor, lee más sobre este tema en nuestra guía Trabajar con imágenes para conocer qué tipo de imágenes se permiten y cómo trabajar con ellas.


La cantidad de imágenes mínima tiene impacto sobre la calidad de una publicación y estas cantidades son distintas entre los 3 grupos de tipos de propiedad:

  • Grupo 1: Casas/ Departamentos/ Oficinas/ Parcelas (12 fotos).
  • Grupo 2: Locales/ Agrícolas/ sitios/Terrenos/ Bodegas/ Loteos (6 fotos).
  • Grupo 3: Estacionamientos (4 fotos).

Categoría y atributos

Los vendedores deben definir una categoría ( ej: “Venta” y “Alquiler”) en el site de Mercado Libre. Este atributo es obligatorio y solo acepta ID preestablecidos. Cada categoría tiene sus propios atributos para trabajar. Para conocer los detalles, consulta nuestra guía Categorías y Atributos.

{
 ....
  "category_id":"MLA12683",
 ...
}

Precio

El precio es obligatorio y deberá estar en la publicación.


Moneda

Este atributo es obligatorio. Debes definirlo utilizando un ID preestablecido. Encontrarás ID de monedas disponibles llamando a la categoría donde deseas publicar tu artículo. Conoce cómo hacerlo con nuestra guía nuestra guía Categorías.


Gasto Común

El atributo MAINTENANCE_FEE es obligatorio. Debes incluir el valor monetario del gasto común mensual en la moneda correspondiente del país (cada moneda tiene un ID preestablecido).


Mascotas

El atributo IS_SUITABLE_FOR_PETS es obligatorio y deberá ser enviado. Los valores definidos para este atributo donde se debe definir si se aceptan mascotas son y No junto con el ID preestablecido.


Estacionamiento

El atributo PARKING_LOTS es un valor numérico obligatorio. En este atributo se deben definir el número de espacios de estacionamiento con los que se cuenta.


Bodega

El atributo WAREHOUSES es un valor numérico obligatorio. Este atributo se refiere al número de espacios con los que se cuentan como bodega.


Baños

El atributo FULL_BATHROOMS es un valor numérico obligatorio. Este atributo hace referencia a la cantidad de baños completos con los que se cuenta en la propiedad.


Amoblado

El atributo FURNISHED es obligatorio. Hace referencia si la propiedad se encuentra amueblada, y los valores definidos para este atributo son y No según corresponda junto con el ID correspondiente.


Listing Type

Básicamente, se trata del plan contratado. Es otro caso de un atributo obligatorio que solo acepta valores predefinidos y es muy importante que lo entiendas. Existen diferentes "Listing Type" disponibles para cada site. Debes realizar una llamada mixta a través de los sites y recursos listing_types para conocer los listing_types soportados. Sigue nuestra guía para saber que tipo de publicación te convendrá más para tu propiedad.


Available_quantity

Se debe enviar siempre "1". Representa la cantidad de items de la publicación. En Mercado Libre, las publicaciones de clasificados no trabajan con stock, cada una representa un registro de inmueble, vehículo o servicio único.


Condition

Puede ser “new”, “used” o "not_specified", dependiendo de la condición de la publicación.



Publica un inmueble

Estás listo para publicar tu primer artículo inmueble. Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor regresa al tutorial Autenticación y Autorización. Además, te recomendamos validar el JSON que envías antes de realizar la solicitud POST; por eso, será mejor que consultes este tutorial de validación de artículos. Puedes crear un JSON para tu inmueble en base al ejemplo a continuación o simplemente envíalo y estarás publicando un producto de muestra en el site.

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "Content-Type: application/json" -d {
"title": "Property title",
"category_id": "MLA401686",
"price": 100000,
"currency_id": "ARS",
"available_quantity": 1,
"buying_mode": "classified",
"listing_type_id": "silver",
"condition": "not_specified",
"channels": 
[
"marketplace" 
], 
"pictures": [
{
"source":"http://mla-d2-p.mlstatic.com/item-de-test-no-ofertar-543605-MLA25041518406_092016-O.jpg?square=false"
}
],
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webmail": ""
},
"location": {
"address_line": "My property address 1234",
"zip_code": "01234567",
"neighborhood": {
"id": "TUxBQlBBUzgyNjBa"
},
"latitude": -34.48755,
"longitude": -58.56987
},
"attributes": [
{
"id": "ROOMS",
"value_name": "2"
},
{
"id": "FULL_BATHROOMS",
"value_name": "1"
},
{
"id": "PARKING_LOTS",
"value_name": "1"
},
{
"id": "BEDROOMS",
"value_name": "4"
},
{
"id": "COVERED_AREA",
"value_name": "30 m²"
},
{
"id": "TOTAL_AREA",
"value_name": "40 m²"
}
],
"video_id": "gqkEN9poKM;matterport",
"description": {plain_text: "This is the real estate property description. \n"},
}
https://api.mercadolibre.com/items

Respuesta:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.499Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address 1234",
        "zip_code": "01234567",
        "neighborhood": {
            "id": "TUxBQlBBUzgyNjBa",
            "name": "Paso del Rey"
        },
        "city": {
            "id": "TUxBQ01PUmViMTE3",
            "name": "Moreno"
        },
        "state": {
            "id": "TUxBUEdSQWVmNTVm",
            "name": "Bs.as. G.b.a. Oeste"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.48755,
        "longitude": -58.56987,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.48755,
        "longitude": -58.56987
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.823Z",
    "last_updated": "2020-02-13T19:29:01.823Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}
Nota:
Para Mercado Libre México, los items de inmuebles publicados desde la API de Mercado Libre serán mostrados automáticamente también en el sitio de metroscubicos.com.


Calidad de publicaciones de Venta y Arriendo

Las propiedades en venta y en arriendo tienen criterios de calidad diferentes:

  • Para las propiedades en venta, es necesario cumplir todos los objetivos para alcanzar el 100% de calidad. Aunque no es obligatorio cumplir con todos los objetivos, como incluir un video, estos elementos adicionales ayudan a mejorar la evaluación general.
  • Para las propiedades en arriendo, se requiere cumplir con menos objetivos para lograr el 100% de calidad.

Verifique a continuación el flujo detallado con los criterios de calidad para cada tipo de propiedad, facilitando así el cumplimiento de los requisitos:



Items penalizados

Items penalizados necesitan de la atención del vendedor para que vuelvan a tener una buena exposición o, en casos graves, no sean pausados. Para identificar estos ítems para los dominios de Vehículos e Inmuebles, disponibilizamos 2 tags con los siguientes motivos de penalización: .

  • misplaced_personal_data: item penalizado por datos personales en campos no indicados.
  • moderation_penalty : Ítem penalizado. En este caso, por ser un tag genérico, es necesario hacer una consultaal recurso /infractions para conocer el motivo.

Para listar los ítems en esta condición, es posible utilizar el GET:

Llamada:

curl --location --request GET 'https://api.mercadolibre.com/users/$USER_ID/items/search?tags=$TAG' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Ejemplo:

curl --location --request GET 'https://api.mercadolibre.com/users/705332753/items/search?tags=misplaced_personal_data' \
--header 'Authorization: Bearer $ACCESS_TOKEN'

Respuesta:

{

   "seller_id": "705332753",
   "query": null,
   "paging": {
       "limit": 50,
       "offset": 0,
       "total": 1
   },
   "results": [
       "MLB1790900231"
   ],
   "orders": [
       {
           "id": "stop_time_asc",
           "name": "Order by stop time ascending"
       }
   ],
   "available_orders": [
       {
           "id": "stop_time_asc",
           "name": "Order by stop time ascending"
       },
       {
           "id": "stop_time_desc",
           "name": "Order by stop time descending"
       },
       {
           "id": "start_time_asc",
           "name": "Order by start time ascending"
       },
       {
           "id": "start_time_desc",
           "name": "Order by start time descending"
       },
       {
           "id": "available_quantity_asc",
           "name": "Order by available quantity ascending"
       },
       {
           "id": "available_quantity_desc",
           "name": "Order by available quantity descending"
       },
       {
           "id": "sold_quantity_asc",
           "name": "Order by sold quantity ascending"
       },
       {
           "id": "sold_quantity_desc",
           "name": "Order by sold quantity descending"
       },
       {
           "id": "price_asc",
           "name": "Order by price ascending"
       },
       {
           "id": "price_desc",
           "name": "Order by price descending"
       },
       {
           "id": "last_updated_desc",
           "name": "Order by lastUpdated descending"
       },
       {
           "id": "last_updated_asc",
           "name": "Order by last updated ascending"
       },
       {
           "id": "total_sold_quantity_asc",
           "name": "Order by total sold quantity ascending"
       },
       {
           "id": {
               "id": "total_sold_quantity_desc",
               "field": "sold_quantity",
               "missing": "_last",
               "order": "desc"
           },
           "name": "Order by total sold quantity descending"
       },
       {
 
          "id": {
               "id": "inventory_id_asc",
               "field": "inventory_id",
               "missing": "_last",
               "order": "asc"
           },
           "name": "Order by inventory id ascending"
       }
   ]
}
}

Video, video 360 y tour virtual

Para publicar un video, video 360 o un tour virtual de un inmueble debes usar el campo video_id en la publicación, que está compuesto por el string correspondiente al id del recurso multimedia y a un identificador del proveedor o plataforma relacionada al recurso. De esta manera, video_id =multimedia_resource_id;multimedia_provider_id soporta estos 2 tipos de recursos multimedia:


Youtube (solo para videos), por ejemplo: “video_id”:“gqkEN9poKM;youtube”.

Matterport (solo para tours virtuales), por ejemplo: “video_id”:“gqkEN9poKM;matterport”.

Sólo es posible informar un tipo de contenido multimedia, o sea debes enviar el link del video de Youtube o una url de Matterport.

El campo video_id no acepta parámetros. Por esto, si envías el contenido como “video_id”:“URTsWQ6iHsJ&brand=0;matterport”, no va funcionar.

Nota:
Esta funcionalidad está disponible para todos los sites, excepto inmuebles publicados en:
Mercado Livre Brasil: de la categoría Proyectos inmobiliarios.
Mercado Libre Venezuela: Tu inmueble.
Mercado Libre México: Metros Cúbicos.

Publica inmuebles en Portal inmobiliario (Solo aplica para MLC)

En Chile (MLC), para que el ítem quede correctamente cargado en MercadoLibre y Portal Inmobiliario, debes incluir en el Post del ítem dentro de attributes, el atributo CMG_Site, lo que incorporará el listing_source: portalinmobiliario dejando visible en ambos portales. Para incluirlo, debes agregarlo tal cual el siguiente json:

{
    "id": "CMG_SITE",
    "name": "Sitio de origen",
    "value_id": null,
    "value name": "POI",
    "value_struct": null,
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
}


Modifica la localización de tu inmueble

Para efectuar modificaciones en la publicación, se debe enviar un PUT con los nuevos campos que se modificarán. En el ejemplo abajo, se envía una nueva ubicación:

curl -X PUT  -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
    "location": {
        "address_line": "My property address NEW 111",
        "zip_code": "5000",
        "neighborhood":{
               "id":"TUxBQlBBTDI1MTVa",
               "name":"Palermo"
        },
        "city":{
              "id":"TUxBQ0NBUGZlZG1sYQ",
              "name":"Capital Federal"
        }
    }
}

}' https://api.mercadolibre.com/items/{item_id}

Respuesta:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.000Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "size": "500x438",
            "max_size": "548x481",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address NEW 111",
        "zip_code": "5000",
        "neighborhood": {
            "id": "TUxBQlBBTDI1MTVa",
            "name": "Palermo"
        },
        "city": {
            "id": "TUxBQ0NBUGZlZG1sYQ",
            "name": "Capital Federal"
        },
        "state": {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.6315538,
        "longitude": -58.7404704,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.6315538,
        "longitude": -58.7404704
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "unit": "m²",
                "number": 30
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "unit": "m²",
                        "number": 30
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "unit": "m²",
                "number": 40
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "unit": "m²",
                        "number": 40
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "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,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.000Z",
    "last_updated": "2020-02-13T19:48:23.890Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Tiendas Oficiales para Vehículos e Inmuebles

El campo official_store_id es requerido para todas las publicaciones de aquellos usuarios que tengan asociada una Tienda Oficial.
Si el vendedor no tiene una Tienda Oficial asociada, puedes enviar el campo official_store_id como null. Pero si tiene una Tienda Oficial y no la menciona va generar un error:


{"message"=>"Validation error", "error"=>"validation_error", "status"=>400, "cause"=>[{"department"=>"items", "cause_id"=>144, "type"=>"error", "code"=>"item.official_store_id.invalid", "references"=>["item.official_store_id", "item.seller_id"], "message"=>"Users type brand have to provide a official store id"}]}

El objetivo de este campo es asociar el ítem a la Tienda Oficial correspondiente al ID. Revisa la siguiente documentación sobre Tiendas Oficiales para conocer más.


Cómo saber si tu vendedor tiene Tienda Oficial

En el caso que el vendedor tenga una Tienda Oficial, puedes obtener el ID y más detalles de la marca siguiendo esta guía.


Cómo agregar el official_store_id

Al momento de publicar (POST) el ítem, deberás agregar el ID de la tienda en el campo official_store_id. En el caso del update (PUT), deberás agregar el campo official_store_id solo si se requiere actualizar este explícitamente.


Conoce más cómo publicar un ítem

Publicar un artículo en una Tienda Oficial es lo mismo que publicar cualquier otro artículo, salvo que también debes agregar el atributo official_store_id en el JSON.

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "Content-Type: application/json" -d
'{
  "title":"Item de Test -No Ofertar",
  "category_id":"MLA401686",
  "price":137000,
  "official_store_id": 3121,
  "currency_id":"USD",
  "available_quantity":1,
  "buying_mode":"classified",
  "listing_type_id":"silver",
  "condition":"new",
  "description": "Item:, Depto 2 Amb Semipiso Con Balcón Terraza Al Frente!",
  "video_id": "YOUTUBE_ID_HERE",
  "pictures":[
    {"source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/ap.jpg"},
    {"source":"http://en.wikipedia.org/wiki/File:Teashades.gif"}
  ]
}'
 
https://api.mercadolibre.com/items

Respuesta:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": 3121,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.499Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address 1234",
        "zip_code": "01234567",
        "neighborhood": {
            "id": "TUxBQlBBUzgyNjBa",
            "name": "Paso del Rey"
        },
        "city": {
            "id": "TUxBQ01PUmViMTE3",
            "name": "Moreno"
        },
        "state": {
            "id": "TUxBUEdSQWVmNTVm",
            "name": "Bs.as. G.b.a. Oeste"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.48755,
        "longitude": -58.56987,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.48755,
        "longitude": -58.56987
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.823Z",
    "last_updated": "2020-02-13T19:29:01.823Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Conoce los errores comunes al publicar en Tiendas Oficiales

A continuación, puedes ver el error 400 que reciben aquellos usuarios asociados a Tiendas Oficiales que no envíen el atributo.
Si no envías el official_store_id del artículo para una Tienda Oficial multimarca, recibirás como respuesta los posibles ID que podrías enviar con tu usuario:

"message": "Validation error",
   "error": "validation_error",
   "status": 400,
   "cause": [{
    "code": "item.official_store_id.invalid",
    "message": "Users type brand have to provide a official store id"
Si envías un official_store_id inválido para una Tienda Oficial multimarca recibirás:
{
   "message": "body.invalid_official_store_id",
   "error": "The seller 148829068 is not allowed to use official_store_id 315 on site MLA.",
   "status": 403,
   "cause": []
}


Configurar paquete para usuario de prueba

Para añadir un paquete para publicaciones de prueba, cargue los datos de su usuario de test en el soporte por site:


Siguiente: Sincroniza publicaciones.