Gestionar ofertas

Con el recurso /seller-promotions podes centralizar todos los tipos de oferta disponibles como Campañas tradicionales (DEALS), Descuentos individuales (PRICE DISCOUNT), campañas co-fondeadas por Mercado Libre (MARKETPLACE CAMPAIGN). Además de los nuevos tipos de ofertas que disponibilicemos.


Contenidos

→Consultar las ofertas disponibles para el vendedor
→Consultar detalles de la oferta
    ↳Estado de la oferta
→Consultar ítems de la oferta
→Participar en una oferta
→Consultar ofertas del ítem
→Modificar ítems en una oferta
→Eliminar ítems en una oferta
→Asignar campaña de prueba



Consultar las ofertas disponibles para el vendedor

Recuerda que un usuario puede tener más de una invitación y de diferentes tipos..

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/$USER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/631366846

Respuesta:

{
"results": [
    {
      "id": "MLA686",
      "type": "DEAL",
      "status": "started",
      "start_date": "2019-02-04T17:50:00Z",
      "finish_date": "2020-10-31T17:20:00Z",
      "deadline_date": "2020-09-29T22:00:00Z",
      "name": "HOTSALE"
    },
    {
      "id": "P-MLA119001",
      "type": "MARKETPLACE_CAMPAIGN",
      "status": "started",
      "start_date": "2020-10-15T18:37:40.881Z",
      "finish_date": "2020-12-30T18:37:40.881Z",
      "deadline_date": "2020-12-29T22:00:00Z",
      "name": "P-MLA1252"
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 2
  }
}

Campos de la respuesta

id: código de identificación de la oferta.
type: tipo de la oferta (DEAL, MARKETPLACE_CAMPAIGN).
status: estado de campaña tradicional, estado de campaña co-fondeada.
start_date: fecha de inicio de la oferta.
finish_date: fecha de fin de la oferta.
deadline_date: plazo máximo para aceptar la invitación.
name: nombre de la oferta.



Consultar detalles de la oferta

Realiza la siguiente consulta con el parámetro promotion_type (DEAL o MARKETPLACE_CAMPAIGN).

Llamada:

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

Conoce más detalles sobre campaña tradicional y campaña co-fondeada (marketplace campaign).


Estado de la oferta

A continuación puedes encontrar los posibles estados que pueden tener los distintos tipos de oferta: estados de campaña tradicional y estado de una campaña co-fondeada .


Consultar ítems de la oferta

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

Llamada:

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

Además, puedes consultar ítems de una campaña tradicional e ítems de una campaña co-fondeada .



Participar de una oferta

Puedes participar en distintos tipos de campañas y ofrecer un descuento individual para los ítems:

Consultar ofertas del ítem

Para ofertas de tipo DEALS solo devolveremos los ítems con estado aprobado (status=approved).
No aprobaremos campañas con ítems test, es decir, quedarán con estado pending_approval y no mostraremos el precio con oferta.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Respuesta:

[
  {
    "id": "2864-MLA876768946",
    "type": "PRICE_DISCOUNT",
    "status": "started",
    "price": 680,
    "top_price": 570,
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLA686",
    "type": "DEAL",
    "status": "started",
    "price": 680,
    "start_date": "2019-02-04T17:50:00Z",
    "finish_date": "2020-10-31T17:20:00Z",
    "deadline_date": "2020-09-30T02:00:00Z",
    "name": "Super deal"
  },
  {
    "id": "P-MLA119001",
    "type": "MARKETPLACE_CAMPAIGN",
    "status": "started",
    "start_date": "2020-10-15T18:37:40.881Z",
    "finish_date": "2020-12-30T18:37:40.881Z",
    "name": "P-MLA1252"
  }
]

Modificar ítems en una oferta

Puedes modificar los ítems que están participando en una determinada oferta:

Nota:
Para editar los descuentos individuales (PRICE DISCOUNT) debes eliminarlos y darlos de alta nuevamente.


Eliminar ítems en una oferta

Puedes eliminar los ítems que están participando en una determinada oferta:


Asignar campaña de prueba

Para realizar pruebas con campañas de test, envíanos los datos de tu usuario y/o ítems en el siguiente formulario.
Recuerda que tanto los usuarios como los ítems deben ser de test.


Nota:
Debes agregar el parámetro version=test dentro de las llamadas para interactuar con estas campañas.

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