Gerenciamento de Pacotes (Imóveis)

Os Pacotes Promocionais são pacotes para anúncios Classificados de Imóveis.
Para que um usuário possa anunciar massivamente como imobiliária mediante acordo comercial, ele terá que:

  • Configurar o usuário como real estate.
  • Alocar um pacote de anúncios.
  • Contratar um pacote destaque (opcional).

NOTA: Para realizar testes, você deverá encaminhar o usuário de teste para o canal de suporte para este ser ativado como real estate.

Conteúdos:

Pesquisar pacotes por categoria

Os valores possíveis para as categorias classifieds_promotion_packs são diferentes em cada site:
{site_id}1459: Imobiliária.

Por exemplo, na Argentina, a categoria de pacotes para concessionárias de automóveis é MLA1459, enquanto no Brasil ela é MLB1459.

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

Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLA1459/classifieds_promotion_packs
[
  {
    "id": "IPILIMP30DF",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete Ilimitado propiedades",
    "price": 1145.87,
    "package_type": "unlimited",
    "package_content": "publications",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCGE",
    "max_upgrades": 300,
    "quota_type": "reusable",
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 100000
      }
    ]
  },
  {
    "id": "IPILIMP90DF",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete Ilimitado propiedades",
    "price": 3081.87,
    "package_type": "unlimited",
    "package_content": "publications",
    "duration": 90,
    "status": "active",
    "charge_type_id": "CCGJ",
    "max_upgrades": 300,
    "quota_type": "reusable",
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 100000
      }
    ]
  },
  {
    "id": "IPILIMP180DF",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete Ilimitado propiedades",
    "price": 5864.87,
    "package_type": "unlimited",
    "package_content": "publications",
    "duration": 180,
    "status": "active",
    "charge_type_id": "CCGO",
    "max_upgrades": 300,
    "quota_type": "reusable",
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 100000
      }
    ]
  }
]

Pesquisar pacotes de anúncios contratados por um usuário

Os pacotes de anúncios são planos para serem publicados em uma única exposição. Oferecemos a opção de contratar um pacote destaque para aumentar a exposição à demanda.
Somente em MCO existem pacotes mistos com diversas opções de exposição, por exemplo, silver, ouro e ouro_premium, nos quais o aumento ou diminuição da exposição é dado mediante a finalização ou nova localização na lista do anúncio.

Chamada:

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

Exemplo:

curl -X GET https://api.mercadolibre.com/users/135146148/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
    	 	}
	   ]
   	}
]

Pesquisar pacotes destaque contratados por um usuário

Conforme o nível de exposição que você quiser para seus produtos, poderá contratar diferentes pacotes destaque. Se quiser mais informações, leia o seguinte tutorial.

NOTA: Para MCO não existem pacotes destaque. No momento de ativar um pacote de anúncios, este será diretamente misto com diversos tipos de exposição, nos quais o aumento ou diminuição da exposição é dado mediante a finalização ou nova localização na lista do anúncio.

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

Resposta:

[
    {
        "id": 1584151,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGGP5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Premium Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:29.124-04:00",
        "date_start": "2017-08-31T09:08:29.113-04:00",
        "date_expires": "2017-09-30T09:08:29.113-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.860-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387845,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    },
    {
        "id": 1584150,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGG5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:28.752-04:00",
        "date_start": "2017-08-31T09:08:28.742-04:00",
        "date_expires": "2017-09-30T09:08:28.742-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.747-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387844,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    }
]

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.

Conferir 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

Destaque de um produto

Para destacar um anúncio, você deverá realizar a seguinte postagem; lembre que, para poder realizar esta ação, o usuário deve ter contratado previamente um pacote destaque.
Chamada:

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

Exemplo:

curl -X POST 'https://api.mercadolibre.com/items/MLA111111111/listing_type?access_token=$ACCESS_TOKEN' -d '{"id":"listing_type"}'

Resposta:

{
	"id": "MLA111111111",
	"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_mercadopago": 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"
}



Próximo:
Publicação de Imóveis

Qualifique entre 1 e 5