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 uma publicação diferenciados por canal

Atualmente, você contará com o recurso de /permalinks dentro da API de itens, que permitirá obter os links correspondentes às publicações e distingui-los por cada canal em que estão publicados.

Parâmetros:

É possível obter os diferentes permalinks de um item específico, dos diferentes canais de venda em que está publicado, realizando uma consulta com os seguintes parâmetros.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/permalinks?

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MCO944706832/permalinks?

Resposta (somente Marketplace):

{
    "Permalinks": [
        {
            "channel": "marketplace",
            "permalink": "https://articulo.mercadolibre.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Resposta (somente Mshops):

{
    "Permalinks": [
        {
            "channel": "mshops",
            "permalink": "https://internal-shop.mercadoshops.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Resposta (múltiplos canais):

{
    "Permalinks": [
        {
            "channel": "marketplace",
            "permalink": "https://articulo.mercadolibre.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        },
        {
            "channel": "mshops",
            "permalink": "https://internal-shop.mercadoshops.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Campos da resposta

A resposta de um GET ao recurso /permalinks fornecerá os seguintes parâmetros:

• results:
  • Channel: Indica o canal de distribuição específico em que o item está disponível.
  • permalink: É o link permanente associado ao canal específico. Esta URL leva diretamente à página do item dentro do canal indicado.

Erros Permalink canais

Código da publicação inexistente ou malformado

{
    "message": "Item with id MLM123 not found",
    "error": "not_found",
    "status": 404,
    "cause": [],
}

A publicação não pertence ao vendedor

{
    "message": "The caller is not authorized to access this resource",
    "error": "forbidden",
    "status": 403,
    "cause": [],
}

Erro no uso do token de acesso para obter informações do permalink

{
    "message": "Invalid Token",
    "error": "not_found",
    "status": 401,
    "cause": [],
}

Obter múltiplos permalinks de publicações Mshops

Atualmente, você terá o recurso de /permalinks para obter os links correspondentes às publicações do Mercado Shops das lojas, permitindo que você tenha facilmente as informações do item publicado no canal MShops. Através deste recurso, será possível obter múltiplos links dos produtos nas lojas Mshops em uma única chamada.

Parâmetros:

É possível obter os permalinks de itens específicos que correspondam a um vendedor, realizando uma consulta com os seguintes parâmetros.

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.br/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 da resposta

A resposta de um GET ao recurso /permalinks fornecerá os seguintes parâmetros:

• results:
  • item_id: Identificador único do item ou publicação dentro do Mercado Livre e/ou da loja sob 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 item na plataforma.

Erros múltiplos Permalink

Código da publicação inexistente ou mal formatado

{
    "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 de permalink

Request-code: 401

{
    "code": "unauthorized",
    "message": "invalid access token"
}

Próximo: Envios grátis.