Campañas co-fondeadas

Los vendedores son invitados periódicamente a participar de diferentes campañas de ofertas que se realizan en el sitio. La característica principal de este tipo de campañas es que Mercado Libre paga porcentaje del descuento ofrecido.
Si recibiste una invitación y quieres sumarte puedes hacerlo con los siguientes recursos.


Contenidos

→Consultar detalle de campaña co-fondeada
    ↳Estados
→Consultar ítems en una campaña co-fondeada
    ↳Estado de los ítems
→Indicar ítems para una campaña co-fondeada
→Modificar ítems
→Eliminar ítems



Consultar detalle de campaña co-fondeada

Para obtener los detalles de una oferta co-fondeada, realiza la siguiente consulta:

Llamada:

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

Respuesta:

{
  "id": "MLA686",
  "type": "MARKETPLACE_CAMPAIGN",
  "status": "started",
  "start_date": "2019-02-04T17:50:00Z",
  "finish_date": "2020-10-31T17:20:00Z",
  "deadline_date": "2020-09-30T02:00:00Z",
  "name": "P-MLA1252",
  "benefits": {
    "type": "REBATE",
    "meli_percent": 20,
    "seller_percent": 10
  }
}


Estados

Estos son los distintos estados por los que puede pasar una campaña co-fondeada.

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



Consultar ítems en una campaña co-fondeada

Para conocer los ítems candidatos y/o que forman parte de una campaña co-fondeada 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=MARKETPLACE_CAMPAIGN

Respuesta:

{
  "results": [
        {
            "id": "MLA877277006",
            "status": "ACTIVE",
            "price": 1349,
            "original_price": 1500,
            "offer_id": "MLA877277006-e2c63989-ad16-4ef3-9b6d-0c6da0ac40a5"
        },
        {
            "id": "MLA1767902544",
            "status": "",
            "price": 0,
            "original_price": 0
        }
    ],
    "paging": {
        "total": 2
    }
}

Al crearse una nueva campaña se seleccionan todos los ítems aplicables a la misma. El estado inicial de los ítems es con "status" vacío 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 las siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.

Estado Descripción
active Ítem con promoción activa.
programmed Ítem con promoción aprobada y programada.


Indicar ítems para una campaña co-fondeada

Una vez que has sido invitado a participar en una campaña co-fondeada, puedes indicar qué productos deseas incluir en la misma.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
   "deal_id":"$DEAL_ID",
   "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":"P-MLA147001",
   "promotion_type":"marketplace_campaign"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876618673

Respuesta:

{
  "offer_id": "MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
  "price": 1800,
  "original_price": 2000
}

Parámetros

deal_id: identificación de la promoción.
promotion_type: tipo de promoción (MARKETPLACE_CAMPAIGN).



Modificando ítems

Para modificar el precio de un ítem que se encuentra participando de una campaña co-fondeada se deben realizar los siguientes pasos, ya que no es posible modificar el precio directamente.


Pasos:

  • Eliminar el ítem de la campaña
  • Modificar el precio del ítem como la sincronización de precio normal
  • Incluir nuevamente el ítem dentro de la campaña

  • Nota:
    Los ítems que participan de las ofertas co-fondeadas (Marketplace Campaign) no tienen el precio fijo, por ende si un ítem está participando y aumenta su precio, saldrá automáticamente de la oferta y no lo podrás agregar nuevamente.
    - Te recomendamos validar si el ítem está participando de una campaña co-fondeada cuando realices una modificación del precio (manuales o automáticas).


    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&offer_id=$OFFER_ID

    Ejemplo:

    curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=MARKETPLACE_CAMPAIGN&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8

    Respuesta: Status 200 OK



o regístrate para recibir las últimas novedades sobre nuestra API