Campañas tradicionales

Contenidos

→Consultar detalle de una campaña tradicional
    ↳Estados
→Consultar ítems en una campaña tradicional
    ↳Estado de los ítems
→Filtrar por ítems y estado
→Indicar ítems para una campaña tradicional
→Modificar ítems
→Eliminar ítems

Consultar detalle de una campaña tradicional

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",
  "categories": [
       "MLA1182",
       "MLA3937",
       "MLA1459"
   ]
}

El detalle de cada campo de la respuesta lo puedes encontrar en gestionar promociones .

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 una campaña tradicional

Para conocer los ítems que forman parte de una campaña tradicional 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.

Filtrar por ítems y estado

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=DEAL&status=$STATUS&item_id=$ITEM_ID

Ejemplo de filtro por ítem:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&item_id=MLA604400000

Respuesta:

{
   "results": [
       {
           "id": "MLA604400000",
           "status": "rejected",
           "price": 23968,
           "original_price": 28549
       }
   ],
   "paging": {...}
}

Ejemplo de filtro por status approved:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&status=approved

Respuesta:

{
   "results": [
       {
            "id": "MLA639970000",
            "status": "approved",
            "price": 4037,
            "original_price": 4427
        },
        {
            "id": "MLA639973333",
            "status": "approved",
            "price": 6007,
            "original_price": 6587
        },
],
   "paging": [...]
}

Indicar ítems para una campaña tradicional

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 en una promoción realiza la siguiente operación:

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

Next post: Campañas co-fondeadas