Ofertas

Los vendedores que reciben asesoramiento por parte del equipo comercial de Mercado Libre son invitados periódicamente a participar de diferentes campañas de ofertas que se realizan en el sitio. Si recibiste la invitación para alguna campaña puntual y quieres sumarte, sigue este tutorial para conocer los pasos básicos de cómo sugerir tus productos en oferta.

Contenidos:

Importante:

    • Para poder realizar pruebas, deberás utilizar un usuario de test. Esto te garantizará que siempre tengas una oferta (campaña) disponible para los artículos sugeridos. En test nunca se llegarán a aprobar las campañas para un ítem, quedarán en estado pending_approval, es decir, no se mostrará el precio con oferta.
    • Para acceder a esta API, necesitarás una access token.

Consultar las campañas a las que has sido invitado

Este recurso invoca las campañas de ofertas asociadas a un user_id [id de usuario]. Puede existir más de una campaña por usuario.

Ejemplo:

curl -X GET https://api.mercadolibre.com/users/{User_id}/deals/search?access_token=$ACCESS_TOKEN

Respuesta:

{
  "paging": {
    "total": 2,
    "offset": 0,
    "limit": 0
  },
  "filters": {
    "site_id": "MLA"
  },
  "results": [
    {
      "id": "MLA90",
      "name": "pruebaIntegracion",
      "description": "Prueba Integracion",
      "site_id": "MLA",
      "status": "test",
      "offers_reception_deadline": "2016-08-30T23:00:00-04:00",
      "start_time": "2016-08-18T03:00:00.000Z",
      "end_time": "2016-08-19T02:59:00.000Z",
      "requisites": [
        {
          "name": "RequisiteDiscount",
          "criteria": "original_price",
          "categories": [
            "MLA1144"
          ],
          "parameters": {
            "value": "20",
            "type": "gold_special"
          },
          "description": "Items with listing gold_special type must have at least 20% off"
        },
        {
          "name": "RequisiteDiscount",
          "criteria": "original_price",
          "categories": [
            "MLA1144"
          ],
          "parameters": {
            "value": "15",
            "type": "gold_premium"
          },
          "description": "Items with listing type gold_premium must have at least 15% off"
        },
        {
          "name": "CATEGORIES_REQUISITE",
          "criteria": "NA",
          "categories": [
            "MLA5726",
            "MLA1276",
            "MLA1384"
          ],
          "parameters": {
          },
          "description": "Items must belong to the specified categories"
        },
        {
          "name": "RequisiteFreeShipping",
          "criteria": "retail_price",
          "categories": [
            "MLA5725"
          ],
          "parameters": {
            "currency": "ARS",
            "value": "500"
          },
          "description": "Items in the specified categories and with price higher than ARS 500 must have free shipping"
        }
      ]
    }
  ]
}

Un campo importante a tener en cuenta en esta respuesta es el campo “dead_line” [”plazo”], que indica hasta cuándo podrás sugerir tus productos. Una vez transcurrido ese plazo, no podrás sugerir artículos para la campaña.
El campo “requisites” [”requisitos”] contiene un conjunto de requisitos que tus artículos sugeridos deben cumplir para poder ser incluidos en la campaña. Estos requisitos son definidos por Mercado Libre para cada campaña.

Sugerir un producto para la campaña

Una vez que has sido invitado a una campaña de ofertas, puedes seleccionar qué productos deseas incluir en la campaña y sugerirlos. Es posible que tengas que detallar las condiciones en las que tus productos participarán de la campaña (es decir, precio de descuento para la campaña, stock para la campaña, etc.).
Los items que propongas, tienen un status asociado. En un comienzo, este status es “pending_approval”. Cuando el equipo comercial válida la oferta, puede ser rechazado y el status pasa a “rejected” (el ítem no entra al deal) o puede ser aprobado (el ítem va a entrar al deal).

Solicitud (ejemplo):

curl -X POST -d '{"item_id":"MLA632979587","deal_price":149,"regular_price":200,"declared_stock":8,"declared_free_shipping":true, "brand":"brand1","model":"model1","declared_oro_premium_full":true}' 'https://api.mercadolibre.com/users/{User_id}/deals/{Deal_id}/proposed_items?access_token=$ACCESS_TOKEN'

Respuesta (ejemplo):

