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, 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.

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