Publicaciones

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

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.
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

Obtener permalinks de publicaciones

Actualmente contarás con el recurso de /permalinks para poder obtener los links correspondientes a las publicaciones de Mercado Shops de las tiendas, permitiendo contar fácilmente con la información del ítem publicado en el canal de MShops.

Parámetros:

Se puede obtener los permalinks de ítems específicos que correspondan a un seller, realizando una consulta con los siguientes parámetros.

Nombre	Tipo	Descripcion	Ejemplo
Item_id	String	ID de la publicacion	MLA594239600

Llamada:

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

Ejemplo:

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

Respuesta:

{
    "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 la respuesta

La respuesta de un GET al recurso /permalinks proporcionará los siguientes parámetros

• results:
  • item_id: Identificador único del artículo o publicación dentro de Mercado Libre y/o la tienda bajo Mercado Shops.
  • code: Código de respuesta que indica el estado de la solicitud realizada a la API. Los códigos de respuesta son valores numéricos que siguen el estándar HTTP.
  • permalink: Enlace permanente (URL) único de la publicación, usado para acceder directamente a la página del artículo en la plataforma.

Errores Permalink

Código de la publicación inexistente o mal formado

{
    "item_id": "ITEM_ID",
    "code": 400,
    "cause": "Item has not a valid format"
}

Publicación no pertenece al vendedor

{
    "item_id": "ITEM_ID",
    "code": 403,
    "cause": "Item does not belong to seller"
}

Error al recuperar el permalink de la publicación

{
    "item_id": "ITEM_ID",
    "code": 404,
    "cause": "Error retrieving item"
}

Error al recuperar el permalink de la publicación

{
    "item_id": "ITEM_ID",
    "code": 500,
    "cause": "Error retrieving item"
}

Error en el uso del access token para obtener información de permalink

Request-code: 401

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

Siguiente: Envíos gratis.