Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 15/03/2023

Novedades de vendedores

Con el recurso /communications/notices accedes a todas las novedades vigentes enviadas por Mercado Libre a los vendedores en Ventas > Novedades como muestra la imagen. Conoce más los beneficios de esta funcionalidad para los vendedores.





Consultar novedades

Parámetros opcionales

limit: límite máximo de comunicaciones que se desea recibir
offset: si el total es mayor al límite, el offset se utiliza para el paginado

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=$LIMIT&offset=$OFFSET

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=20&offset=0

Respuesta:

{
   "paging": {
       "total": 2,
       "offset": 0,
       "limit": 10
   },
   "results": [
       {
           "actions": [
               {
                   "text": "Mas información",
                   "link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores"
               },
               {
                   "text": "Dar feedback",
                   "link": "https://www.mercadolibre.com.ar"
               }
           ],
           "id": "3691",
           "label": "Bienvenidos integradores a la central de novedades! prueba 2",
           "description": "

Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.

\n", "highlighted": true, "from_date": "2021-07-12T15:00:00.000Z", "tags": [ { "tag": "BLACK_FRIDAY", "type": "EVENTS" }, { "tag": "BILLING", "type": "BILLING" }, { "tag": "SHIPPING_GENERIC", "type": "SHIPPING" } ] }, { "actions": [ { "text": "Mas información", "link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores" }, { "text": "Dar feedback", "link": "https://www.mercadolibre.com.ar" } ], "id": "3446", "label": "Bienvenidos integradores a la central de novedades!", "description": "

Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.

\n", "highlighted": true, "from_date": "2021-07-12T15:00:00.000Z", "tags": [ { "tag": "COVID", "type": "EVENTS" }, { "tag": "SHIPPING_GENERIC", "type": "SHIPPING" } ] } ] }
Nota:
Las novedades están ordenadas por fecha de creación, en orden descendente y solo verás aquellas vigentes al momento de consultar.

Campos de la respuesta

paging: formato de paginado de resultados.

  • total: total de resultados encontrados.
  • offset: índice del resultado a partir del que se quiere obtener. Por ejemplo: Con 100 novedades en total, utilizando un limit de 20. Si quieres ver una segunda página, debes enviar offset = 21 y mostrará del 21 al 40.
  • limit: cantidad máxima de resultados para ver en una página.

results: lista de las novedades.

  • actions(opcional): lista con las acciones.
  • text: texto de la acción.   

  • link: link de la acción.

id: identificación de la comunicación.
label: título de la comunicación.
description: descripción de la comunicación.
highlighted: indica si la novedad está destacada en Mercado Libre o no.
from_date: fecha en formato ISO, indica la creación de la novedad.
tags: con las siguientes tag identificas los tipos de novedades. Además puedes agruparlas según Atención, Envíos, Eventos, Facturación, Países y Publicaciones.

Atención Envíos Eventos Facturación Países Publicaciones
Tag Referencia
METRICS Métricas
CANCELLATIONS Cancelaciones
RETURNS Devoluciones
CLAIMS Reclamos
REPUTATION Reputación
Tag Referencia
SHIPPING_GENERIC Envíos
SHIPPING Mercado Envíos
SHIPPING_XD Mercado Envíos colecta
FLEX Flex
FULL Full
SHIPPING_CARRIER Mercado Envíos Partnered Carrier
Tag Referencia
CHRISTMAS Navidad
BLACK_FRIDAY Black Friday
HOT_SALE Hot Sale
CYBER_MONDAY Cyber Monday
COVID COVID-19
Tag Referencia
COST Costos
BILLING Facturación
TRANSMITTER Emisor de NF-e
Tag Referencia
MCO Colombia
MLC_FULFILLMENT Chile - Full
MLC_REMOTE Chile
MLB Brasil
MLM_REMOTE México
MLM_FULFILLMENT México - Full
Tag Referencia
PUBLICATIONS Publicaciones
PROMOTIONS_CENTRAL Central de promociones
CATALOG Catálogo