Documentación Mercado Shops
Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.Documentación
Publicaciones
Vincular vendedor con tienda
Para saber si el vendedor tiene una tienda creada, realiza una búsqueda con el site y seller id. Si tiene el tag mshops significa que tiene su tienda creada en Mercado Shops. En caso de no tener este tag, podrá crear una tienda en Mercado Shops.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/search?seller_id=618515328
Respuesta:
{
"site_id":"MLB",
"seller":{
"id":618515328,
"nickname":"TETE1835554",
"permalink":"http://perfil.mercadolivre.com.br/TETE1835555",
"registration_date":"2020-07-31T09:59:53.000-04:00",
"seller_reputation":{
"level_id":"5_green",
"power_seller_status":null,
"transactions":{
"total":1,
"canceled":0,
"period":"historic",
"ratings":{
"negative":0,
"positive":0,
"neutral":1
},
"completed":1
},
"metrics":{
"sales":{
"period":"365 days",
"completed":1
}
}
},
"real_estate_agency":false,
"car_dealer":false,
"tags":[
"normal",
"test_user",
"mshops",
"messages_as_seller",
"messages_as_buyer"
],
"eshop":null
},
"paging":{
"total":0,
"primary_results":1000,
"offset":0,
"limit":50
},
"results":[ ],
"secondary_results":[ ],
"related_results":[ ],
"sort":{
"id":"relevance",
"name":"Mais relevantes"
},
"available_sorts":[
{
"id":"price_asc",
"name":"Menor preço"
},
{
"id":"price_desc",
"name":"Maior preço"
}
],
"filters":[ ],
"available_filters":[ ]
}
Publicar en Mercado Libre y/o Mercado Shops
Mediante el campo channels puedes definir en qué canal quieres publicar el ítem (Mercado Libre y/o Mercado Shops). Esta misma acción podrás realizarla en cualquier momento que quieras cambiar la publicación para algún canal en particular.
Ejemplo de ítem publicado solo en Mercado Shops:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...]
"channels": ["mshops"]
[...]
}
https://api.mercadolibre.com/items
Ejemplo de ítem publicado solo en Mercado Libre:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...]
"channels": ["marketplace"]
[...]
}
https://api.mercadolibre.com/items
Para más detalle, puedes consultar publicaciones de marketplace.
Ejemplo de ítem publicado en ambos canales:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...]
"channels": ["marketplace",
"mshops"
]
[...]
}
https://api.mercadolibre.com/items
Editar canal de publicación
También puedes modificar el canal en el que se encuentre la publicación realizando un PUT al mismo recurso de /items.
Ejemplo de edición de publicación de marketplace a mshops:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H
{
[...]
"channels": ["mshops"]
[...]
}
https://api.mercadolibre.com/items
Si deseas editar publicaciones de marketplace, puedes hacerlo con el recurso /items.
Crear o actualizar precio
Ejemplo:
curl -X POST-H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...]
"amount": 50000,
"currency_id":"ARS"
}
https://api.mercadolibre.com/items/$ITEM_ID/prices/types/standard/channels/mshops
Respuesta:
{
"prices": [
{
"id": "9",
"type": "standard",
"amount": 50000,
"regular_amount": null,
"currency_id": "ARS",
"last_updated": "2021-06-03T16:24:56Z",
"conditions": {
"context_restrictions": ["channel_mshops"],
"start_time": null,
"end_time": null
}
}]
[...]
}
Para gestionar los precios y suscribirse a notificaciones de Precios, visita Precios de productos.
Eliminar precio
Al eliminar el precio en Mercado Shops puedes mantener un precio estándar, sin diferenciar las publicaciones de Mercado Libre y Mercado Shops.
Llamada:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/prices/types/standard/channels/mshops
Siguiente: Envíos gratis.