Campañas co-fondeada automatizada y campañas de precios competitivos

Los vendedores son invitados periódicamente a participar de diferentes campañas que se realizan en el sitio. En el caso de las campañas co-fondeada automatizada y precios competitivos, Mercado Libre paga un porcentaje del descuento ofrecido.
Las campañas co-fondeadas automatizadas son similares a las co-fondeadas ya existentes, pero utilizan un proceso automatizado para definir los ítems que serán invitados a participar del descuento. Por otro lado, las campañas de precios competitivos buscan alcanzar el mejor precio frente a otros sitios web y marketplaces, y los candidatos se regeneran todos los días, por lo cual un ítem puede ser candidato a este tipo de campaña hoy y mañana no.
Si el vendedor recibió una invitación y quiere sumarse, puede hacerlo con los siguientes recursos.

Consultar detalle de campaña

Para obtener los detalles de una promoción, realiza la siguiente consulta:

Ejemplo de co-fondeada automatizada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB1812010?promotion_type=SMART&app_version=v2

Respuesta de co-fondeada automatizada:

{
  "id": "P-MLB1812010",
  "type": "SMART",
  "status": "started",
  "start_date": "2023-04-26T23:00:00Z",
  "finish_date": "2023-05-10T23:59:00Z",
  "deadline_date": "2023-05-10T23:59:00Z",
  "name": "test-smart-2"
}

Ejemplo de precios competitivos:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB2087012?promotion_type=PRICE_MATCHING&app_version=v2

Respuesta de precios competitivos:

{
  "id": "P-MLB2087012",
  "type": "PRICE_MATCHING",
  "status": "pending",
  "start_date": "2023-09-19T18:15:00Z",
  "finish_date": "2023-10-01T05:59:59Z",
  "deadline_date": "2023-10-01T05:59:59Z",
  "name": "Gánale a la competencia con un aporte de Mercado Libre"
}

Campos de la respuesta

• id: identificador de la campaña.
• type: tipo de campaña (SMART, PRICE_MATCHING).
• status: status de la campaña.
• start_date: fecha que empieza la campaña.
• finish_date: fecha que se cierra la campaña.
• deadline_date: fecha límite para crear la campaña.
• name: nombre de la campaña.

Estados

Estos son los distintos estados por los que puede pasar en las campañas co-fondeada automatizada y precios competitivos.

Consultar ítems en una campaña

Para conocer los ítems que forman parte de una campaña puedes realizar la siguiente consulta:

Ejemplo de co-fondeada automatizada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/P-MLB1812010/items?promotion_type=SMART&app_version=v2'

Respuesta de co-fondeada automatizada:

{
  "results": [
      {
          "id": "MLB3538191898",
          "status": "candidate",
          "price": 3000,
          "original_price": 5000,
          "offer_id": "CANDIDATE-MLB3538191898-25593903",
          "meli_percentage": 20,
          "seller_percentage": 20,
          "start_date": "2023-04-26T11:40:00Z",
          "end_date": "2023-05-30T15:47:00Z"
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 50,
      "total": 1
  }
}

Ejemplo de precios competitivos:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/P-MLB2087012/items?promotion_type=PRICE_MATCHING&app_version=v2'

Respuesta de precios competitivos:

{
   "results": [
       {
           "id": "MLB4048719074",
           "status": "candidate",
           "price": 3000,
           "original_price": 5000,
           "offer_id": "CANDIDATE-MLB4048719074-70000001705",
           "meli_percentage": 20,
           "seller_percentage": 20,
           "start_date": "2023-09-19T03:00:00Z",
           "end_date": "2023-09-26T02:59:59Z"
       }
   ],
   "paging": {
       "total": 1,
       "limit": 50
   }
}

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 estos tipos de campañas.

Indicar ítems para una campaña

Una vez que has sido invitado a participar en una de estas campañas, puedes indicar qué productos deseas incluir en las mismas.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -d '{
     "promotion_id":"$PROMOTIONDEAL_ID",
     "promotion_type":"$PROMOTION_TYPE",
     "offer_id":"$OFFER_ID"
  }'
  https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Ejemplo de co-fondeada automatizada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -d '{
    "promotion_id":"P-MLB1812010",
    "promotion_type":"SMART",
    "offer_id":"CANDIDATE-MLB3538191898-25593903"
  }
  '
  https://api.mercadolibre.com/seller-promotions/items/MLB3538191898?app_version=v2

Respuesta de co-fondeada automatizada:

{
  "offer_id": "OFFER-MLB3538191898-177685",
  "price": 3000,
  "original_price": 5000
}

Ejemplo de precios competitivos:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -d '{
     "promotion_id": "P-MLB2087012",
     "offer_id": "CANDIDATE-MLB4048719074-70000001705",
     "promotion_type": "PRICE_MATCHING"
  }
  '
  https://api.mercadolibre.com/seller-promotions/items/MLB4048719074?app_version=v2

Respuesta de precios competitivos:

{
    "offer_id": "OFFER-MLB4048719074-10000001972",
    "price": 3000,
    "original_price": 5000
 }
 
 

Parámetros

• promotion_id: identificación de la promoción.
• promotion_type: tipo de promoción (SMART o PRICE_MATCHING).
• offer_id: identificación de la oferta acordada.

Eliminar campaña

Llamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&promotiondeal_id=$PROMOTION&offer_id=$OFFER_ID'

Ejemplo de co-fondeada automatizada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB3538191898?promotion_type=SMART&promotion_id=P-MLB1812010&offer_id=OFFER-MLB3538191898-177685&app_version=v2

Respuesta: Status 200 OK

Ejemplo de precios competitivos:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB4048719074?promotion_type=PRICE_MATCHING&promotion_id=P-MLB2087012&offer_id=OFFER-MLB4048719074-10000001972&app_version=v2

Respuesta: Status 200 OK