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 una publicación diferenciados por canal

Actualmente contarás con el recurso de /permalinks dentro de la API de ítems, que te permitirá obtener los links correspondientes de las publicaciones y distinguirlos por cada canal en los que se encuentran publicados.

Parámetros:

Se puede obtener los diferentes permalinks de un ítem específico, de los diferentes canales de venta que esté publicado, realizando una consulta con los siguientes parámetros.

Llamada:

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

Ejemplo:

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

Respuesta (solo Marketplace):

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

Respuesta (solo Mshops):

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

Respuesta (múltiples canales):

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

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

• results:
  • Channel: Indica el canal de distribución específico en el cual el artículo está disponible.
  • permalink: Es el enlace permanente asociado con el canal específico. Esta URL lleva directamente a la página del artículo dentro del canal indicado.

Errores Permalink canales

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

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

Publicación no pertenece al vendedor

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

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

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

Obtener múltiples permalinks de publicaciones Mshops

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. A través de este recurso, se podrá obtener múltiples links de los productos en las tiendas de Mshops en una sola llamada.

Parámetros:

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

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 múltiples 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.