Última actualización 28/12/2022

Campañas co-fondeadas

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




Consultar detalles 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
  }
}

Campos específicos de esta campaña


Benefits: Detalle de los beneficios de la promoción.

  • type: el vendedor no podrá enviar mensajes al comprador.
  • meli_percent: porcentaje que aporta Mercado Libre.
  • seller_percent: porcentaje que aporta el vendedor.


  • Estados

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

    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 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": "CANDIDATE",
                "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 (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 las siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.

    Estado Descripción
    candidate Ítem candidato para participar de la promoción.
    pending Ítem con promoción aprobada y programada.
    started Ítem activo en la campaña.
    finished Ítem eliminado de la campaña


    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-MLB379009",
       "promotion_type":"MARKETPLACE_CAMPAIGN"
    }'
    https://api.mercadolibre.com/seller-promotions/items/MLB1834747833

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



    Modificar í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


      Conoce más sobre Campañas co-fondeadas.


      Next post: Campañas con descuento por volumen