Campañas con descuento por volumen

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” o “2x1” o “segundo al 50%”.
Además Mercado Libre se hace cargo de un porcentaje del descuento ofrecido. Si recibiste una invitación y quieres sumarte puedes hacerlo con los siguientes recursos.


Vista del vendedor




Contenidos

→Consultar detalles de una campaña con descuento por volumen
    ↳Tipos de descuento
    ↳Estados
→Consultar ítems en una campaña con descuento por volumen
    ↳Estado de los ítems
→Indicar ítems para una campaña con descuento por volumen
→Modificar ítems
→Eliminar ítems



Consultar detalles de una campaña con descuento por volumen

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-MLB379009?promotion_type=VOLUME

Respuesta:

{
   "id": "P-MLB379009",
   "type": "VOLUME",
   "status": "started",
   "start_date": "2021-03-25T16:40:00Z",
   "finish_date": "2021-04-30T18:00:00Z",
   "deadline_date": "2021-04-30T18:00:00Z",
   "name": "test volume MLB",
   "benefits": {
       "type": "VOLUME",
       "meli_percent": 8,
       "seller_percent": 17,
       "name": "4x3",
       "buy_quantity": 4,
       "pay_quantity": 3,
       "item_discount_percent": 25
   }
}

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 con descuento por volumen

      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-MLB379009/items?promotion_type=VOLUME

      Respuesta:

      {
          "results": [
              {
                 "id": "MLB1834747833",
                 "status": "candidate",
                 "price": 0,
                 "original_price": 0
             },
             {
                 "id": "MLB1834747833",
                 "status": "active",
                 "price": 3750,
                 "original_price": 5000,
                 "offer_id": "MLB1834747833-47a4b043-adb6-4e29-93b7-b36880013fef"
             }
          ],
          "paging": {
              "total": 2
          }
      }

      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 las 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.
      programmed Ítem con promoción aprobada y programada.
      active Ítem activo en la campaña.


      Indicar ítems para una campaña con descuento por volumen

      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 '{
         "deal_id":"$DEAL_ID",
         "promotion_type":"$PROMOTION_TYPE"
      }' 
      https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

      Ejemplo:

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

      Respuesta:

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

      Parámetros

      deal_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&deal_id=$DEAL_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&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8

        Respuesta: Status 200 OK


        Conoce más sobre Ofertas por cantidad.


        Next post: Descuento pre-acordado por ítem

    o regístrate para recibir las últimas novedades sobre nuestra API