Gestionar ofertas

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

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
→Modificar ítems en una oferta
→Eliminar ítems en una oferta
→Consultar ofertas del ítem
→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:00-04:00",
      "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:00-04:00",
      "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 del deal, estado de campaña co-fondeada.
start_date: fecha de inicio de la oferta.
finish_date: fecha de fin de la oferta.
start_date: fecha de inicio de la oferta.
deadline_date: plazo máximo para aceptar la invitación.
name: nombre de la campaña.

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 oferta tradicional y oferta 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 un deal 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 en un deal 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:

Modificar ítems en una oferta 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:

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",
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLA686",
    "type": "DEAL",
    "status": "approved",
    "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"
  }
]

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.