{
  "item_id": "MLA633000763",
  "regular_price": 200,
  "deal_price": 149,
  "declared_stock": 8,
  "declared_free_shipping": true,
  "declared_oro_premium_full": true,
  "category_l1": "MLA1953",
  "category_l2": "MLA3530",
  "brand": "brand1",
  "model": "model1",
  "date_created": "2016-08-29T14:08:10.902-04:00",
  "last_updated": "2016-08-29T14:08:10.902-04:00",
  "status": "pending_approval",
  "title": "Item De Testeo, Por Favor No Ofertar --kc:off"
}

Modificar un producto sugerido para una campaña

Solicitud:

curl -X PUT -d '{"deal_price":150}' 'https://api.mercadolibre.com/users/{User_id}/deals/{Deal_id}/proposed_items/{Item_id}?access_token=$ACCESS_TOKEN'

Respuesta (ejemplo):

{
  "item_id": "MLA633000763",
  "regular_price": 200,
  "deal_price": 152,
  "declared_stock": 8,
  "declared_free_shipping": true,
  "declared_oro_premium_full": true,
  "category_l1": "MLA1953",
  "category_l2": "MLA3530",
  "brand": "brand1",
  "model": "model1",
  "date_created": "2016-08-29T14:08:11.000-04:00",
  "last_updated": "2016-08-29T14:34:53.662-04:00",
  "status": "pending_approval",
  "title": "Item De Testeo, Por Favor No Ofertar --kc:off"
}

Eliminar un producto propuesto para una campaña

Solicitud:

curl -X DELETE https://api.mercadolibre.com/users/{User_id}/deals/{Deal_id}/proposed_items/{Item_id}?access_token=$ACCESS_TOKEN

Respuesta:

{O
"item_id": "MLA632979587",
"current_price": null,
"regular_price": 200,
"deal_price": 170,
"declared_stock": 8,
"declared_free_shipping": true,
"declared_oro_premium_full": true,
"category_l1": "MLA1953",
"category_l2": "MLA3530",
"brand": "brand1",
"model": "model1",
"date_created": "2016-08-29T11:52:01.000-04:00",
"last_updated": "2017-08-03T16:15:32.344-04:00",
"status": "rejected",
"title": "Item De Testeo, Por Favor No Ofertar --kc:off",
"processed_by": "$user_id",
"source": "public_api",
"discount": 26,
"rejections": [
{
"comment": null,
"requisite_rejection": null,
"reason": [
"El seller quitó al item del deal"
]
}
]
}

La status HTTP de la respuesta es 200.
Nota: Ten en cuenta que para modificar/eliminar un items se podrán realizar antes de que se cumpla el plazo que figura en offers_reception_deadline. Luego de esta fecha se podrá hacer únicamente a través de su asesor comercial (Ver ejemplo Consultar las campañas a las que has sido invitado).

Obtener productos propuestos para una campaña

Podrás obtener los productos que has sugerido para una campaña.

Solicitud:

curl -X GET https://api.mercadolibre.com/users/{User_id}/deals/{Deal_id}/proposed_items/search?access_token=$ACCESS_TOKEN

Respuesta:

{
  "paging": {
    "total": 2,
    "offset": 0,
    "limit": 50
  },
  "filters": {
    "deal_id": "MLA90",
    "seller_id": "210456151"
  },
  "results": [
    {
      "item_id": "MLA632979587",
      "current_price": 170,
      "regular_price": 200,
      "deal_price": 149,
      "declared_stock": 8,
      "declared_free_shipping": true,
      "declared_oro_premium_full": true,
      "category_l1": "MLA1953",
      "category_l2": "MLA3530",
      "brand": "brand1",
      "model": "model1",
      "date_created": "2016-08-29T11:52:01.000-04:00",
      "last_updated": "2016-08-29T11:52:01.000-04:00",
      "status": "pending_approval",
      "title": "Item De Testeo, Por Favor No Ofertar --kc:off",
      "discount": 26
    },
    {
      "item_id": "MLA632632625",
      "current_price": 200,
      "regular_price": null,
      "deal_price": 100,
      "declared_stock": 50,
      "declared_free_shipping": false,
      "declared_oro_premium_full": false,
      "category_l1": "MLA1953",
      "category_l2": "MLA3530",
      "brand": "Prueba",
      "model": "Cool",
      "date_created": "2016-08-26T10:34:04.000-04:00",
      "last_updated": "2016-08-26T10:34:04.000-04:00",
      "status": "pending_approval",
      "title": "Item De Testeo, Por Favor No Ofertar --kc:off",
      "discount": 50
    }
  ]
}

Please rate this