Documentação do Mercado Shops
Confira todas as informações necessárias sobre as APIs Mercado Shops.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentação do
Publicações
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
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.
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
Obter permalinks de publicações
Atualmente, você contará com o recurso de /permalinks para obter os links correspondentes às publicações do Mercado Shops das lojas, permitindo obter facilmente as informações do item publicado no canal de MShops.
Parâmetros:
É possível obter os permalinks de itens específicos que correspondam a um vendedor, realizando uma consulta com os seguintes parâmetros.
Nome | Tipo | Descrição | Exemplo |
---|---|---|---|
Item_id | String | ID da publicação | MLA594239600 |
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/$SELLER_ID/permalinks?ids=$ITEM_ID_1,$ITEM_ID_2,$ITEM_ID_3,$ITEM_ID_4,$ITEM_ID_5&channel=mshops
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/123/permalinks?ids=MLA1,MLA2,MLA3,MLA4,MLA5&channel=mshops
Resposta:
{
"results": [
{
"item_id": "MLA1",
"code": 200,
"permalink": "https://internal-shop.mercadoshops.com.ar/MLA_1_PATH"
},
{
"item_id": "MLA2",
"code": 400,
"cause": "Item has not a valid format"
},
{
"item_id": "MLA3",
"code": 403,
"cause": "Item does not belong to seller"
},
{
"item_id": "MLA4",
"code": 404,
"cause": "Error retrieving item"
},
{
"item_id": "MLA5",
"code": 500,
"cause": "Error retrieving item"
}
]
}
Campos de resposta
A resposta de um GET ao recurso /permalinks fornecerá os seguintes parâmetros
- results:
- item_id: Identificador único do artigo ou publicação dentro do Mercado Livre e/ou da loja no Mercado Shops.
- code: Código de resposta que indica o estado da solicitação realizada à API. Os códigos de resposta são valores numéricos que seguem o padrão HTTP.
- permalink: Link permanente (URL) único da publicação, usado para acessar diretamente a página do artigo na plataforma.
Erros Permalink
Código da publicação inexistente ou malformado
{
"item_id": "ITEM_ID",
"code": 400,
"cause": "Item has not a valid format"
}
Publicação não pertence ao vendedor
{
"item_id": "ITEM_ID",
"code": 403,
"cause": "Item does not belong to seller"
}
Erro ao recuperar o permalink da publicação
{
"item_id": "ITEM_ID",
"code": 404,
"cause": "Error retrieving item"
}
Erro ao recuperar o permalink da publicação
{
"item_id": "ITEM_ID",
"code": 500,
"cause": "Error retrieving item"
}
Erro no uso do access token para obter informações do permalink
Request-code: 401
{
"code": "unauthorized",
"message": "invalid access token"
}
Próxima: Envios grátis.