Administrar descuentos

Este recurso podrá ser utilizado por vendedores que tengan reputación verde para administrar los descuentos sobre sus ítems. En esta guía, aprenderás de manera fácil y rápida a desarrollar cómo aplicar, eliminar y consultar.

Importante:
En este momento, solo está disponible para vendedores de MLA, MLM y MLB.

Contenidos

→Aplicar descuento
    ↳Agregar descuento solo a usuarios nivel 3 al 6
    ↳Agregar descuento a los usuarios nivel 3 al 6 y a usuarios nivel 1 y 2
    ↳Agregar descuento solo a usuarios nivel 1 y 2
    ↳Agregar descuento a los usuarios nivel 1 y 2 y a usuarios nivel 3 al 6
       ↳Parámetros
       ↳Consideraciones
→Eliminar descuento
→Consultar descuento
→Posibles errores


Aplicar descuento

Antes de aplicar un descuento, debes tener en cuenta diferentes reglas según los niveles relacionado al nuevo programa de beneficios de Mercado Puntos de nuestra plataforma. Estos son:

  • Nivel 1: Inicial
  • Nivel 2: Aficionado
  • Nivel 3: Avanzado
  • Nivel 4: Profesional
  • Nivel 5: Experto
  • Nivel 6: Leyenda

Además, el ítem solo puede tener descuentos cuando tiene el siguiente tag loyalty_discount_eligible, el cual representa que cumple con todas las reglas mencionadas al final de esta documentación.

Importante:
Desde el 2 de diciembre de 2019, solo podrás poner los descuentos directamente en los niveles 1 y 2, y desde el 3 al 6 deberás incluir los niveles 1 y 2.

Antes, era posible poner los descuentos directamente en los niveles del 3 al 6 y para poner a los niveles 1 y 2 también había que incluir los niveles del 3 al 6. Es decir, no se podía poner descuentos solo para los niveles 1 y 2.

  • best_buyers_discount_percentage: mediante este atributo definimos que es para niveles 3 al 6.
  • uyers_discount_percentage: mediante este atributo definimos que es para niveles 1 y 2.

Para aplicar un descuento será necesario realizar un PUT tal como se muestra a continuación.


Agregar descuento solo a usuarios nivel 3 al 6

Llamada:

curl -X PUT "http://api.mercadolibre.com/items/{item_id}/marketplace_discounts?access_token=$ACCESS_TOKEN"

Ejemplo:

curl -X PUT "http://api.mercadolibre.com/items/MLB1105211403/marketplace_discounts?access_token=$ACCESS_TOKEN"
{
	"best_buyers_discount_percentage": 15
}

Respuesta:

{
    "price": 100,
    "original_price": null
}

Agregar descuento a los usuarios nivel 3 al 6 y a usuarios nivel 1 y 2

Llamada:

curl -X PUT "http://api.mercadolibre.com/items/{item_id}/marketplace_discounts?access_token=$ACCESS_TOKEN"

Ejemplo:

curl -X PUT "http://api.mercadolibre.com/items/MLB1105211403/marketplace_discounts?access_token=$ACCESS_TOKEN"
{
	"best_buyers_discount_percentage": 30,
	"buyers_discount_percentage": 20
}

Respuesta:

{
    "price": 80,
    "original_price": 100
}

Importante:
Desde el 2 de diciembre de 2019, para aplicar un descuento será necesario que realices un PUT como en los siguientes ejemplos:

Agregar descuento solo a usuarios nivel 1 y 2

Llamada:

curl -X PUT "http://api.mercadolibre.com/promo/item/{itemId}?access_token=$ACCESS_TOKEN"

Ejemplo:

curl -X PUT "http://api.mercadolibre.com/promo/item/MLB1105211403?access_token=$ACCESS_TOKEN"
{
	"best_buyers_discount_percentage" : null,
	"buyers_discount_percentage" : 	10,
	"start_date": "2019-07-09T00:00:00",
  	"finish_date": "2019-07-15T00:00:00",
	“discount_type:” “PRICE_DISCOUNT”
}

