Publicação de imóveis

Agora que já analisamos os principais assuntos, acreditamos que você esteja pronto para realizar sua primeira publicação. Leia o tutorial e aprenda a fazer isso:

Conteúdos

→Princípios básicos
→Resultados das publicações
→Campos do imóvel
→Definição de atributos
    ↳Title
    ↳Description
    ↳Localização
    ↳Contatos do vendedor
    ↳Imagens
    ↳Categorias e atributos
    ↳Price
    ↳Moedas
    ↳Listing type
    ↳Available_quantity
    ↳Condition
→Publicação de um imóvel
→Modificar a localização de imóveis
→Lojas Oficiais para Veículos e Imóveis
    ↳Como saber se o seu vendedor tem uma Loja Oficial
    ↳Como adicionar o official_store_id
    ↳Saiba mais como publicar um item
    ↳Conheça os erros comuns ao postar em Lojas Oficiais


Princípios básicos

De modo geral, imóveis e classificados constituem o único tipo de publicação que permite aos usuários mostrarem suas informações de contato ao público; por isso, toda vez que os usuários buscam imóveis para alugar ou comprar e se interessam por uma de suas publicações, podem entrar em contato com você imediatamente. Desse modo você não venderá nem alugará seu imóvel diretamente de nosso site, mas vai mostrá-la a todos os usuários que estiverem buscando imóveis na web.


Resultados das publicações

Cada imóvel que você publicar aparecerá nos resultados das publicações de uma determinada busca. Por exemplo, quando um usuário estiver buscando a consulta “Casa em Mar del Plata”, ele obterá como resultado uma lista de todos os itens relacionados. Seu imóvel pode estar incluído nessa lista. Quando alguém clica em um imóvel, ele é exibido na página de detalhes junto com todas as informações sobre ele que tenham sido fornecidas no momento da publicação. Para obter mais informações, continue lendo a respeito.


Campos de una publicación de inmuebles

Vamos consultar um imóvel pela API. Isso é fácil, pois você só precisa conhecer o item_id associado a tal item e, como ele é público, pode ser obtido na página do item. O itemd_id é encontrado na parte superior da página. É preciso acrescentar o site_id antes do número que está vendo e pronto. Agora você pode chamar o recurso Items para obter todas as informações de que precisa:

Chamada:

curl - X GET https://api.mercadolibre.com/items/$ITEM_ID

Exemplo:

curl - X GET https://api.mercadolibre.com/items/MLA839018613

Resposta:

{
    "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": null,
    "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
}

A resposta JSON contém muitas informações. A seguir, você encontrará a descrição de alguns desses campos.


Definição de atributos

É necessário saber que, ao criar um JSON para seu anúncio, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão automaticamente adicionados pelo ML. Eles definirão o modo como o anúncio será exibido e sua posição nos resultados da busca. Abaixo mencionamos os campos mais importantes que devem ser enviados. Lembre-se que além deles, devem também ser enviados os campos complementadores (atributos) no array de atributos. Para maiores informações, leia o guia de categorias e atributos.


Title

Importante:
A partir de 15 de junho, Mercado Libre Chile terá um máximo de 60 caracteres permitidos para publicar um imóvel e deixa de ser 200.

Evitar adjetivos e abreviações. O título correto deve ter o tipo de operação (aluguel/venda/aluguel de temporada) + tipo de propriedade (casa, apartamento, etc..) + ambientes + bairro. As palavras do título são muito importantes já que são elas que coincidem com a palavra buscada pelo usuário, então quanto maior esta coincidência, melhor ranking a publicação terá. Exemplo: Venda Apartamento 2 Quartos Morumbi.


Description

Uma descrição detalhada irá melhorar suas possibilidades de alugar ou vender seu imóvel e fará com que você poupe tempo, já que não terá de responder a perguntas desnecessárias. Ao trabalhar com descrições, há algumas considerações a serem levadas em conta. Se você estiver interessado em saber mais sobre o assunto, consulte nosso guia Trabalhando com descrições.

Nota:
A descrição do produto deve ser em texto sem formatação. Não informe contato como número de telefone, endereço ou site neste campo. Caso você envie, aceitaremos o anúncio, mas será penalizado ou moderado e não ficará bem posicionado nas buscas. Para consultar os anuncios moderados, utilize nosso guía de Gerenciamento de moderações.


Localização

Ao publicar um anúncio classificado, é obrigatório enviar sua localização. A localização do Mercado Livre possui 4 níveis: country, state, city e neighborhood. Você deve enviar pelo menos city ou neighborhood. Exemplo:

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

