Última actualización 04/05/2023

Campañas con descuento por volumen

Importante:
A partir del 10 de Mayo de 2023 deberá enviar el query param app_version=v2 para obtener la respuesta con la nueva versión de los recursos.
Por ahora las 2 versiones de /seller-promotions convivirán juntas, es decir, habrá retrocompatibilidad por un tiempo, para que pueda actualizar su desarrollo.

Los vendedores son invitados periódicamente a participar de diferentes campañas que se realizan en el sitio. La característica principal de este tipo de campañas es que se aplica un descuento cuando se alcanza una cierta cantidad de ítems de un producto. Por ejemplo, lleve 4 pague 3, 2x1 o segundo al 50%.
Además Mercado Libre se hace cargo de un porcentaje del descuento ofrecido.
Si el vendedor recibió una invitación y quiere participar, puedes hacerlo con los siguientes recursos.



Vista del vendedor






Consultar detalles de una campaña

Para obtener los detalles de una campaña con descuento por volumen,realiza la siguiente consulta:


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB1806017?promotion_type=VOLUME&app_version=v2

Respuesta:

{
  "id": "P-MLB1806017",
  "type": "VOLUME",
  "status": "started",
  "start_date": "2023-04-20T03:00:00Z",
  "finish_date": "2023-08-01T02:00:00Z",
  "deadline_date": "2023-08-01T01:00:00Z",
  "name": "Leva 3 paga 2",
  "benefits": {
      "type": "VOLUME",
      "meli_percent": 9.9999,
      "seller_percent": 23.3331,
      "name": "3x2",
      "buy_quantity": 3,
      "pay_quantity": 2,
      "item_discount_percent": 33.333
  }
}

Campos específicos de esta campaña

Benefits: detalle de los beneficios de la promoción.

  • type: tipo de beneficio.
  • meli_percent: porcentaje que aporta Mercado Libre.
  • seller_percent: porcentaje que aporta el vendedor.
  • name: nombre del rebate.
  • buy_quantity: cantidad requerida de ítems para acceder al descuento.
  • pay_quantity: cantidad de ítems que se abonan.
  • item_discount_percent: porcentaje de descuento sobre cada ítem.


  • Tipos de descuento

    Estos son los distintos tipos de descuento que existen en este tipo de campaña con sus variantes en cada una de ellas:

    • Lleva 4 paga 3
    • 70% OFF comprando 2
    • 70% OFF en la 2da unidad


    • Estados

      Estos son los distintos estados por los que puede pasar una campaña con descuento por volumen.

      Estado Descripción
      pending Promoción aprobada que aún no inició.
      started Promoción activa.
      finished Promoción finalizada.



      Consultar ítems en una campaña

      Para conocer los ítems candidatos y/o que forman parte de una campaña con descuento por volumen puedes realizar la siguiente consulta:


      Llamada:

      curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions//P-MLB1806017/items?promotion_type=VOLUME&app_version=v2

      Respuesta:

      {
        "results": [
            {
                "id": "MLB3500418540",
                "status": "candidate",
                "price": 1333.34,
                "original_price": 2000,
                "meli_percentage": 10,
                "seller_percentage": 23.3,
                "start_date": "2023-04-20T03:00:00Z",
                "end_date": "2023-08-01T02:00:00Z"
            }
        ],
        "paging": {
            "offset": 0,
            "limit": 50,
            "total": 1
        }
      }

      Al crearse una nueva campaña se seleccionan todos los ítems aplicables a la misma. El estado inicial (status) de los ítems es candidate y sin offer id asignado. Al momento que el vendedor incorpora un ítem a la campaña su status se modifica y se le asigna un offer_id único.



      Estado de los ítems

      En la siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.

      Estado Descripción
      candidate Ítem candidato para participar de la promoción.
      pending Ítem con promoción aprobada y programada.
      started Ítem activo en la campaña.
      finished Ítem eliminado de la campaña


      Indicar ítems para una campaña

      Nota:
      Vea que para indicar y eliminar esta campaña de un ítem, cambiamos el wording de deal_id a promotion_id.

      Una vez que has sido invitado a participar para este tipo de campaña, puedes indicar qué productos deseas incluir en la misma.

      Llamada:

      curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
      -d '{
         "promotion_id":"$PROMOTION_ID",
         "promotion_type":"$PROMOTION_TYPE"
      }' 
      https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

      Ejemplo:

      curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
      -d '{
         "promotion_id":"P-MLB379009",
         "promotion_type":"VOLUME"
      }'
      https://api.mercadolibre.com/seller-promotions/items/MLB1834747833&app_version=v2

      Respuesta:

      {
        "offer_id": "MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
        "price": 1800,
        "original_price": 2000
      }

      Parámetros

      promotion_id: identificación de la promoción.
      promotion_type: tipo de promoción (VOLUME).



      Modificando ítems

      Para modificar el precio de un ítem que se encuentra participando de una campaña con descuento por volumen se deben realizar los siguientes pasos, ya que no es posible modificar el precio directamente.

      • Eliminar el ítem de la campaña;
      • Modificar el precio del ítem como la sincronización de precio normal;
      • Incluir nuevamente el ítem dentro de la campaña.

      • Nota:
        Los ítems que participan de las campañas con descuento por volumen no tienen el precio fijo, por ende si un ítem está participando y aumenta su precio, saldrá automáticamente de la oferta y no lo podrás agregar nuevamente.
        - Te recomendamos validar si el ítem está participando de una campaña con descuento por volumen cuando realices una modificación del precio (manuales o automáticas).

        Eliminar ítems

        Con este recurso podrás eliminar la oferta del ítem.

        Llamada:

        curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&promotion_id=$PROMOTION_ID&offer_id=$OFFER_ID

        Ejemplo:

        curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=VOLUME&promotion_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8&app_version=v2'Í

        Respuesta: Status 200 OK


        Conoce más sobre Ofertas por cantidad.


        Siguiente: Descuento pre-acordado por ítem