Documentação do Mercado Shops

Confira todas as informações necessárias sobre as APIs Mercado Shops.
circulos azuis em degrade
Última atualização em 23/02/2024

Publicações

Todas as vendas geradas através de uma loja Mercado Shops e os produtos publicados com seus respectivos atributos e variações são gerenciados da mesma forma, pela API do Mercado Livre (Guia para produtos).


Vincular vendedor com loja

Para saber se o vendedor tem uma loja no Mercado Shops, faça uma busca com o site e seller id. Se tiver a tag mshops significa que tem uma loja criada. Se não tiver essa tag, poderá criar uma loja.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/search?seller_id=618515328

Resposta:

{
   "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 no Mercado Livre e/ou Mercado Shops

Importante:
Ao publicar ou editar o canal, você deve reconhecer se a categoria possui o atributo preço obrigatório.

Pelo campo channels você pode definir qual canal quer publicar o item (Mercado Livre e/ou Mercado Shops). Esta mesma ação poderá ser feita a qualquer momento que queira modificar a publicação para algum canal em particular.


Exemplo de um item publicado apenas no Mercado Shops:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
	[...]
	"channels": ["mshops"]
	[...]
}
https://api.mercadolibre.com/items

Exemplo de um item publicado apenas no Mercado Livre:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
	[...]
	"channels": ["marketplace"]
	[...]
}
https://api.mercadolibre.com/items

Para mais detalhes, você pode consultar publicações de marketplace.


Exemplo de um item publicado nos dois canais:

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 publicação

Você também pode modificar o canal em que a publicação está fazendo um PUT no mesmo recurso /items.


Exemplo de edição de uma publicação de marketplace para MShops:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 
{
	[...]
	"channels": ["mshops"]
	[...]
}
https://api.mercadolibre.com/items

Se você deseja editar publicações de marketplace, pode fazê-lo com o recurso /items.


Criar e/ou atualizar o preço

Exemplo:

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

Resposta:

{
    "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 gerenciar preços e se inscrever para notificações de Preços, visite Preços de productos.


Apagar preço

Ao eliminar o preço no Mercado Shops, você mantém um preço padrão, sem diferenciar as publicações do Mercado Livre e do Mercado Shops.

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/prices/types/standard/channels/mshops

Próxima: Envios grátis.