Gestiona Paquetes (Inmuebles)

Los Paquetes Promocionales son paquetes para publicaciones de Clasificados de Inmobiliarias.
Para que un usuario pueda publicar como inmobiliaria masivamente mediante acuerdo comercial debe:

  • Configurar el usuario como real state
  • Asignar un paquete de publicaciones
  • Contratar un paquete de destaque (opcional)

NOTA: Para realizar pruebas, deberás enviar el usuario de test al canal de soporte para que sea activado como real state.

Contenidos:

Consultar paquetes por categoría

Los valores posibles para las categorías classifieds_promotion_packs son diferentes en cada site:
{site_id}1459: Inmobiliaria.
Por ejemplo, en Argentina, la categoría de paquetes para Inmobiliaria MLA1459, mientras que en Brasil es MLB1459.
Realiza una solicitud GET para buscar paquetes en una categoría específica:

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

Ejemplo:

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

Consultar paquetes de publicación contratados por un usuario

Los paquetes de publicaciones son planos para publicar en una sola exposición. Tenemos la opción de contratar un paquete de destaque para aumentar exposición a demanda.
Sólo en MCO existen paquetes mixtos con varios cupos de exposiciones diferentes, por ejemplo silver, oro y oro_premium, en los cuales el aumento o disminución de la exposición se logra mediante la finalización y relistado de la publicación.

Llamada:

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

Ejemplo:

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

Respuesta:

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

Consultar paquetes de destaque contratados por un usuario

De acuerdo con el nivel de exposición que desees para tus artículos, podrás contratar diferentes paquetes de destaque. Para más información te recomendamos leer el siguiente tutorial.

NOTA: Para MCO no existen paquetes de destaques. Directamente al momento de activar un paquete de publicaciones, el mismo es mixto con cupos de exposiciones diferentes, en los cuales el aumento o disminución de la exposición se logra mediante la finalización y relistado de la publicación.

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

Respuesta:

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

Descripción de recursos

atributo descripción
id Identificador único del paquete.
user_id ID único del usuario que contrató el paquete.
category_id Categoría del paquete.
description nombre del paquete.
package_type: detalle del paquete.
status los valores posibles del estado del paquete son:
activo: el usuario puede utilizar este paquete para publicar. Se descontará una available_listing cuando lo haga.
pendiente: el paquete aún no está activo.
finalizado: paquete expirado.
date_created fecha de creación del paquete.
date_start: fecha de activación del paquete.
date_expires fecha de expiración del paquete.
date_stopped fecha de finalización del paquete.
last_updated última actualización del paquete.
engagement_type Los valores posibles son:
“ninguno”: El paquete se contrató por única vez.
“recontratación”: Cuando el paquete expira, se recontratará automáticamente un package_type similar.
charge_id ID único del cargo generado durante la contratación del paquete.
listing_details información detallada sobre tipos y disponibilidad de publicaciones.
listing_type_id listing_type asociado con el paquete.
available_listings cantidad de publicaciones que el usuario obtiene con el paquete.
used_listings publicaciones ya utilizadas.
remaining_listings publicaciones restantes disponibles.

Verificar si un usuario tiene un listing_type específico disponible

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

Destaque de un artículo

Para destacar una publicación deberás realizar el siguiente post, recuerda que para poder realizar esta acción el usuario debe tener un paquete de destaque contratado previamente:
Llamada:

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

Ejemplo:

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

Respuesta:

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

Siguiente:
Publica inmuebles

Por favor califica del 1 al 5