Respuesta:

{
   "price": 90.00,
   "original_price": 100.00
}

Agregar descuento a los usuarios nivel 1 y 2 y a usuarios nivel 3 al 6

Llamada:

curl -X PUT "http://api.mercadolibre.com/promo/item/{itemId}?access_token=$ACCESS_TOKEN""

Ejemplo:

{
   "id": "353-MLA822573619",
   "start_date": "2019-10-31T00:00:00",
   "finish_date": "2019-10-31T23:59:59",
   "seller_id": 468098195,
   "item_id": "MLA822573619",
   "price": 9000.0,
   "list_price": 10000.0,
   "prime_price": 8000.0,
   "status": "finished"
}

Respuesta:

{
    "price": 70,
    "original_price": 100
}

Parámetros

best_buyers_discount_percentage: mediante este atributo definimos los niveles del 3 al 6.
buyers_discount_percentage: mediante este atributo definimos los niveles 1 y 2.
start_date: fecha de inicio de la vigencia del descuento. (AAAA-MM-DDThh:mm:ss).
finish_date: fecha de fin de la vigencia del descuento. El plazo máximo de vigencia debe ser 60 días. (AAAA-MM-DDThh:mm:ss).
discount_type: tipo de descuento. Hoy está disponible PRICE_DISCOUNT.


Consideraciones

  • El "original_price" sólo es calculado con el nuevo valor cuando el descuento modifica el precio original, o sea, eso ocurre cuando se hace el descuento a los niveles 1 y 2. Si no se modifica el precio original, sólo será agregada la información de descuentos en sales_terms en la consulta de items.
  • Segmentar la oferta de descuentos estableciendo un porcentaje superior a nuestros compradores leales (nivel 3 al 6 de Mercado Puntos) y un porcentaje inferior al resto de los compradores (nivel 1 al 2 de Mercado Puntos).
  • Si el seller agrega un descuento ese item va a ser accesible desde la landing de marketplace de descuentos.
  • Una vez que modificamos el precio original del item, se borran los descuentos automaticamente.

Conoce más sobre cómo ofrecer descuentos.


Eliminar descuento

Con este recurso podrás eliminar todos descuentos del ítem pero no podrás realizarlo solo para algunos niveles de usuarios.


Llamada:

curl -X DELETE "http://api.mercadolibre.com/items/{item_id}/marketplace_discounts?access_token=$ACCESS_TOKEN"

Ejemplo:

curl -X DELETE "http://api.mercadolibre.com/items/MLB1105219833/marketplace_discounts?access_token=$ACCESS_TOKEN"

Respuesta:

{
    "price": 100,
    "original_price": null
}

Importante:
Desde el 2 día de diciembre de 2019, puedes hacerlo de la siguiente manera:

Llamada:

curl -X DELETE "http://api.mercadolibre.com/promo/item/{itemId}?access_token=$ACCESS_TOKEN"

Ejemplo:

curl -X DELETE "http://api.mercadolibre.com/promo/item/MLB1105219833?access_token=$ACCESS_TOKEN"

Respuesta:

La respuesta a este servicio es un status 200 sin body en el response.


Consultar descuento

Para ver o consultar el descuento de un ítem haz el GET en la API de descuentos.


Llamada:

curl -X GET http:/api.mercadolibre.com/items/{item_id}?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET http:/api.mercadolibre.com/items/MLB1060047839?access_token=$ACCESS_TOKEN

Respuesta:

{
  "id": "MLB1105219833",
  "site_id": "MLB",
  "title": "Teste - Não Ofertar",
  "subtitle": null,
  "seller_id": 356160424,
  "category_id": "MLB169588",
  "official_store_id": null,
  "price": 80,
  "base_price": 80,
  "original_price": 100,
  "currency_id": "BRL",
  "initial_quantity": 10,
  "available_quantity": 6,
  "sold_quantity": 4,
  "sale_terms": [
    {
      "id": "LOYALTY_LEVEL_6",
      "name": "Preço por ser nível 6 do loyalty",
      "value_id": null,
      "value_name": "70 BRL",
      "value_struct": {
        "number": 70,
        "unit": "BRL"
      }
    },
    {
      "id": "LOYALTY_LEVEL_4",
      "name": "Preço por ser nível 4 do loyalty",
      "value_id": null,
      "value_name": "70 BRL",
      "value_struct": {
        "number": 70,
        "unit": "BRL"
      }
    },
    {
      "id": "LOYALTY_LEVEL_3",
      "name": "Preço por ser nível 3 do loyalty",
      "value_id": null,
      "value_name": "70 BRL",
      "value_struct": {
        "number": 70,
        "unit": "BRL"
      }
    },
    {
      "id": "LOYALTY_LEVEL_5",
      "name": "Preço por ser nível 5 do loyalty",
      "value_id": null,
      "value_name": "70 BRL",
      "value_struct": {
        "number": 70,
        "unit": "BRL"
      }
    }
  ],
  "buying_mode": "buy_it_now",
  "listing_type_id": "gold_special",

Ten en cuenta que en los sales terms habrá más valores que no tienen que ver con los descuentos.


Importante:
Desde 2 el diciembre de 2019, debes ver o consultar los descuentos de los ítems de la siguiente manera:

Llamada:

curl -X GET http:/api.mercadolibre.com/promo/item/{itemId}?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET http:/api.mercadolibre.com/promo/item/MLA822573619?access_token=$ACCESS_TOKEN

Respuesta:

{

   "id": "353-MLA822573619",

   "start_date": "2019-10-31T00:00:00",

   "finish_date": "2019-10-31T23:59:59",

   "seller_id": 468098195,

   "item_id": "MLA822573619",

   "price": 9000.0,

   "list_price": 10000.0,

   "prime_price": 8000.0,

   "status": "finished"

}

Consideraciones

  • El item debe ser de un site en el que está encendido el feature. Código error failed_rules: EnabledSiteRule.
  • El descuento de nivel 1 y 2 debe ser como mínimo 5% menor al de usuarios 3 al 6, para descuentos de hasta 35%, para descuentos superiores la diferencia debe ser de minimo 10%. Es decir, le damos mejores descuentos a los niveles más altos. Código error failed_rules: PricePercentageDeltaRule.
  • El ítem del usuario debe tener al menos 3 ventas en los últimos 30 días y que las ventas se encuentren en cierto umbral de precio. Codigo error failed_rules: ItemPriceVsMaxSalesPriceRule y ItemMoreEqThanXSalesRule.
  • Los sellers habilitados son los de reputación verde y verdecitos. Código error failed_rules: UserReputationRule.
  • El descuento máximo debe ser menor a 80%. Código error failed_rules: MaximumDiscountPercentageRule.
  • Descuento mínimo de 5%. Código error failed_rules: ItemValidDiscountRule.
  • El item debe ser nuevo. Código error failed_rules: ItemConditionRule.
  • El ítem no puede estar en un deal. Código error failed_rules: ItemNotInDealRule.
  • El ítem debe tener al menos 5 reviews y el promedio de esos reviews tiene que ser >= 3. Código error failed_rules:ItemRatingRule.
  • El descuento aplica para ítems con precio mayor o igual a los establecidos a cada sitio. En caso de estar por debajo del rango se recibirá un error de API: ItemMinPriceRuleTask.

Posibles errores

Recuerda el ACCESS TOKEN inválido not_authorized y sin ACCESS TOKEN, internal_server_error. Además, evita errores frecuentes, como no informar:

  • El descuento en el campo buyers_discount_percentage: null_discount.
  • La fecha de inicio del descuento start_date: null_promo_start_date.
  • La fecha de fin del descuento finish_date: null_promo_finish_date.

Forma parte de nuestra comunidad