Lembre-se sempre de enviar o id de cada localização enviada, conforme o exemplo acima. Para o campo “address_line”, envie sempre o logradouro seguido do número (o número do logradouro deve sempre ser a última informação enviada neste campo.
Exemplo correto: Avenida Jurucê, 436.
Exemplo incorreto: Avenida Jurucê, 436 Moema.


Acessa a este link, para saber como consultar os códigos de localizações do Mercado Livre.


Contatos do vendedor

São os dados de contato do vendedor dono do anúncio. Estes valores são opcionais, e se não informados, o Mercado Livre irá utilizar os dados da conta do vendedor.
Exemplo:

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Nota:
Quando há perguntas de compradores nos anúncios, o Mercado Livre as envia ao e-mail do vendedor, informando no campo seller_contact.email. Caso este campo que nao esteja preenchido, o Mercado Livre utilizará o e-mail da conta do vendedor no site.
Para gerenciar perguntas por API utilize nosso guia Gerencie perguntas e respostas. Caso o campo “seller_contact” esteja como “not_allowed” a categoria nao permite carregar informações ao respeito.
Os campos country_code2, area_code2, phone2 podem ser utilizados para que o vendedor receba contatos por WhatsApp.


Imagens

Imagens de boa qualidade podem fazer com que seu imóvel seja mais atrativo e dão aos usuários uma ideia mais precisa de como ele é. Basicamente, você deve adicionar um conjunto de até seis imagens URL no JSON.
Para saber a quantidade de imagens que é possível publicar, é necessário consultar na categoria os campos max_pictures_per_item y max_pictures_per_item_var.

{
 ....
 "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"}
 ]
 ...
}

Recomendamos não usar servidores lentos para hospedar suas imagens, pois pode gerar inconvenientes ao fazer a publicação. Você também pode adicionar ou alterar as imagens de seu produto aqui posteriormente. Leia mais sobre isso para saber quais são os tipos de imagens permitidas e como trabalhar com elas.


Categorias e Atributos

Os vendedores deverão definir uma categoria no site do Mercado Livre. Esse atributo é obrigatório e somente aceita IDs pré-estabelecidos. Para obter mais informações, leia o guia de Categorias e Atributos.

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

Price

Este atributo é obrigatório. Ao definir um novo anúncio, ele deve ter um preço. Se você já tiver definido um preço, mas não está satisfeito com ele, poderá alterá-lo posteriormente.


Moedas

Este atributo é obrigatório. Você deve defini-lo usando um ID predefinido. Você encontrará os códigos de moeda disponíveis ligando para a categoria em que deseja publicar seu artigo. Veja exemplos do recurso Localização e moedas aqui.

Listing Type

Basicamente é o plano contratado pelo seu cliente. Trata-se de outro caso de atributo obrigatório que só aceita valores pré-definidos e é muito importante que você entenda isso. Existem diferentes tipos de publicação disponíveis para cada site. Você deve fazer uma chamada mista através dos sites e dos recursos listing_types para saber quais são os listing_types aceitos. Siga nosso guia para saber qual o tipo de publicação mais conveniente para seu anúncio.


Available_quantity

Deve ser sempre enviado “1”. Representa a quantidade de itens deste anúncio. No Mercado Livre, os anúncios classificados não trabalham com estoque, cada anúncio representa um registro de imóvel / veículo / serviço único.


Condition

Pode ser “new”, “used” ou o "not_specified", dependendo da condição do anúncio.


Publicação de um imóvel

Agora você já está pronto para publicar seu primeiro imóvel. Lembre de que, para isso, você vai precisar de um access_token. Se tiver dúvidas sobre como obter seu token de acesso, consulte o tutorial Autenticação e Autorização. Além disso, recomendamos validar o JSON que estiver enviando antes de realizar a solicitação POST; por isso, é melhor consultar nosso tutorial de validação de anúncios. É fácil e rápido. Você pode criar um JSON para seu imóvel com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um imóvel de exemplo no site:

Ejemplo:

curl -X POST -H "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",
"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²"
}
],
"description": {plain_text: "This is the real estate property description. \n"},
}
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

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, itens imobiliários publicados a partir da API do Mercado Libre também serão exibidos automaticamente no site metroscubicos.com.


Modificar a localização de imóveis

Para realizar alterações na publicação, deve ser enviado um PUT com os novos campos a serem alterados. No exemplo abaixo, é enviada uma nova localização:

ccurl -X PUT -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}?access_token=$ACCESS_TOKEN

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": []
}

Lojas Oficiais para Veículos e Imóveis

O campo official_store_id é obrigatório para todas as publicações dos usuários que possuem uma Loja Oficial associada. Se o vendedor não tiver uma Loja Oficial associada, você poderá enviar o campo official_store_id como null. O objetivo deste campo é associar o item à Loja Oficial correspondente ao ID. Consulte a seguinte documentação nas Lojas Oficiais para saber mais. Se já tem uma Loja Oficial e não é mencionada, dará erro:

{"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"}]}

Como saber se o seu vendedor tem uma Loja Oficial

Caso o vendedor tenha uma Loja Oficial, você pode obter o ID e mais detalhes da marca seguindo este guia.


Como adicionar o official_store_id

Ao publicar (POST) o item, você deve adicionar o ID da loja no campo official_store_id. No caso do update (PUT), você deve adicionar o campo official_store_id apenas se for necessário atualizar explicitamente.


Saiba mais como publicar um item

A publicação de um item em uma Loja Oficial é o mesmo que a publicação de qualquer outro item, exceto que você também deve adicionar o atributo official_store_id no JSON.

Exemplo:

curl -X POST -H "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?access_token=$ACCESS_TOKEN

Resposta:

{
    "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": []
}

Conheça os erros comuns ao postar em Lojas Oficiais

Abaixo, você pode ver o erro 400 recebido pelos usuários associados às lojas oficiais que não enviam o atributo.
Se você não enviar o official_store_id do item para uma loja multimarca oficial, receberá em resposta os possíveis IDs que você poderia enviar com seu usuário:

"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"

Se você enviar um official_store_id inválido para uma loja multimarca oficial, receberá:

{
   "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": []
}

Proximo: Sincronização de publicações.