Campañas tradicionales

Los vendedores que reciben asesoramiento por parte del equipo comercial de Mercado Libre son invitados periódicamente a participar de diferentes campañas de ofertas que se realizan en el sitio.
Si recibiste la invitación para alguna campaña puntual y quieres sumarte puedes hacerlo con los siguientes recursos.

Contenidos

→Consultar detalle de deal
↳Estados
→Consultar ítems en un deal
↳Estado de los ítems
→Indicar ítems para un deal
→Modificar ítems
→Eliminar ítems

Consultar detalle de deal

Para obtener los detalles de una oferta de tipo Deal, realiza la siguiente consulta:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=DEAL

Respuesta:

{
  "id": "MLA686",
  "type": "DEAL",
  "status": "started",
  "start_date": "2019-02-04T17:50:00Z",
  "finish_date": "2020-10-31T17:20:00Z",
  "deadline_date": "2020-09-30T02:00:00Z",
  "name": "HOTSALE"
}

Estados

Estos son los distintos estados por lo que puede pasar una campaña tradicional.

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

Consultar ítems en un deal

Para conocer los ítems que forman parte de una determinado deal puedes realizar la siguiente consulta:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686/items?promotion_type=DEAL

Respuesta:

{
  "results": [
    {
      "id": "MLA875050287",
      "status": "pending_approval",
      "price": 300,
      "original_price": 1000
    },
    {
      "id": "MLA876387768",
      "status": "pending_approval",
      "price": 900,
      "original_price": 1000
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 2
  }
}

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
approved	Ítem aprobado para la oferta.
pending_approval	Ítem pendiente de aprobación para la oferta.
rejected	Ítem rechazado para la oferta.

Indicar ítems para un deal

Una vez invitado a participar en una campaña de ofertas, puedes indicar qué productos deseas incluir en la misma.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
   "deal_id":"$DEAL_ID",
   "regular_price":$REGULAR_PRICE,
   "deal_price":$DEAL_PRICE,
   "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":"MLA1804",
   "regular_price":350,
   "deal_price":240,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Respuesta:

{
  "price": 240,
  "original_price": 350
}

Parámetros

deal_id: identificación de la promoción.
regular_price: precio del ítem antes de incluirse en la promoción.
deal_price: precio del ítem en la promoción.
promotion_type: tipo de promoción (DEAL.)

Modificar ítems

Para modificar los ítems que están participando de una oferta realiza el siguiente PUT:

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
   "deal_id":"$DEAL_ID",
   "regular_price":$REGULAR_PRICE,
   "deal_price":$DEAL_PRICE,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
   "deal_id":"MLA1804",
   "regular_price":350,
   "deal_price":220,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1676902612

Respuesta:

{
  "price": 220,
  "original_price": 350
}

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

Ejemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=DEAL&deal_id=1804

Respuesta: Status 200 OK