• API Docs
  • Guía para Mercado Shops
  • Campañas con cuotas sin interés
Última actualización 10/11/2022

Publicaciones con campañas de cuotas sin interes

Actualmente, contamos con nuevas campañas de cuotas sin interés para el canal Mshops:

  • 3 cuotas sin interés: en publicaciones Premium podrás elegir ofrecer 3 cuotas sin interés y pagar menos de cargo por venta en tu tienda de Mercado Shops*. En Argentina pagarás 12,40% + IVA , en México 6,95% y en Brasil 5,99%. Así, podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_3x_campaign. Si tienes publicaciones Clásicas, convertilas a Premium y aprovecha este beneficio. Esta campaña estará disponible para todos los vendedores.
  • Ahora 6: en publicaciones Premium de Argentina elegibles para participar de Ahora 6, podrás elegir el cargo por venta de 17,50% + IVA*. Así, van a poder comprarte en 6 cuotas sin interés y podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_ahora-6. Si tienes publicaciones Clásicas, convertí a Premium y aprovecha este beneficio.
  • Ahora 12: En publicaciones Premium de Argentina elegibles para participar de Ahora 12, podrás elegir el cargo por venta de 28,30% + IVA*. Así, van a poder comprarte en 12 cuotas sin interés. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_ahora-12.
  • Ahora 24: En publicaciones Premium de Argentina elegibles para participar de Ahora 24, podrás elegir el cargo de 46,20% + IVA*. Así, van a poder comprarte en 24 cuotas sin interés. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_ahora-24.

*Las campañas aplican exclusivamente a ventas en el canal de Mshops.

Reconocer si un usuario está habilitado para sumarse a la campaña

Realizar un GET al recurso /special_installments/mshops_ahora-6 (campaña Ahora-6 o mshops_ahora-12 y mshops_ahora-24) según corresponda, con el $SELLER_ID.
En caso de que el usuario pueda participar, se mostrará la fecha en la que fue habilitado.

Nota:
Para las campañas de “mshops_3x_campaign” no aplica, ya que todos los sellers pueden participar sin limitaciones.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/mshops_ahora-12/sellers/$SELLER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/special_installments/mshops_ahora-12/sellers/1234

Respuesta:

{
   "date_created":"2019-08-30T16:09:10.941-04:00",
   "seller_id":1234
}

Si el usuario no tiene permitido ofrecer hasta 24 cuotas, el resultado de la anterior consulta es el siguiente:

{
   "message": "seller does not exist",
   "error": "seller.not_found",
   "status": 404,
   "cause": []
}

Conocer si una publicación está en la campaña

Para consultar si un producto tiene habilitado algunas de las campañas posibles de 3 cuotas sin interés o 6, 12 y 24 cuotas sin interés, realiza un GET al recurso /ítems con su item_id y verifica que tenga el tag “mshops_3x_campaign”, “mshops_ahora-6”, “mshops_ahora-12” o "mshops_ahora-24" dentro de los campos.


Llamada:

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

Ejemplo:

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

Respuesta:


