Gerenciamento de pacotes

Os Pacotes Promocionais são pacotes com publicações de classificados de concessionárias de automóveis e imobiliárias. Neste tutorial, você vai aprender a obter informações sobre pacotes e também a contratar e ativar um pacote.

Assuntos

Obtenção de pacotes por categoria

Os valores possíveis para as categorias classifieds_promotion_packs são diferentes em cada site. Os valores possíveis são:
{site_id}1743: Concessionária de automóveis.
{site_id}1459: Imobiliária.
Por exemplo, na Argentina, a categoria de pacotes para concessionárias de automóveis é MLA1743,, enquanto no Brasil ela é MLB1743

Faça uma solicitação GET para buscar pacotes em uma categoria específica:

 curl -X GET https://api.mercadolibre.com/categories/{category_id}/classifieds_promotion_packs

Resposta:

 [
  {
    "id": "IPAA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Básico",
    "price": 350,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 15
      }
    ]
  },
  {
    "id": "IPAR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Premium",
    "price": 600,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 6
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 1
      },
      {
        "listing_type_id": "silver",
        "available_listings": 8
      }
    ]
  },
  {
    "id": "IPAS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Especial",
    "price": 410,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 10
      },
      {
        "listing_type_id": "gold",
        "available_listings": 5
      }
    ]
  },
  {
    "id": "IPBA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Básico",
    "price": 480,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 30
      }
    ]
  },
  {
    "id": "IPBR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Premium",
    "price": 880,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 16
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 2
      },
      {
        "listing_type_id": "gold",
        "available_listings": 12
      }
    ]
  },
  {
    "id": "IPBS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Especial",
    "price": 560,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 20
      },
      {
        "listing_type_id": "gold",
        "available_listings": 10
      }
    ]
  },
  {
    "id": "IPCA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Básico",
    "price": 570,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 60
      }
    ]
  },
  {
    "id": "IPCR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Premium",
    "price": 910,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 32
      },
      {
        "listing_type_id": "gold",
        "available_listings": 24
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 4
      }
    ]
  },
  {
    "id": "IPCS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Especial",
    "price": 650,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 20
      },
      {
        "listing_type_id": "silver",
        "available_listings": 40
      }
    ]
  },
  {
    "id": "IPDA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Básico",
    "price": 750,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 100
      }
    ]
  },
  {
    "id": "IPDR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Premium",
    "price": 1180,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold_premium",
        "available_listings": 5
      },
      {
        "listing_type_id": "gold",
        "available_listings": 35
      },
      {
        "listing_type_id": "silver",
        "available_listings": 60
      }
    ]
  },
  {
    "id": "IPDS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Especial",
    "price": 820,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 25
      },
      {
        "listing_type_id": "silver",
        "available_listings": 75
      }
    ]
  },
  {
    "id": "IPEA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Básico",
    "price": 850,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCEA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 500
      }
    ]
  },
  {
    "id": "IPER",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Premium",
    "price": 1900,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCER",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 100
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 15
      },
      {
        "listing_type_id": "silver",
        "available_listings": 385
      }
    ]
  },
  {
    "id": "IPES",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Especial",
    "price": 1000,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCES",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 70
      },
      {
        "listing_type_id": "silver",
        "available_listings": 430
      }
    ]
  }
]

Obtenção de pacotes contratados por um usuário

 curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN;

Resposta:

 [
    {
        "id": 754985,
        "user_id": "135146148",
        "promotion_pack_id": "MPAB",
        "category_id": "MLU1743",
        "description": "Paquete 15 Básico",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2013-05-23T15:34:48.498-04:00",
        "date_start": "2013-05-23T15:34:47.544-04:00",
        "date_expires": "2013-06-22T15:34:47.544-04:00",
        "date_stopped": null,
        "last_updated": "2013-05-23T15:35:48.211-04:00",
        "engagement_type": "none",
        "charge_id": 822129921,
        "remaining_listings": 15,
        "used_listings": 0,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 15,
                "used_listings": 0,
                "remaining_listings": 15
            }
        ]
    }
]

Descrição de recursos

