Documentación Mercado Shops

Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.
circulos azuis em degrade

Documentación

Última actualización 26/01/2024

Campañas con cuotas

f
Importante:
Recuerda que a partir de ahora, tus publicaciones se diferencian por las cuotas que agregues. Para que puedas identificar de una manera más clara qué ofrecen tus publicaciones, dejamos de llamarlas Clásica o Premium. Ver más.

Actualmente, contamos con un nuevo modelo de cuotas aplicables a tus publicaciones del canal de Mshops, en el cual podrás optar por elegir publicar con o sin cuotas.
Con la publicación Clásica (gold_special), ofrecés cuotas con interés a cargo de tus compradores, permitiendo que el comprador seleccione la opciones de cuotas de su preferencia. Mientras que con la publicación Premium (gold_pro) ofrecés la mejor financiación en cuotas a tu cargo, al momento de publicar o modificar tu publicación, podrás elegir la cantidad de cuotas que querés ofrecer. Revisá la tabla y encontrá los costos por ofrecer financiación que se suman al cargo por vender.

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


Publicaciones en las que eliges no agregar cuotas

Cuotas con interés bajo: con esta opción pagás un 4% por ofrecer a tus compradores de 3 a 12 cuotas con un interés menor que el de los bancos. Así podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y actívala con el tag mshops_pcj-co-funded.



Publicaciones en las que eliges agregar cuotas

3 cuotas al mismo precio que publiques: Podrás elegir ofrecer 3 cuotas al mismo precio que publicaste y pagar menos de cargo por venta en tu tienda de Mercado Shops*. Así, podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_3x_campaign. Esta campaña estará disponible para todos los vendedores y en categorías seleccionadas.

  • Cuota Simple 3: en publicaciones de Argentina elegibles para participar de Cuota Simple 3. Así, van a poder comprarte en 3 cuotas al mismo precio que publicaste podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_cuota-simple-3.
  • Cuota Simple 6: en publicaciones de Argentina elegibles para participar de Cuota Simple 6. Así, van a poder comprarte en 6 cuotas al mismo precio que publicaste podrás ofrecer precios más competitivos. Para hacerlo, modifica tus publicaciones y activa la opción de mshops_cuota-simple-6.

Las campañas aplican exclusivamente a ventas en el canal de Mshops. Ver costos por agregar cuotas.



Comparación opciones de cuotas

Publicaciones en las que eliges no agregar cuotas

Nombre de campaña listing_type Tag Marketplace Tag Mshops
No quiero agregar cuotas (el vendedor no tiene habilitado Cuota Simple) gold_special sin tag sin tag
No quiero agregar cuotas (el vendedor tiene habilitado Cuota Simple) gold_special suota-simple-paid-by-buyer no aplica
3 a 12 cuotas con interés bajo gold_special pcj-co-funded mshops_pcj-co-funded

Publicaciones en las que eliges agregar cuotas

Nombre de campaña listing_type Tag Marketplace Tag Mshops
3 cuotas al mismo precio que publicaste gold_pro 3x_campaign mshops_3x_campaign
6 cuotas al mismo precio que publicaste gold_pro sin tag no aplica
3 cuotas al mismo precio que publicaste - Cuota Simple gold_pro cuota-simple-3 mshops_cuota-simple-3
6 cuotas al mismo precio que publicaste - Cuota Simple gold_pro cuota-simple-6 mshops_cuota-simple-6


Usuarios habilitados para campañas

Realizar un GET al recurso /special_installments/mshops_cuota-simple-6 (campaña cuota-simple-3 o mshops_cuota-simple-6) 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 y mshops_pcj-co-funded no aplica, ya que todos los vendedores pueden participar sin limitaciones.

Llamada:

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

Ejemplo:

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

Respuesta:

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

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

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


Cargos por venta por campañas

Para consultar los costos por vender, debes realizar un GET al recurso /listing_prices filtrando por precio, listing_type, tag y dominio, según corresponda.

Recuerda:

  1. Respetar la relación listing_type+tag (ver opciones) .
  2. Filtrar por channel para ver las comisiones específicas. En caso contrario, verás por defecto las de marketplace.

Ejemplo del dominio Notebooks:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10000&listing_type_id=gold_pro&tags=3x_campaign&domain_id=MLA-NOTEBOOKS

Respuesta de campaña de 3 cuotas al mismo precio que publicaste:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "requires_picture": true,
        "sale_fee_amount": 1983,
        "sale_fee_details": {
            "financing_add_on_fee": 15,
            "fixed_fee": 0,
            "gross_amount": 1983,
            "meli_percentage_fee": 4.83,
            "percentage_fee": 19.83
        },
        "stop_time": "2043-09-14T00:00:00.000-04:00"
    }
]

Es decir, el dominio Notebooks con el tag 3x_campaign, el cargo por venta en Mercado Shops será de 4.83% y el cargo por ofrecer cuotas será de 15%, total cargos de 19.83%. Para más información, puedes consultar recursos para obtener los costos por vender.


Ejemplo del dominio Notebooks para el canal de Mshop con 3 a 12 cuotas con interés bajo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10000&listing_type_id=gold_special&tags=mshops_pcj-co-funded&channel=mshops&domain_id=MLA-NOTEBOOKS

Respuesta de campaña 3 a 12 cuotas con interés bajo:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_special",
        "listing_type_name": "Clásica",
        "requires_picture": true,
        "sale_fee_amount": 883,
        "sale_fee_details": {
            "financing_add_on_fee": 4,
            "fixed_fee": 0,
            "gross_amount": 883,
            "meli_percentage_fee": 4.83,
            "percentage_fee": 8.83
        },
        "stop_time": "2043-09-14T00:00:00.000-04:00"
    }
]

Es decir, el dominio Notebooks con el tag mshops_pcj-co-funded, el cargo por venta en Mercado Shops será de 4.83% y el cargo por ofrecer de 3 a 12 cuotas será de 4%, total cargos de 8.83%..



Publicaciones en campaña

Para consultar si un producto tiene habilitado algunas de las campañas posibles de 3 a 12 cuotas con interés bajo, 3 cuotas al mismo precio que publicaste y algunas de las opciones de Cuota Simple 3 y 6, realiza un GET al recurso /items con su item_id y verifica que tenga el tag mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6 dentro de los tags.


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_cuota-simple-6"
    ],
    "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 correspondiente a la campaña que quieras sumar mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6. 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 6 cuotas con la participación del programa Cuota Simple deben ser productos nuevos y su publicación ser Premium, es decir, solo aquellas con listing_type_id: gold_pro.


Llamada:

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_cuota-simple-6"       
    ]
     ...
}

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_cuota-simple-6",
        "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 error HTTP 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

Para habilitar la campaña en un ítem, debes realizar un PUT al recurso /items incluyendo el tag correspondiente mshops_pcj-co-funded, mshops_3x_campaign , mshops_cuota-simple-3 o mshops_cuota-simple-6. 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 6 cuotas con la participación del programa Cuota Simple 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_cuota-simple-6",
      "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":[
      "mshops_cuota-simple-6"
   ]
}
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_cuota-simple-6",
       "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 error HTTP 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

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 tag que hace referencia a las campañas como mshops_pcj-co-funded, mshops_3x_campaign, mshops_cuota-simple-3 o mshops_cuota-simple-6 según corresponda:


Llamada:

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": []
}