Gestionar paquetes de inmuebles

Tipos de Paquetes

En la publicación de cada inmueble, el tipo de paquete contratado se identifica mediante el campo listing_type.Para publicar inmuebles en MercadoLibre, es fundamental comprender los diferentes tipos de paquetes disponibles y su impacto en la gestión y visibilidad de las publicaciones:

• 1. Paquete de Publicación (listing_type: silver)

El paquete de publicación es de carácter obligatorio. Sin este paquete, no es posible crear ningún anuncio en la plataforma, ya que habilita el cupo necesario para publicar. Cada vez que creas una publicación, se descuenta un cupo de este paquete; esto garantiza que tu cuenta está habilitada para listar inmuebles.

• 2. Paquete Destacado (listing_typec: gold / gold_premium )

El paquete destacado es opcional y se utiliza para aumentar la exposición y prioridad de una publicación frente a otras en los resultados de búsqueda. Los paquetes tipo Oro (gold) y Oro Premium (gold_premium) permiten resaltar tus anuncios, logrando mayor visibilidad y atrayendo a más potenciales compradores. Esto mejora el posicionamiento y visibilidad de un anuncio publicado.

Cupos y límite de publicaciones

Cada paquete, ya sea de publicación o destacado, incluye una cantidad finita de cupos que determina el número de publicaciones o destaques que puedes realizar. Si agotas los cupos de algún paquete, ya no podrás crear (o destacar) nuevas publicaciones hasta contratar o ampliar tu paquete. Es importante monitorear regularmente la disponibilidad de cupos para evitar interrupciones en tu operativa.

Consideraciones Adicionales sobre Paquetes:

• Paquetes Mixtos:

Es fundamental consultar el paquete de publicación que posee el usuario para verificar el listing_type de los cupos disponibles para publicar. Es importante aclarar que los paquetes MIXTOS (con cupos Oro, Oro Premium y Plata) no se pueden utilizar para destacar publicaciones.

• Retraso en la Actualización de la API de Paquetes:

Los cupos pueden tardar unos minutos en liberarse. Si el integrador finaliza los ítems y los vuelve a activar rápidamente, o si realiza un downgrade y luego un upgrade en un corto período de tiempo, es posible que los cupos no se liberen a tiempo, lo que podría resultar en la pérdida de cupos.

Consejos adicionales.

• Upgrades y downgrades: Puedes cambiar el tipo de paquete de una publicación existente. Por ejemplo, puedes “upgradear” de plata a oro para destacar un inmueble, siempre que tengas cupos disponibles.

1. Consulta qué paquetes de publicación están disponibles para contratar:

Recuerda que, al realizar llamadas GET al recurso /classifieds_promotion_packs, podrás consultar los paquetes disponibles para una categoría principal específica con la siguiente llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/classifieds_promotion_packs

Estructura de Respuesta Esperada:

Para este ejemplo vamos a consultar los paquetes disponibles para la categoría de inmuebles de Chile, así que en el curl anterior vamos a reemplazar $CATEGORY_ID por MCL1459.El resultado esperado es un arreglo de paquetes de publicación con la siguiente estructura:

[
    {
        "id": "IP10000P30",
        "category_id": "MLC1459",
        "brand": "PORTALINMOBILIARIO",
        "description": "10000 Publicaciones Plata",
        "price": 345.1,
        "package_type": "rotary",
        "package_content": "publications",
        "duration": 30,
        "status": "active",
        "charge_type_id": "CREM",
        "max_upgrades": null,
        "quota_type": "reusable",
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 10000
            }
        ],
        "visibility": "public"
    }
]

2. Contrata paquetes de publicación

Para contratar los paquetes de publicación que se ajusten a tus necesidades, como primer paso deberás solicitar que se active tu usuario mediante el formulario de contactar a soporte, seleccionando la opción de activación de usuario. Una vez se te notifique que tu usuario se encuentra activo, sigue los pasos definidos en la guía de contratación de paquetes de publicación y destaques.

3. Consulta que paquetes tienes contratados por usuario

Esta consulta es fundamental para determinar qué paquetes tiene contratados un cliente y la cantidad de anuncios disponibles en cada uno.

Llamada:

 -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/classifieds_promotion_packs?package_content=$PACKAGE_CONTENT&status=$STATUS

Estructura de respuesta esperada:

[
    {
     "id": 754985,
     "user_id": "123456789",

https://developers.mercadolibre.com.uy/es_ar/producto-consulta-usuarios

     "promotion_pack_id": "MPAB",
     "category_id": "MLC1743",
     "description": "Paquete 15 Básico",
     "package_type": "rotary",
     "package_content": "publications",
     "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
        }
     ]
    }
]

3.1 Consulta que paquetes tienes contratados por usuario y tipo de paquete

Puedes consultar si un usuario tiene contratado un tipo de paquete (listing_type) específico por medio del siguiente curl:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/classifieds_promotion_packs/$LISTING_TYPE?categoryId=$CATEGORY_ID

Siguientes Pasos

• Publica inmuebles.
• Publicaciones de tiendas oficiales

Actualizaciones de versión

Esta sección proporciona información sobre las actualizaciones de la API, incluyendo:

Historial de cambios