Atributo Descrição
id Identificador exclusivo do pacote.
user_id ID exclusivo do usuário contratante do pacote.
category_id Categoria do pacote.
descrição Nome do pacote
package_type: Detalhes do pacote.
status Os valores possíveis de status do pacote são:
active: o usuário pode usar esse pacote para publicar. Quando ele fizer a publicação, uma available_listing será descontada.
pending: o pacote ainda não está ativo.
finished: pacote expirado.
date_created Data de criação do pacote.
date_start Data de ativação do pacote
date_expires Data de expiração do pacote
date_stopped Data de finalização do pacote.
last_updated Última atualização do pacote.
engagement_type Os valores possíveis são:
“nenhum”: o pacote foi contratado apenas por uma vez.
“recontratação”: quando o pacote expirar, um package_type similar será automaticamente recontratado.
charge_id ID exclusivo da cobrança gerada durante a contratação do pacote.
listing_details Informações detalhadas sobre tipos de publicações e disponibilidade.
listing_type_id listing_type associado ao pacote.
available_listings Quantidade de publicações obtidas pelo usuário com o pacote.
used_listings Publicações já enviadas.
remaining_listings Publicações restantes disponíveis.

Verificar se um usuário tem um listing_type específico disponível

 curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/silver?access_token=$ACCESS_TOKEN

Contratação e ativação de um pacote

Você pode contratar um pacote e ativá-lo ao realizar uma solicitação POST à API, como no exemplo a seguir:

 curl -X POST "Content-type:application/json" -d '{
"categ_id":"MLA1459", "promotion_pack_id":"IPIN", "engagement_type":"none", "status":"active"
}' https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs&access_token=$ACCESS_TOKEN

A documentação atual é concentrada na nova lógica para pacotes de upgrades em funcionamento somente para imobiliárias da Argentina, Brasil, México e Uruguai. A lógica dos pacotes dos novos upgrades consiste na migração do modelo real no qual são geradas cobranças para upgrades individuais em uma lógica analógica em pacotes de publicações em que o cliente contrata um pacote de upgrades e depois cada upgrade ocupa um espaço ou cota no pacote.

Chamada de pacotes

Existe retrocompatibilidade entre a lógica de pacotes existente e a nova, que adiciona um filtro opcional extra à chamada “package_content”, permitindo diferenciar entre pacotes de publicações e pacotes de atualizações.

Obtenção de pacotes de publicações e upgrades

curl -X GET https://api.mercadolibre.com/categories/{category_id}/classifieds_promotion_packs

Exemplo:

https://api.mercadolibre.com/categories/MLA1459/classifieds_promotion_packs?package_content=upgrades,publications
[
    {
        "id": "IPUA",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Unico Ilimitado 15",
        "price": 600,
        "package_type": "unlimited",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBA",
        "max_upgrades": 12,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 15
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUB",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Unico Ilimitado 50",
        "price": 600,
        "package_type": "unlimited",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBA",
        "max_upgrades": 30,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 50
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUC",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Unico Ilimitado 100",
        "price": 600,
        "package_type": "unlimited",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBA",
        "max_upgrades": 50,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 100
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUD",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Unico Ilimitado 500",
        "price": 600,
        "package_type": "unlimited",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CCBA",
        "max_upgrades": 100,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 500
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUPGG1",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Upgrades Gold Individual",
        "price": 150,
        "package_type": "rotary",
        "package_content": "upgrades",
        "duration": 30,
        "status": "active",
        "charge_type_id": "free",
        "max_upgrades": 1,
        "listing_details": [
            {
                "listing_type_id": "gold",
                "available_listings": 1
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUPGGP1",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Upgrades Gold Premium Individual",
        "price": 220,
        "package_type": "rotary",
        "package_content": "upgrades",
        "duration": 30,
        "status": "active",
        "charge_type_id": "free",
        "max_upgrades": 1,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 1
            }
        ],
        "visibility": "private"
    },
    {
        "id": "IPUPGGP10",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Upgrades 10 Destaques Gold Premium",
        "price": 1650,
        "package_type": "rotary",
        "package_content": "upgrades",
        "duration": 30,
        "status": "active",
        "charge_type_id": "free",
        "max_upgrades": 1,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 10
            }
        ],
        "visibility": "private"
    }
]

