Administrar descuentos

El nuevo recurso /marketplace_discounts puede ser utilizado por todos los vendedores que cuenten con reputación en verde.
Con esta implementación podrán administrar descuentos de una forma fácil, rápida y sencilla.
Nota: en primera instancia, estará disponible para vendedores de MLA, MLM y MLB.


Contenidos

Aplicar descuento

Conoce más sobre cómo ofrecer descuentos.

Antes de aplicar un descuento deberás tener en cuenta que hay diferentes reglas de descuentos 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.
Es posible poner los descuentos directamente en los niveles del 3 al 6 y para poner a los niveles 1 y 2 también hay que incluir los niveles del 3 al 6. Es decir, no se puede poner descuentos solo para los niveles 1 y 2.
- best_buyers_discount_percentage: mediante este atributo definimos que es para niveles 3 al 6.
- buyers_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. Ejemplos: 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
}

Consideraciones

  • Todos los descuentos son válidos hasta 60 días después de la inserción. Para renovar el descuento, debes rehacer la operación.

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


Eliminar descuento

El recurso de eliminar, elimina todos los descuentos del item, no es posible eliminar sólo 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
}


Consultar descuento

Para ver el descuento de un item hay que hacer el GET en el recurso de Items y ahí será posible consultar los campos: price, original_price y sales_terms. Llamada:

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

Ejemplo:

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

Respuesta:

{
   "id": "MLA818527151",
   "site_id": "MLA",
   "title": "Item de Test - No ofertar!",
   "subtitle": null,
   "seller_id": 465432224,
   "category_id": "MLA90319",
   "official_store_id": 176,
   "price": 12599,
   "base_price": 12599,
   "original_price": 13999,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 2816,
   "available_quantity": 66,
   "sold_quantity": 2750,
   "sale_terms": [
       {
           "id": "LOYALTY_LEVEL_4",
           "name": "Precio por nivel 4 de loyalty",
           "value_id": null,
           "value_name": "11899 ARS",
           "value_struct": {
               "number": 11899,
               "unit": "ARS"
           },
           "values": [
               {
                   "id": null,
                   "name": "11899 ARS",
                   "struct": {
                       "number": 11899,
                       "unit": "ARS"
                   }
               }
           ]
       },
       {
           "id": "LOYALTY_LEVEL_6",
           "name": "Precio por nivel 6 de loyalty",
           "value_id": null,
           "value_name": "11899 ARS",
           "value_struct": {
               "number": 11899,
               "unit": "ARS"
           },
           "values": [
               {
                   "id": null,
                   "name": "11899 ARS",
                   "struct": {
                       "number": 11899,
                       "unit": "ARS"
                   }
               }
           ]
       },
       {
           "id": "LOYALTY_LEVEL_5",
           "name": "Precio por nivel 5 de loyalty",
           "value_id": null,
           "value_name": "11899 ARS",
           "value_struct": {
               "number": 11899,
               "unit": "ARS"
           },
           "values": [
               {
                   "id": null,
                   "name": "11899 ARS",
                   "struct": {
                       "number": 11899,
                       "unit": "ARS"
                   }
               }
           ]
       },
       {
           "id": "LOYALTY_LEVEL_3",
           "name": "Precio por nivel 3 de loyalty",
           "value_id": null,
           "value_name": "11899 ARS",
           "value_struct": {
               "number": 11899,
               "unit": "ARS"
           },
           "values": [
               {
                   "id": null,
                   "name": "11899 ARS",
                   "struct": {
                       "number": 11899,
                       "unit": "ARS"
                   }
               }
           ]
       }
   ],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro"
   {...}
}

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


Reglas

  • No se puede poner descuento solo a usuarios 1 y 2.

  • Para poner el descuento para los niveles 1 y 2 hay que poner también a los niveles 3 al 6 en el mismo PUT.

  • 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. Es decir, le damos mejores descuentos a los niveles más altos. Código error failed_rules: PricePercentageDeltaRule

  • El item del usuario debe tener al menos 3 ventas en los últimos 30 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 50%. 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 item no puede estar en un deal. Código error failed_rules: ItemNotInDealRule

  • El item 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

Forma parte de nuestra comunidad