Documentación Mercado Shops
Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.
Documentación
Campañas con cuotas
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 | cuota-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 |
9 cuotas al mismo precio que publicaste | gold_pro | 9x_campaign | mshops_9x_campaign |
12 cuotas al mismo precio que publicaste - Cuota Simple (Activación en 18/06/24) | gold_pro | cuota-simple-12 | mshops_cuota-simple-12 |
12 cuotas al mismo precio que publicaste (Activación en 18/06/24) | gold_pro | 12x_campaign | mshops_12x_campaign |
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.
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:
- Respetar la relación listing_type+tag (ver opciones) .
- 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": []
}