Como você pode observar, foram obtidos os pacotes de publicações e os pacotes de upgrades para a categoria especificada.

Pacotes contratados pelo usuário

 GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=

Exemplo:

 https://api.mercadolibre.com/users/184179005/classifieds_promotion_packs?access_token=$ACCESS_TOKEN&status=active,finished&package_content=upgrades,publications
[
    {
        "id": 1024029,
        "user_id": "184179005",
        "promotion_pack_id": "PPUGOLDPREMIUMTEST02",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete de upgrades gold premium",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2015-05-27T14:26:37.790-04:00",
        "date_start": "2015-05-27T14:26:37.692-04:00",
        "date_expires": "2015-06-27T14:26:37.692-04:00",
        "date_stopped": null,
        "last_updated": "2015-05-27T14:26:37.790-04:00",
        "engagement_type": "re-engagement",
        "package_content": "upgrades",
        "charge_id": 0,
        "remaining_listings": 9999,
        "used_listings": 1,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 10000,
                "used_listings": 1,
                "remaining_listings": 9999
            }
        ]
    },
    {
        "id": 1023654,
        "user_id": "184179005",
        "promotion_pack_id": "IPUE",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "Paquete Unico Ilimitado 1000",
        "package_type": "unlimited",
        "status": "active",
        "date_created": "2015-05-26T14:37:12.540-04:00",
        "date_start": "2015-05-26T14:37:12.475-04:00",
        "date_expires": "2015-06-26T14:37:12.475-04:00",
        "date_stopped": null,
        "last_updated": "2015-05-27T14:23:02.951-04:00",
        "engagement_type": "none",
        "package_content": "publications",
        "charge_id": 1725523903,
        "remaining_listings": 999,
        "used_listings": 1,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 1000,
                "used_listings": 1,
                "remaining_listings": 999
            }
        ]
    }
]

Como você pode observar, foram obtidos um pacote de upgrades e um pacote de publicações. Você pode visualizar a diferença no atributo package_content.
Nota: devido à retrocompatibilidade, se o parâmetro package_content não for incluído na solicitação, isso será equivalente à inclusão do package_content =publications. Isso significa que toda vez que você quiser obter pacotes de upgrades, você deverá incluir “upgrades” no parâmetro package_content.

Chamada de pacotes

Exemplo:

 https://api.mercadolibre.com/users/184179005/classifieds_promotion_packs?access_token=$ACCESS_TOKEN&status=active,finished&package_content=upgrades,publications
Resposta caso não existam pacotes:
[
    {
"message":"User promotion packs not found for user 184179005",
"error":"not_found",
"status":404,
"cause":[]
     }

]

Contratação de um pacote

Exemplo:

POST https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN

CORPO SEM RECONTRATAÇÃO AUTOMÁTICA:

{ 
“status”:”active”,
“engagement_type”:”none”,
“promotion_pack_id”:”IPIN”,
“categ_id”:”MLA1743” 
}

Exemplo:

curl -X POST --header "Content-type:application/json" -d 
'{"promotion_pack_id":"PPUGOLDPREMIUMTEST02","categ_id":"MLA1459","engagement_type":"re-engagement","status":"active"}' 'https://api.mercadolibre.com/users/184179005/classifieds_promotion_packs?access_token=$ACCESS_TOKEN'

   "id": 1026038,
    "user_id": "184179005",
    "promotion_pack_id": "PPUGOLDPREMIUMTEST02",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete de upgrades gold premium",
    "package_type": "rotary",
    "status": "active",
    "date_created": "2015-06-03T16:37:31.646-04:00",
    "date_start": "2015-06-03T16:37:31.497-04:00",
    "date_expires": "2015-07-03T16:37:31.497-04:00",
    "date_stopped": null,
    "last_updated": "2015-06-03T16:37:31.646-04:00",
    "engagement_type": "re-engagement",
    "package_content": "upgrades",
    "charge_id": 0,
    "remaining_listings": 10000,
    "used_listings": 0,
    "listing_details": [
        {
            "listing_type_id": "gold_premium",
            "available_listings": 10000,
            "used_listings": 0,
            "remaining_listings": 10000
        }
    ]
}

