Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 15/03/2023

Gerenciamento das áreas de cobertura

Apesar de esse atributo ser opcional, sugerimos especificá-lo, pois poupará tempo para você e outros usuários, já que você não precisará mais responder perguntas sobre o assunto. Saiba como lidar com áreas de cobertura (Link). As áreas de cobertura farão com que os usuários saibam se o serviço que você está oferecendo tem alcance nas áreas onde eles se encontram. Você deverá enviar cada uma das áreas com IDs pré-estabelecidos, que podem ser encontrados em nossa API.


Áreas de cobertura por site

Para saber quais são os IDs das áreas de seu país, faça uma chamada combinada entre sites e adicione recursos das áreas de cobertura.

Exemplo:

curl -X GET https://api.mercadolibre.com/sites/MLA/coverage_areas

Resposta:

{
    "id": "TUxBUENBUGw3M2E1",
    "description": "Bs.As. Cap. Federal",
    "zone": "Capital Federal",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQWU4ZDkz",
    "description": "Bs.As. G.B.A. Norte",
    "zone": "Gba Norte",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQWVmNTVm",
    "description": "Bs.As. G.B.A. Oeste",
    "zone": "Gba Oeste",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQXJlMDNm",
    "description": "Bs.As. G.B.A. Sur",
    "zone": "Gba Sur",
    "type": "state"
  },
  {
    "id": "TUxBUENPU2ExMmFkMw",
    "description": "Bs.As. Costa Atlántica",
    "zone": "Gba Costa Atlántica",
    "type": "state"
  },
  {
    "id": "TUxBUFpPTmFpbnRl",
    "description": "Bs.As. Zona Interior",
    "zone": "Buenos Aires",
    "type": "state"
  },
  {
    "id": "TUxBUENBVGFiY2Fm",
    "description": "Catamarca",
    "zone": "Catamarca",
    "type": "state"
  },
  {
    "id": "TUxBUENIQW8xMTNhOA",
    "description": "Chaco",
    "zone": "Chaco",
    "type": "state"
  },
  {
    "id": "TUxBUENIVXQxNDM1MQ",
    "description": "Chubut",
    "zone": "Chubut",
    "type": "state"
  },
  {
    "id": "TUxBUENPUmFkZGIw",
    "description": "Córdoba",
    "zone": "Córdoba",
    "type": "state"
  },
  {
    "id": "TUxBUENPUnM5MjI0",
    "description": "Corrientes",
    "zone": "Corrientes",
    "type": "state"
  },
  {
    "id": "TUxBUEVOVHMzNTdm",
    "description": "Entre Ríos",
    "zone": "Entre Ríos",
    "type": "state"
  },
  {
    "id": "TUxBUEZPUmE1OTk5",
    "description": "Formosa",
    "zone": "Formosa",
    "type": "state"
  },
  {
    "id": "TUxBUEpVSnk3YmUz",
    "description": "Jujuy",
    "zone": "Jujuy",
    "type": "state"
  },
  {
    "id": "TUxBUExBWmE1OWMy",
    "description": "La Pampa",
    "zone": "La Pampa",
    "type": "state"
  },
  {
    "id": "TUxBUExBWmEyNzY0",
    "description": "La Rioja",
    "zone": "La Rioja",
    "type": "state"
  },
  {
    "id": "TUxBUE1FTmE5OWQ4",
    "description": "Mendoza",
    "zone": "Mendoza",
    "type": "state"
  },
  {
    "id": "TUxBUE1JU3MzNjIx",
    "description": "Misiones",
    "zone": "Misiones",
    "type": "state"
  },
  {
    "id": "TUxBUE5FVW4xMzMzNQ",
    "description": "Neuquén",
    "zone": "Neuquén",
    "type": "state"
  },
  {
    "id": "TUxBUFLNT29iZmZm",
    "description": "Río Negro",
    "zone": "Río Negro",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTGFjMTJi",
    "description": "Salta",
    "zone": "Salta",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTm5lYjU4",
    "description": "San Juan",
    "zone": "San Juan",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTnM0ZTcz",
    "description": "San Luis",
    "zone": "San Luis",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTno3ZmY5",
    "description": "Santa Cruz",
    "zone": "Santa Cruz",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTmU5Nzk2",
    "description": "Santa Fe",
    "zone": "Santa Fe",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTm9lOTlk",
    "description": "Santiago del Estero",
    "zone": "Santiago Del Estero",
    "type": "state"
  },
  {
    "id": "TUxBUFRJRVoxM2M5YQ",
    "description": "Tierra del Fuego ",
    "zone": "Tierra Del Fuego",
    "type": "state"
  },
  {
    "id": "TUxBUE5FVW4xMzMzNQ",
    "description": "Tucumán",
    "zone": "Tucumán",
    "type": "state"
  },
  {
    "id": "AR",
    "description": "Argentina",
    "zone": "Todo el País",
    "type": "country"
  }

ID da área de cobertura

Acesse os detalhes de uma área específica.

Exemplo:

curl -X GET https://api.mercadolibre.com/coverage_areas/TUxBUEpVSnk3YmUz

Resposta:

{
  "id": "TUxBUEpVSnk3YmUz",
  "description": "Jujuy",
  "zone": "Jujuy",
  "type": "state"
}

Adição de áreas de cobertura

Para adicionar áreas de cobertura em uma publicação existente, faça uma solicitação PUT para a API de produtos com o JSON a seguir:

Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
coverage_areas: ["TUxBUExBWmEyNzY0","TUxBUEpVSnk3YmUz"]
}

Seguinte: Publicação de serviços.