{
    "id": "MLA1234123456",
    "site_id": "MLA",
    "title": "Procesador De Alimentos",
    "subtitle": null,
    "seller_id": 553421365,
    "category_id": "MLA3530",
    "official_store_id": null,
    "price": 34345345,
    "base_price": 34345345,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1000,
    "available_quantity": 500,
    "sold_quantity": 150,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantía",
            "value_id": "6150835",
            "value_name": "Sin garantía",
            "value_struct": null,
            "values": [
                {
                    "id": "6150835",
                    "name": "Sin garantía",
                    "struct": null
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2022-05-16T16:54:20.000Z",
    "stop_time": "2042-05-11T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1137574968-procesador-de-alimentos-_JM",
    "thumbnail_id": "979379-MLA45885016540_052021",
    "thumbnail": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
    "pictures": [
        {
            "id": "979379-MLA45885016540_052021",
            "url": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
            "secure_url": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
            "size": "385x500",
            "max_size": "459x596",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "name": "CABA"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "search_location": {
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        },
        "id": 1098928639
    },
    "seller_contact": null,
    "location": {},
    "coverage_areas": [],
    "attributes": [
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "276243",
            "value_name": "Genérica",
            "value_struct": null,
            "values": [
                {
                    "id": "276243",
                    "name": "Genérica",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Nuevo",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [
        "good_quality_picture",
        "standard_price_by_channel",
        "test_item",
        "immediate_payment",
        "mshops_ahora-12"
    ],
    "warranty": "Sin garantía",
    "catalog_product_id": null,
    "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2022-05-16T16:54:20.000Z",
    "last_updated": "2022-07-12T15:17:19.561Z",
    "health": 0.8,
    "catalog_listing": false,
    "channels": [
        "marketplace",
        "mshops"
    ]

Crear una publicación en una campaña

Para crear un ítem dentro de una campaña, debes realizar el POST al recurso /items incluyendo el tag “mshops_3x_campaign”, “mshops_ahora-6”, “mshops_ahora-12” o "mshops_ahora-24". Ten en cuenta de siempre enviar el atributo buying_mode ya que es requerido en el POST para crear un ítem.
Los ítems habilitados para ofrecer hasta 24 cuotas con la participación del programa Ahora deben ser productos nuevos y su publicación ser "Premium", es decir, solo aquellas con listing_type_id = gold_pro.


Lhamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items
{
    "title": "Item de testeo por favor no ofertar kc:off",
    "pictures": [
        ..
    ],
    "price": 53936,
    "variations": [],
    "shipping": {
        ..
    },
    "currency_id": "ARS",
    "location": {},
    "attributes": [
        ...
    ],
    "listing_type_id": "gold_pro",
    "available_quantity": 543,
    "category_id": "MLA1611",
    "condition": "new",
    "buying_mode": "buy_it_now",
    "tags": [
        "mshops_ahora-12"       
    ]
     ...
}

Respuesta:

{
   "id": "MLA810693730",
   "site_id": "MLA",
   "title": "Item De Test - No Ofertar",
   "subtitle": null,
   "seller_id": 443024908,
   "category_id": "MLA3530",
   "official_store_id": null,
   "price": 100,
   "base_price": 100,
   "original_price": null,
   "inventory_id": null,
   "currency_id": "ARS",
   "initial_quantity": 1,
   "available_quantity": 1,
   "sold_quantity": 0,
   "sale_terms": [],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2019-08-22T17:33:51.000Z",
   "stop_time": "2039-08-17T04:00:00.000Z",
   "end_time": "2039-08-17T04:00:00.000Z",
   "expiration_time": "2019-11-10T17:33:51.000Z",
   "condition": "new",
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "international_delivery_mode": "none",
   "seller_contact": null,
   "location": {},
   "geolocation": {
       "latitude": -34.5780655,
       "longitude": -58.4265317
   },
   "coverage_areas": [],
   "warnings": [],
   "listing_source": "",
   "variations": [],
   "status": "active",
   "sub_status": [],
   "tags": [
       "mshops_ahora-12",
    "immediate_payment",
       "test_item"
   ],
   "warranty": null,
   "catalog_product_id": null,
   "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
   "seller_custom_field": null,
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2019-08-22T17:33:51.000Z",
   "last_updated": "2019-08-22T18:37:41.468Z",
   "health": null,
   "catalog_listing": false,
   "item_relations": []
}

Recuerda que retornaremos un http error 400 siempre que no cumplas los requisitos o en los casos que:

  • El vendedor no esté habilitado para participar de la campaña.
  • El ítem sea usado o reacondicionado.
  • La exposición de la publicación sea distinta a Premium.
  • Habilitar una campaña en una publicación

    Para habilitar la campaña en un ítem, debes realizar un PUT al recurso /items incluyendo el “mshops_3x_campaign”, “mshops_ahora-6”, “mshops_ahora-12” o "mshops_ahora-24". Ten en cuenta que si el ítem contiene otros tags, también deberán ser enviados en la modificación.
    Los ítems habilitados para ofrecer hasta 24 cuotas con la participación del programa "Ahora" deben ser productos nuevos y su publicación ser "Premium", es decir, solo aquellas con listing_type_id = gold_pro.


    Llamada:

    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
       "tags":[
          "mshops_ahora-12",
          "immediate_payment",
          "test_item"
       ]
    }
    https://api.mercadolibre.com/items/$ITEM_ID

    Exemplo:

    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
       "tags":[
          "mshops_ahora-12"
       ]
    }
    https://api.mercadolibre.com/items/MLA810693730

    Respuesta:

    {
       "id": "MLA810693730",
       "site_id": "MLA",
       "title": "Item De Test - No Ofertar",
       "subtitle": null,
       "seller_id": 443024908,
       "category_id": "MLA3530",
       "official_store_id": null,
       "price": 100,
       "base_price": 100,
       "original_price": null,
       "inventory_id": null,
       "currency_id": "ARS",
       "initial_quantity": 1,
       "available_quantity": 1,
       "sold_quantity": 0,
       "sale_terms": [],
       "buying_mode": "buy_it_now",
       "listing_type_id": "gold_pro",
       "start_time": "2019-08-22T17:33:51.000Z",
       "stop_time": "2039-08-17T04:00:00.000Z",
       "end_time": "2039-08-17T04:00:00.000Z",
       "expiration_time": "2019-11-10T17:33:51.000Z",
       "condition": "new",
       "descriptions": [],
       "accepts_mercadopago": true,
       "non_mercado_pago_payment_methods": [],
       "international_delivery_mode": "none",
       "seller_contact": null,
       "location": {},
       "geolocation": {
           "latitude": -34.5780655,
           "longitude": -58.4265317
       },
       "coverage_areas": [],
       "warnings": [],
       "listing_source": "",
       "variations": [],
       "status": "active",
       "sub_status": [],
       "tags": [
           "mshops_ahora-12",
           "immediate_payment",
           "test_item"
       ],
       "warranty": null,
       "catalog_product_id": null,
       "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
       "seller_custom_field": null,
       "parent_item_id": null,
       "differential_pricing": null,
       "deal_ids": [],
       "automatic_relist": false,
       "date_created": "2019-08-22T17:33:51.000Z",
       "last_updated": "2019-08-22T18:37:41.468Z",
       "health": null,
       "catalog_listing": false,
       "item_relations": []
    }

    Recuerda que retornaremos un http error 400 siempre que no cumplas los requisitos o en los casos que:

    • El vendedor no esté habilitado para participar de la campaña.
    • El ítem sea usado o reacondicionado.
    • La exposición de la publicación sea distinta a Premium.

    Deshabilitar una campaña en una publicación

    Para deshabilitar la campaña en un ítem, debes realizar un PUT al recurso /ítems, incluyendo todos los tags que tenía anteriormente, excepto el “mshops_3x_campaign”, “mshops_ahora-6”, “mshops_ahora-12” o "mshops_ahora-24" según corresponda:


    Lhamada:

    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
      "tags": [
           "immediate_payment",
           "test_item"
       ],
    }
    https://api.mercadolibre.com/items/$ITEM_ID

    Ejemplo:

    curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
      "tags": [
           "immediate_payment",
           "test_item"
       ],
    }
    https://api.mercadolibre.com/items/MLA810693730

    Respuesta:

    {
       "id": "MLA810693730",
       "site_id": "MLA",
       "title": "Item De Test - No Ofertar",
       "subtitle": null,
       "seller_id": 443024908,
       "category_id": "MLA3530",
       "official_store_id": null,
       "price": 100,
       "base_price": 100,
       "original_price": null,
       "inventory_id": null,
       "currency_id": "ARS",
       "initial_quantity": 1,
       "available_quantity": 1,
       "sold_quantity": 0,
       "sale_terms": [],
       "buying_mode": "buy_it_now",
       "listing_type_id": "gold_pro",
       "start_time": "2019-08-22T17:33:51.000Z",
       "stop_time": "2039-08-17T04:00:00.000Z",
       "end_time": "2039-08-17T04:00:00.000Z",
       "expiration_time": "2019-11-10T17:33:51.000Z",
       "condition": "new",
       "descriptions": [],
       "accepts_mercadopago": true,
       "non_mercado_pago_payment_methods": [],
       "international_delivery_mode": "none",
       "seller_contact": null,
       "location": {},
       "geolocation": {
           "latitude": -34.5780655,
           "longitude": -58.4265317
       },
       "coverage_areas": [],
       "warnings": [],
       "listing_source": "",
       "variations": [],
       "status": "active",
       "sub_status": [],
       "tags": [
           "immediate_payment",
           "test_item"
       ],
       "warranty": null,
       "catalog_product_id": null,
       "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
       "seller_custom_field": null,
       "parent_item_id": null,
       "differential_pricing": null,
       "deal_ids": [],
       "automatic_relist": false,
       "date_created": "2019-08-22T17:33:51.000Z",
       "last_updated": "2019-08-22T18:37:41.468Z",
       "health": null,
       "catalog_listing": false,
       "item_relations": []
    }