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.