Como você pode observar, o pacote contratado é retornado. Nesse caso, trata-se de um pacote de upgrades.
NOTA: diferentemente dos pacotes de publicações, os pacotes de upgrades não aceitam “pending” como status inicial.

Exemplo:

curl -X POST --header "Content-type:application/json" -d '{"promotion_pack_id":"PPUGOLDPREMIUMTEST02","categ_id":"MLA1459","engagement_type":"re-engagement","status":"active"}' 'https://api.mercadolibre.com/users/184179005/classifieds_promotion_packs?access_token=$ACCESS_TOKEN'

Resposta caso você não consiga contratar o pacote:

{
    "message": "Promotion pack not found for categ MLA1459 and id PPUGOLDPREMIUMTEST02",
    "error": "not_found",
    "status": 404,
    "cause": []
}

Ativação de um pacote contratado

Exemplo:

PUT https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/{user_promotion_pack_id}?access_token=$ACCESS_TOKEN

Corpo:

{ “status”:”active” }

Para obter o package_id, a seguinte solicitação GET será realizada:

GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?status=pending

Finalização de um pacote contratado

Exemplo:

PUT https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/{user_promotion_pack_id}?acces_token=$ACCESS_TOKEN

Corpo:

{ “status”:”finished” }

Chamadas para upgrades

Caso o usuário não tenha contratado um pacote de upgrade, o upgrade não será realizado.

Upgrades GET por usuário

Exemplo:

GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/user_item_upgrade
?acces_token=$ACCESS_TOKEN

Exemplo:

curl -X GET 'https://api.mercadolibre.com/users/184179005/classifieds_promotion_packs/user_item_upgrade?status=finished,active&access_token=$ACCESS_TOKEN'
{
    "paging": {
        "total": 4,
        "offset": 0,
        "limit": 50
    },
    "results": [
        {
            "item_id": "MLA562766164",
            "listing_type_from": "silver",
            "listing_type_to": "gold_premium",
            "engagement_type": "none",
            "status": "active",
            "date_start": "2015-06-03T08:28:32.000-04:00",
            "date_stop": null,
            "date_expires": "2015-06-27T14:26:37.000-04:00",
            "charge_id": null
        },
        {
            "item_id": "MLA562083882",
            "listing_type_from": "silver",
            "listing_type_to": "gold_premium",
            "engagement_type": "none",
            "status": "active",
            "date_start": "2015-05-29T12:20:39.000-04:00",
            "date_stop": null,
            "date_expires": "2015-06-27T14:26:37.000-04:00",
            "charge_id": null
        },
        {
            "item_id": "MLA562083882",
            "listing_type_from": "silver",
            "listing_type_to": "gold_premium",
            "engagement_type": "none",
            "status": "finished",
            "date_start": "2015-04-29T11:49:06.000-04:00",
            "date_stop": "2015-05-29T11:50:41.000-04:00",
            "date_expires": "2015-06-27T14:26:37.000-04:00",
            "charge_id": null
        },
        {
            "item_id": "MLA561761811",
            "listing_type_from": "silver",
            "listing_type_to": "gold_premium",
            "engagement_type": "none",
            "status": "finished",
            "date_start": "2015-05-27T16:05:48.000-04:00",
            "date_stop": "2015-05-28T08:09:58.000-04:00",
            "date_expires": "2015-06-26T16:05:48.000-04:00",
            "charge_id": null
        }
    ]
}

Como você pode observar, o usuário contratou quatro upgrades, três dos quais já foram finalizados. Você também pode visualizar upgrades contratados para o mesmo produto.
NOTA: segundo essa nova lógica, o atributo charge_id não será mais utilizado. As cobranças serão aplicadas ao pacote.

Verificação de upgrades disponíveis de produtos

GET https://api.mercadolibre.com/items/{item_id}/available_upgrades?access_token=$ACCESS_TOKEN

Exemplo:

