Documentación Mercado Shops

Descubre toda la información que debes conocer sobre las APIs de Mercado Shops.
circulos azuis em degrade
Última actualización 23/02/2024

Publicaciones

Todas las ventas generadas a través de una tienda de Mercado Shops y los productos publicados con sus respectivos atributos y variaciones se gestionan de la misma manera y por medio de la API de Mercado Libre (Guía para productos).


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

Importante:
Al momento de publicar o editar el canal, debes reconocer si la categoría cuenta con el atributo price obligatorio.

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.