curl 'https://api.mercadolibre.com/items/MLA563672820/available_upgrades?&access_token=$ACCESS_TOKEN'
[
    {
        "site_id": "MLA",
        "id": "gold_premium",
        "name": "Oro Premium"
    },
    {
        "site_id": "MLA",
        "id": "gold",
        "name": "Oro"
    }
]

Upgrade do produto

POST https://api.mercadolibre.com/items/{item_id}/listing_type?acces_token=$ACCESS_TOKEN

Corpo:

{ “id”:”{listing_type}” }

A resposta é o produto atualizado.
Exemplo:

 curl -X POST --header "Content-type:application/json" -d '{"id":"gold"}' 'https://api.mercadolibre.com/items/MLA563940625/listing_type?access_token=$ACCESS_TOKEN'
{
    "id": "MLA563940625",
    "site_id": "MLA",
    "title": "Test 10 No Ofertar",
    "subtitle": null,
    "seller_id": 184854440,
    "category_id": "MLA50543",
    "official_store_id": null,
    "price": 2928282,
    "base_price": 2928282,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "classified",
    "listing_type_id": "gold",
    "start_time": "2015-06-09T20:25:50.000Z",
    "stop_time": "2015-07-05T19:51:17.587Z",
    "end_time": "2015-07-05T19:51:17.587Z",
    "condition": "not_specified",
    "permalink": "http://inmueble.mercadolibre.com.ar/MLA-563940625-test-10-no-ofertar-_JM",
    "thumbnail": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "pictures": [
        {
            "id": "302401-MLA20317818801_062015",
            "url": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "size": "500x281",
            "max_size": "1200x675",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "accepts_Mercado Pago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": []
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 163310864,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "falsa 123 123",
        "zip_code": "",
        "neighborhood": {
            "id": "TUxBQkVTUDYyODRa",
            "name": "Espartillar"
        },
        "city": {
            "id": "TUxBQ0FETzQ2Nzc",
            "name": "Adolfo Alsina"
        },
        "state": {
            "id": "TUxBUFpPTmFpbnRl",
            "name": "Buenos Aires Interior"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.6635266,
        "longitude": -58.3654707,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.6635266,
        "longitude": -58.3654707
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MLA1459-HORPREF",
            "name": "Horario de contacto",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ACCESO",
            "name": "Acceso",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ANTIG",
            "name": "Antigüedad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-EXPENCEM",
            "name": "Expensas ($)",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-SEGUR",
            "name": "Seguridad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA1459-INMUEBLE",
            "name": "Inmueble",
            "value_id": "MLA1459-INMUEBLE-COCHERA",
            "value_name": "Cochera",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA1459-OPERACION",
            "name": "Operación",
            "value_id": "MLA1459-OPERACION-VENTA",
            "value_name": "Venta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-MTRSTOTAL",
            "name": "Superficie total (m²)",
            "value_id": "",
            "value_name": "24",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPCOB",
            "name": "Tipo de cobertura",
            "value_id": "MLA50541-TIPCOB-CUBIERTA",
            "value_name": "Cubierta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPOCOCH",
            "name": "Tipo de cochera",
            "value_id": "MLA50541-TIPOCOCH-FIJA",
            "value_name": "Fija",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        }
    ],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [],
    "warranty": null,
    "catalog_product_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2015-06-09T20:25:50.000Z",
    "last_updated": "2015-06-10T12:20:32.418Z"
}

Como fazer downgrade de um produto

 POST https://api.mercadolibre.com/items/{item_id}/listing_type?acces_token=$ACCESS_TOKEN

Corpo:

 { “id”:”{listing_type}” }

A diferença é que o valor do “ID” no JSON será o do listing_type original. Por exemplo, se você fez upgrade da categoria “silver” para “gold”, o ID que você vai enviar na chamada (downgrade) será “silver”.

Exemplo:

 curl -X POST --header "Content-type:application/json" -d '{"id":"silver"}' 'https://api.mercadolibre.com/items/MLA563940625/listing_type?access_token=$ACCESS_TOKEN'
{
    "id": "MLA563940625",
    "site_id": "MLA",
    "title": "Test 10 No Ofertar",
    "subtitle": null,
    "seller_id": 184854440,
    "category_id": "MLA50543",
    "official_store_id": null,
    "price": 2928282,
    "base_price": 2928282,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2015-06-09T20:25:50.000Z",
    "stop_time": "2015-07-05T19:51:17.587Z",
    "end_time": "2015-07-05T19:51:17.587Z",
    "condition": "not_specified",
    "permalink": "http://inmueble.mercadolibre.com.ar/MLA-563940625-test-10-no-ofertar-_JM",
    "thumbnail": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "pictures": [
        {
            "id": "302401-MLA20317818801_062015",
            "url": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "size": "500x281",
            "max_size": "1200x675",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "accepts_Mercado Pago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": []
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 163310864,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "falsa 123 123",
        "zip_code": "",
        "neighborhood": {
            "id": "TUxBQkVTUDYyODRa",
            "name": "Espartillar"
        },
        "city": {
            "id": "TUxBQ0FETzQ2Nzc",
            "name": "Adolfo Alsina"
        },
        "state": {
            "id": "TUxBUFpPTmFpbnRl",
            "name": "Buenos Aires Interior"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.6635266,
        "longitude": -58.3654707,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.6635266,
        "longitude": -58.3654707
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MLA1459-HORPREF",
            "name": "Horario de contacto",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ACCESO",
            "name": "Acceso",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ANTIG",
            "name": "Antigüedad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-EXPENCEM",
            "name": "Expensas ($)",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-SEGUR",
            "name": "Seguridad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA1459-INMUEBLE",
            "name": "Inmueble",
            "value_id": "MLA1459-INMUEBLE-COCHERA",
            "value_name": "Cochera",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA1459-OPERACION",
            "name": "Operación",
            "value_id": "MLA1459-OPERACION-VENTA",
            "value_name": "Venta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-MTRSTOTAL",
            "name": "Superficie total (m²)",
            "value_id": "",
            "value_name": "24",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPCOB",
            "name": "Tipo de cobertura",
            "value_id": "MLA50541-TIPCOB-CUBIERTA",
            "value_name": "Cubierta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPOCOCH",
            "name": "Tipo de cochera",
            "value_id": "MLA50541-TIPOCOCH-FIJA",
            "value_name": "Fija",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        }
    ],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [],
    "warranty": null,
    "catalog_product_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2015-06-09T20:25:50.000Z",
    "last_updated": "2015-06-10T12:20:32.418Z"
}

Finalização de pacotes

 PUT https://api.mercadolibre.com/users/186704185/classifieds_promotion_packs/1047628?access_token=$ACCESS_TOKEN

Corpo:

{ “status”:”{finished}” }

Exemplo:

 curl -X PUT -H "Content-Type: application/json" -d'{
> "status":"finished"
> }' https://api.mercadolibre.com/users/186704185/classifieds_promotion_packs/1047628?access_token=$ACCESS_TOKEN

Perguntas frequentes

É possível fazer um upgrade sem um pacote de upgrades?
Não, isso não é possível.
A contratação de um pacote gera uma cobrança?
Não, a cobrança só é gerada quando você contrata um pacote de upgrades.
Contratei um pacote de upgrades, por que não consigo fazer o upgrade de meu produto?
Os pacotes de upgrades são destinados a tipos de publicações específicas e têm cotas contabilizadas. Certifique-se de ter feito o upgrade do tipo de publicação de seu pacote contratado e verifique se ainda tem cotas disponíveis.
É possível contratar mais de um pacote de upgrades?
Sim, você pode ter vários pacotes de upgrades, mas não pode ter vários pacotes de publicações.
Um cliente pode visualizar a qual pacote o upgrade pertence?
Não.
Se eu fizer um downgrade, a cota é disponibilizada novamente?
Sim, as cotas podem ser reutilizadas quando você finaliza um upgrade ou um produto que teve upgrade.
Quanto tempo duração um upgrade?
Todos os upgrades compartilham a data de finalização de seu pacote.


Próximo:
Publicação de imóveis.

Qualifique entre 1 e 5