• API Docs
  • Guia para productos
  • Publicar productos
Última actualización 28/12/2022

Publicar productos

En la API de Mercado Libre, las publicaciones son artículos que contienen productos con atributos que puedes vender o comprar. Los usuarios no pueden intercambiar información de contacto de inmediato. Por eso, cada vez que existe la intención de comprar un producto, los compradores potenciales pueden realizar preguntas y se crea un pedido tanto para el comprador como para el vendedor con el detalle de la transacción, como una venta o compra para cada uno. En ese momento, la información de contacto será visible entre los usuarios.




Detalle de las publicaciones

Cuando un usuario selecciona un artículo del resultado, esta página muestra los siguientes detalles del artículo:

  • Item_id
  • Título
  • Categoría
  • Imágenes
  • Precio
  • Ciudad
  • Cantidad vendida
  • Preguntas
  • Reputación del vendedor

Consultar productos

Nota:
Desde ahora puedes obtener un nuevo parámetro “value_type” dentro del detalle de los atributos de los ítems. Este campo entrega información del tipo de dato que se espera. ejemplo: string, number, etc.

Llamada:

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

Ejemplo:

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

Respuesta:

{

   "id": "MLA1136716168",
   "site_id": "MLA",
   "title": "Zapatillas Avid Fof - Test Item",
   "subtitle": null,
   "seller_id": 1108966308,
   "category_id": "MLA109027",
   "official_store_id": null,
   "price": 15000,
   "base_price": 15000,
   "original_price": null,
   "currency_id": "ARS",
   "initial_quantity": 2,
   "available_quantity": 2,
   "sold_quantity": 0,
   "sale_terms": [],
   "buying_mode": "buy_it_now",
   "listing_type_id": "gold_pro",
   "start_time": "2022-05-10T21:55:46.000Z",
   "historical_start_time": "2022-05-10T21:55:46.000Z",
   "stop_time": "2042-05-05T04:00:00.000Z",
   "condition": "new",
   "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
   "thumbnail_id": "963513-MLA49868862376_052022",
   "thumbnail": "http://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
   "secure_thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
   "pictures": [
       {
           "id": "963513-MLA49868862376_052022",
           "url": "http://http2.mlstatic.com/D_963513-MLA49868862376_052022-O.jpg",
           "secure_url": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-O.jpg",
           "size": "500x411",
           "max_size": "898x739",
           "quality": ""
       }
   ],
   "video_id": null,
   "descriptions": [],
   "accepts_mercadopago": true,
   "non_mercado_pago_payment_methods": [],
   "shipping": {
       "mode": "not_specified",
       "methods": [],
       "tags": [
           "adoption_required"
       ],
       "dimensions": null,
       "local_pick_up": false,
       "free_shipping": false,
       "logistic_type": "not_specified",
       "store_pick_up": false
   },
   "international_delivery_mode": "none",
   "seller_address": {
       "id": 0
   },
   "seller_contact": null,
   "location": {},
   "coverage_areas": [],
   "attributes": [
       {
           "id": "AGE_GROUP",
           "name": "Edad",
           "value_id": "6725189",
           "value_name": "Adultos",
           "value_struct": null,
           "values": [
               {
                   "id": "6725189",
                   "name": "Adultos",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "BRAND",
           "name": "Marca",
           "value_id": "11823494",
           "value_name": "Propia",
           "value_struct": null,
           "values": [
               {
                   "id": "11823494",
                   "name": "Propia",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "EXCLUSIVE_CHANNEL",
           "name": "Canal exclusivo",
           "value_id": "7865259",
           "value_name": "Mercado Libre",
           "value_struct": null,
           "values": [
               {
                   "id": "7865259",
                   "name": "Mercado Libre",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "FOOTWEAR_TYPE",
           "name": "Tipo de calzado",
           "value_id": "517583",
           "value_name": "Zapatilla",
           "value_struct": null,
           "values": [
               {
                   "id": "517583",
                   "name": "Zapatilla",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "GENDER",
           "name": "Género",
           "value_id": "339666",
           "value_name": "Hombre",
           "value_struct": null,
           "values": [
               {
                   "id": "339666",
                   "name": "Hombre",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "ITEM_CONDITION",
           "name": "Condición del ítem",
           "value_id": "2230284",
           "value_name": "Nuevo",
           "value_struct": null,
           "values": [
               {
                   "id": "2230284",
                   "name": "Nuevo",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "MODEL",
           "name": "Modelo",
           "value_id": null,
           "value_name": "EQ2122",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "EQ2122",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "SIZE_GRID_ID",
           "name": "ID de la guía de talles",
           "value_id": null,
           "value_name": "210052",
           "value_struct": null,
           "values": [
               {
                   "id": null,
                   "name": "210052",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       },
       {
           "id": "STYLE",
           "name": "Estilo",
           "value_id": "6694773",
           "value_name": "Urbano",
           "value_struct": null,
           "values": [
               {
                   "id": "6694773",
                   "name": "Urbano",
                   "struct": null
               }
           ],
           "attribute_group_id": "OTHERS",
           "attribute_group_name": "Otros",
           "value_type": "string"
       }
   ],
   "warnings": [],
   "listing_source": "",
   "variations": [
       {
           "id": 174497701554,
           "price": 15000.00,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52049",
                   "value_name": "Negro",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52049",
                           "name": "Negro",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Talle",
                   "value_id": "11505183",
                   "value_name": "45,0 AR",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "11505183",
                           "name": "45,0 AR",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "available_quantity": 1,
           "sold_quantity": 0,
           "sale_terms": [],
           "picture_ids": [
               "963513-MLA49868862376_052022"
           ],
           "catalog_product_id": null
       },
       {
           "id": 174497701555,
           "price": 15000.00,
           "attribute_combinations": [
               {
                   "id": "COLOR",
                   "name": "Color",
                   "value_id": "52049",
                   "value_name": "Negro",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "52049",
                           "name": "Negro",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               },
               {
                   "id": "SIZE",
                   "name": "Talle",
                   "value_id": "11505178",
                   "value_name": "44,0 AR",
                   "value_struct": null,
                   "values": [
                       {
                           "id": "11505178",
                           "name": "44,0 AR",
                           "struct": null
                       }
                   ],
                   "value_type": "string"
               }
           ],
           "available_quantity": 1,
           "sold_quantity": 0,
           "sale_terms": [],
           "picture_ids": [
               "963513-MLA49868862376_052022"
           ],
           "catalog_product_id": null
       }
   ],
   "status": "active",
   "sub_status": [],
   "tags": [
       "test_item",
       "good_quality_picture",
       "good_quality_thumbnail",
       "immediate_payment"
   ],
   "warranty": null,
   "catalog_product_id": null,
   "domain_id": "MLA-SNEAKERS",
   "parent_item_id": null,
   "differential_pricing": null,
   "deal_ids": [],
   "automatic_relist": false,
   "date_created": "2022-05-10T21:55:46.000Z",
   "last_updated": "2022-05-22T09:49:16.725Z",
   "total_listing_fee": null,
   "health": 0.85,
   "catalog_listing": false,
   "channels": [
       "marketplace"
   ],
   "bundle": null
    
}

Atributos

Cuando creas un artículo, algunos de los campos son obligatorios, mientras que otros se pueden omitir o los agregaremos automáticamente. Definirán cómo se muestra el artículo, cómo pueden comprarlo los compradores y la posición en los resultados de la búsqueda, entre otras variables.


Título

Nota:
Podrás hacer todos los cambios que necesites realizando un PUT al recurso items modificando el campo tittle siempre que sold_quantity sea 0.

El título es la clave para que los compradores encuentren el producto que están buscando. Sigue estas recomendaciones para que sea lo más claro posible y también para evitar algunas infracciones:

  • Sigue la estructura: Producto + Marca + modelo del producto + algunas especificaciones que ayuden a identificar el producto.

    • Ejemplo: Microondas Grill BGH Quick Chef B223D plata 23L 220V

  • Evita dar información de otros beneficios, como devoluciones, envío gratis o pagos en cuotas.
  • Si el producto es nuevo, usado o reacondicionado, no lo incluyas en el título, cárgalo en las características. Esta información se mostrará en el detalle de la publicación.
  • Si vendes el mismo producto pero con distintos colores, no pongas el color en el título. Crea variantes, así todo estará en una sola publicación.
  • Si realizas algún descuento, usa las etiquetas especiales o indica el porcentaje de la promoción. Descubre cómo hacerlo.
  • No está permitido mencionar stock,si lo haces tu publicación será moderada. El límite del título de la publicación está establecido por la categoría a la que pertenece el mismo ("max_title_length").
  • No menciones marcas de tercerosSi lo haces, que sea únicamente para indicar la compatibilidad de tu producto con otras marcas y siguiendo estas indicaciones:
      • Para productos compatibles que tienen marca propia:

        • [Nombre del producto] + [Marca de tu producto] + “para” o “compatible con” + [Marcas con la que es compatible]

        Ejemplo:

        -Adaptador Mimarca para speaker Tedge

        -Adaptador Mimarca compatible con speaker Tedge

      • Para productos compatibles SIN marca:

        • [Nombre del producto] + “para” o “compatible con” + [Marcas con la que es compatible]:

        Ejemplo:

        - Adaptador para speaker Tedge

        - Adaptador compatible con speaker Tedge

  • Separa las palabras con espacios no uses signos de puntuación ni símbolos.
  • Revisa que no tenga errores de ortografía.
Importante:
Si una publicación infringe derechos de propiedad intelectual, podrás ser denunciado por el titular de los derechos o tendremos que pausar o dar de baja tu publicación por incumplimiento a nuestras políticas.

Descripción

Para crear la descripción, antes debes crear la publicación sin descripción y luego, enviar la descripción mediante un POST al recurso /items/$ITEM_ID/description. La información detallada mejorará tus posibilidades de vender un producto y te ahorrará tiempo al no tener que responder preguntas. Conoce más sobre Descripciones de productos.


Estado

Al publicar un artículo, debes declarar si el estado es nuevo o usado. Este atributo es obligatorio para completar una operación de publicación. Para ítems usados en la categoría moda/deportes solo podrás crear ítems con avaliable quantity =1, y al realizar una venta el ítems pasará a status: closed. Esta funcionalidad aplica solo para Argentina, Brasil, México y Colombia.


Cantidad disponible

Este atributo define el stock, que es la cantidad de productos disponibles para la venta de este artículo. El tipo de publicación elegido define el valor más alto. Para más detalles, consulta la sección tipos de publicación.


Además, cuando deseas publicar productos de Fulfillment puedes especificar la cantidad disponible en cero, modificando el campo available_quantity en 0. De esta manera, la publicación se creará con estado pausado y subestado out_of_stock. Esto permitirá que no tengas ventas y no las puedas entregar por falta de logística. ¿Qué sucede cuando realizas PUT a ítems y no tienes stock? Admite las mismas operaciones que un ítem pausado por falta de stock, es decir, no podrás activarlo y deberás agregar unidades para que se active automáticamente.

Importante:
Esta posibilidad aplica solo para Argentina, México y Brasil donde operamos Fulfillment.

Ejemplo:

curl -X POST-H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d

'{
    ...
    "available_quantity": 0,
    ...
}'
 
https://api.mercadolibre.com/items/$ITEM_ID

Respuesta:

{
    "id": "MLB1374737433",
    "site_id": "MLB",
    "title": "Item De Teste - Não Comprar",
    "base_price": 10,
    ...
    "initial_quantity": 0,
    "available_quantity": 0,
    "sold_quantity": 0,
    ...
    "status": "paused",
    "sub_status": [
        "out_of_stock"
    ],
    ...
}

Imágenes

Las buenas imágenes pueden hacer que un artículo sea más atractivo y ofrecer a los compradores una idea más certera de su aspecto. Básicamente, deberías agregar un conjunto de hasta seis imágenes URL en el JSON.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

Te recomendamos no utilizar servidores lentos para alojar tus imágenes porque pueden generar desventajas al momento de publicar. También puedes agregar o cambiar las imágenes de tu artículo aquí más adelante. Por favor, lee más sobre este tema para conocer qué tipo de imágenes se permiten y cómo trabajar con ellas.


Categoría

Los vendedores deben definir una categoría en el site de Mercado Libre. Este atributo es obligatorio y solo acepta ID preestablecidos. Te recomendamos utilizar el predictor de categorías.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1055

Respuesta:

{
  "id": "MLA1055",
  "name": "Celulares y Smartphones",
  "picture": "http://resources.mlstatic.com/category/images/fdca1620-3b63-4af2-bc0b-aeed17048d5d.png",
  "permalink": null,
  "total_items_in_this_category": 79627,
  "path_from_root": [
    {
      "id": "MLA1051",
      "name": "Celulares y Teléfonos"
    },
    {
      "id": "MLA1055",
      "name": "Celulares y Smartphones"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "variations",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "buy_it_now",
      "auction"
    ],
    "catalog_domain": "MLA-CELLPHONES",
    "coverage_areas": "not_allowed",
    "currencies": [
      "ARS"
    ],
    "fragile": false,
    "immediate_payment": "required",
    "item_conditions": [
      "not_specified",
      "used",
      "new"
    ],
    "items_reviews_allowed": false,
    "listing_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_pictures_per_item_var": 10,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "maximum_price": null,
    "minimum_price": 22,
    "mirror_category": null,
    "mirror_master_category": null,
    "mirror_slave_categories": [
    ],
    "price": "required",
    "reservation_allowed": "not_allowed",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "not_allowed",
    "shipping_modes": [
      "me1",
      "custom",
      "me2",
      "not_specified"
    ],
    "shipping_options": [
      "custom",
      "carrier"
    ],
    "shipping_profile": "optional",
    "show_contact_information": false,
    "simple_shipping": "optional",
    "stock": "required",
    "sub_vertical": "smartphones",
    "subscribable": false,
    "tags": [
    ],
    "vertical": "consumer_electronics",
    "vip_subdomain": "articulo",
    "buyer_protection_programs": [
      "delivered",
      "undelivered"
    ],
    "status": "enabled"
  },
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

Consideraciones
Con el recurso /categories podrás reconocer si la categoría se encuentra habilitada en el site que quieras realizar la publicación.
A través de los campos listing_allowed y status podrás identificar si las categorías se encuentran habilitadas para publicar en el site. Para identificar aquellas que se encuentran habilitadas, el campo listing_allowed deberá tener el valor true y el campo status, el valor enabled.


Modalidad de compra

La modalidad de ofertar ("buying_mode"="auction") aún aparecerá en las APIs de algunas categorías, pero no podrás utilizarla. Como realizamos una revisión constante de categorías, em breve, todas las APIs ya estarán actualizadas.
Eliminamos esta modalidad de anuncio, porque casi el 100% de nuestras publicaciones tiene "Precio fijo" y vimos que la experiencia para el vendedor y el comprador estaba siendo perjudicada cuando la negociación era por ofertar.
Desde entonces, está disponible solo la modalidad de compre inmediata ("buying_mode"="buy_it_now"), que garantiza que una order sólo aparecerá para el vendedor cuando el pago esté aprobado, garantizando más seguridad en las transacciones.


Precio

Éste es un atributo obligatorio: cuando defines un nuevo artículo, debe tener precio. Te sugerimos que busques artículos similares en nuestro mercado para conocer el mejor precio para tus productos y aumentar tu competitividad. Si definiste un precio, pero no estás contento con el mismo, puedes cambiarlo más tarde; aprende cómo modificar artículos.


Moneda

Además del precio, debes definir una moneda. Este atributo también es obligatorio. Debes definirla utilizando un ID preestablecido. Sabrás qué ID enviar llamando a nuestro recurso Monedas. En Venezuela, solo puedes publicar productos y vehículos en dólares. Las publicaciones activas, las convertiremos automáticamente a dólares. Para hacer la conversión de moneda, tomaremos la cotización del día según el Banco Central de Venezuela.



Métodos de pago

Es importante que consideres los métodos de pago disponibles de Mercado Pago..


Envío

Cada sitio cuenta con un conjunto de métodos de envío disponibles y estos presentan diferentes tiempos y costos de envío. Conoce más sobre Mercado Envíos.


Identificadores de productos

Los identificadores son códigos que sirven para localizar unívocamente a un producto. Conoce más las descripciones y cómo enviar Identificadores de productos.


SKU

Esta información ayudará a tus vendedores a identificar, localizar y hacer seguimiento interno de un producto. Solo tenemos en cuenta la información cargada en el atributo SELLER_SKU. Conoce más sobre consideraciones a tener en cuenta.

Variaciones

Con variaciones podrás contar en una misma publicación todas las variantes del ítem, manteniendo incluso stock diferencial por cada una. De esta forma, cuando recibas una compra, verás en la orden de compra el color y talle elegido por el comprador, facilitando así el proceso post-venta. Conoce más sobre Variaciones.


Tipos de publicación

Es otro caso de un atributo obligatorio que solo acepta valores predefinidos y es muy importante que lo entiendas. Existen diferentes tipos de publicación disponibles para cada país. Debes realizar una llamada mixta a través de los sites y recursos listing_types para conocer los listing_types soportados.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/listing_types

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types

Respuesta:

[
   {
      "site_id":"MLA",
      "id":"gold_pro",
      "name":"Premium"
   },
   {
      "site_id":"MLA",
      "id":"gold_premium",
      "name":"Oro Premium"
   },
   {
      "site_id":"MLA",
      "id":"gold_special",
      "name":"Clásica"
   },
   {
      "site_id":"MLA",
      "id":"gold",
      "name":"Oro"
   },
   {
      "site_id":"MLA",
      "id":"silver",
      "name":"Plata"
   },
   {
      "site_id":"MLA",
      "id":"bronze",
      "name":"Bronce"
   },
   {
      "site_id":"MLA",
      "id":"free",
      "name":"Gratuita"
   }
]

Las comisiones por vender tu artículo, al igual que su posición en los resultados de la búsqueda, variarán de acuerdo con el tipo de publicación. Encontrarás información sobre los feeds y características de cada tipo de publicación en las Preguntas Frecuentes del mercado de cada país o puedes realizar una llamada a la API como esta:

Llamada:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/listing_types/$LISTING_TYPE

Ejemplo:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types/silver

Respuesta:

{
  "id": "silver",
  "not_available_in_categories": [
  ],
  "configuration": {
  "name": "Plata",
  "listing_exposure": "mid",
  "requires_picture": false,
  "max_stock_per_item": 9999,
  "deduction_profile_id": null,
  "differential_pricing_id": null,
  "duration_days": {
    "buy_it_now": 60,
    "auction": 7,
    "classified": null
  },
  "immediate_payment": {
    "buy_it_now": false,
    "auction": false,
    "classified": false
  },
  "mercado_pago": "mandatory",
  "listing_fee_criteria": {
   "min_fee_amount": 5,
    "max_fee_amount": 160,
    "percentage_of_fee_amount": 1,
    "currency": "ARS"
  },
  "sale_fee_criteria": {
    "min_fee_amount": 0,
    "max_fee_amount": 100000000000000000,
    "percentage_of_fee_amount": 7.5,
    "currency": "ARS"
  }
  },
  "exceptions_by_category": [
  {
    "category_id": "MLA1743",
    "category_name": "Autos, Motos y Otros",
    "configuration": {
      "name": "Plata",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 1,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
        "buy_it_now": null,
        "auction": null,
        "classified": 60
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 147,
        "max_fee_amount": 147,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
   },
    "exceptions_by_category": [
    ]
  },
  {
    "category_id": "MLA1459",
    "category_name": "Inmuebles",
    "configuration": {
      "name": "Plata",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 1,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
        "buy_it_now": null,
        "auction": null,
        "classified": 60
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 147,
        "max_fee_amount": 147,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
    },
    "exceptions_by_category": [
    ]
  },
  {
    "category_id": "MLA1540",
    "category_name": "Servicios",
    "configuration": {
      "name": "Básico 365",
      "listing_exposure": "mid",
      "requires_picture": false,
      "max_stock_per_item": 999,
      "deduction_profile_id": null,
      "differential_pricing_id": null,
      "duration_days": {
          "buy_it_now": null,
        "auction": null,
        "classified": 365
      },
      "immediate_payment": {
        "buy_it_now": false,
        "auction": false,
        "classified": false
      },
      "mercado_pago": "not_available",
      "listing_fee_criteria": {
        "min_fee_amount": 727,
        "max_fee_amount": 727,
        "percentage_of_fee_amount": 0,
        "currency": "ARS"
      },
      "sale_fee_criteria": {
        "min_fee_amount": 0,
        "max_fee_amount": 0,
        "percentage_of_fee_amount": 0,
        "currency": null
      }
    },
    "exceptions_by_category": [
    ]
  }
  ]
}

Condición de un ítem

Para definir si un producto es nuevo, usado o reacondicionado, será necesario enviar el atributo “item_condition” con el valor que se desea asignar. Para conocer los atributos que corresponden a una categoría y los valores que soportan te sugerimos revisar la documentación de Atributos.

Nota:
Si bien actualmente permitimos enviar si un item es nuevo o usado dentro del campo “condition”, en los casos de “reacondicionado” se deberá colocar como atributo.

Ejemplo:

 curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA30835/attributes

Respuesta:

{
    "id": "ITEM_CONDITION",
    "name": "Condición del ítem",
    "tags": {
      "hidden": true
    },
    "hierarchy": "ITEM",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230284",
        "name": "Nuevo"
      },
      {
        "id": "2230581",
        "name": "Usado"
      },
      {
        "id": "2230582",
        "name": "Reacondicionado"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },

Importante:
Cuando la publicación tiene condición “reacondicionado” es necesario cargar la Garantía del producto dentro de la sección "sale_terms".

Garantía del producto

Dentro de la sección “sale_terms” de un ítem, se deberá definir la garantía que tendrá el producto publicado. Para eso, habrá que pasar la información en una combinación de atributos:
Tipo de Garantía: representa las formas que puede tener esa garantía. Por ejemplo: garantía de vendedor, de fábrica, etc.
Tiempo de Garantía: representa el tiempo que tendrá vigencia esa garantía.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1642/sale_terms

Respuesta:

{
    "id": "WARRANTY_TYPE",
    "name": "Tipo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230279",
        "name": "Garantía de fábrica"
      },
      {
        "id": "2230280",
        "name": "Garantía del vendedor"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TIME",
    "name": "Tiempo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      },
      {
        "id": "años",
        "name": "años"
      },
      {
        "id": "meses",
        "name": "meses"
      }
    ],
    "default_unit": "días",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },

Nota:
Ten en cuenta que al momento de configurar un item como reacondicionado se deberá hacer con una garantía de 90 días o más. Mira más sobre Políticas de Publicación.

Publica un artículo

Importante:
El precio mínimo de las publicaciones de Mercado Libre Uruguay será de $50 (cincuenta pesos uruguayos) y en caso de no cumplirlo, estas serán pausadas. Podés ayudar a tus usuarios a modificar los precios de sus publicaciones actuales o creando una publicación con pack de productos. Por ejemplo: Pack de lápices por 10 unidades.

Estás listo para publicar tu primer artículo. Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor mira cómo obtener la Autenticación y Autorización para obtener tu access token. También te recomendamos utilizar usuarios de test para publicar artículos de prueba. Si aún no tiene tu usuario test, consulta cómo realizar pruebas y obtén el tuyo. Puedes crear un JSON para tu artículo en base al ejemplo a continuación o simplemente envíalo así y estarás publicando un producto de muestra en el site:

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d 
{
  "title":"Item de test - No Ofertar",
  "category_id":"MLA3530",
  "price":350,
  "currency_id":"ARS",
  "available_quantity":10,
  "buying_mode":"buy_it_now",
  "condition":"new",
  "listing_type_id":"gold_special",
  "sale_terms":[
     {
        "id":"WARRANTY_TYPE",
        "value_name":"Garantía del vendedor"
     },
     {
        "id":"WARRANTY_TIME",
        "value_name":"90 días"
     }
  ],
  "pictures":[
     {
        "source":"http://mla-s2-p.mlstatic.com/968521-MLA20805195516_072016-O.jpg"
     }
  ],
  "attributes":[
     {
        "id":"BRAND",
        "value_name":"Marca del producto"
     },
     {
        "id":"EAN",
        "value_name":"7898095297749"
     }
  ]
}
https://api.mercadolibre.com/items

Ejemplo:

{
    "id": "MLA880314064",
    "site_id": "MLA",
    "title": "Item De Test - No Ofertar",
    "subtitle": null,
    "seller_id": 629334160,
    "category_id": "MLA3530",
    "official_store_id": null,
    "price": 350,
    "base_price": 350,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 10,
    "available_quantity": 10,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantía",
            "value_id": "2230280",
            "value_name": "Garantía del vendedor",
            "value_struct": null,
            "values": [
                {
                    "id": "2230280",
                    "name": "Garantía del vendedor",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Tiempo de garantía",
            "value_id": null,
            "value_name": "90 días",
            "value_struct": {
                "number": 90,
                "unit": "días"
            },
            "values": [
                {
                    "id": null,
                    "name": "90 días",
                    "struct": {
                        "number": 90,
                        "unit": "días"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2020-09-23T18:31:16.342Z",
    "stop_time": "2040-09-18T04:00:00.000Z",
    "end_time": "2040-09-18T04:00:00.000Z",
    "expiration_time": "2020-12-12T18:31:16.398Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-880314064-item-de-test-no-ofertar-_JM",
    "pictures": [
        {
            "id": "971132-MLA43558185924_092020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": "YOUTUBE_ID_HERE",
    "descriptions": [ ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1126268188,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": -34.5545188,
        "longitude": -58.4915986
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Nuevo",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "GTIN",
            "name": "Código universal de producto",
            "value_id": null,
            "value_name": "7898095297749",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "7898095297749",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": null,
            "value_name": "Marca del producto",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "Marca del producto",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail_id": "971132-MLA43558185924_092020",
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment",
        "test_item"
    ],
    "warranty": "Garantía del vendedor: 90 días",
    "catalog_product_id": null,
    "domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-09-23T18:31:16.523Z",
    "last_updated": "2020-09-23T18:31:16.523Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Nota:
Si tienes problemas al intentar publicar, consulta la referencia de la tabla de códigos de Error de la API al final de esta guía.

Artículos con Mercado Pago obligatorio

Así como un user o una categoría pueden estar marcado con pago inmediato, también lo puede estar un ítem. Este escenario se presenta cuando:

  • Todas las publicaciones de MLB.
  • Todas las publicaciones de MLA y MLM por venta de productos con "condition": "new".
  • Las publicaciones de Tiendas Oficiales en todos los países con Mercado Pago.
  • Existen categorías con Mercado Pago como única opción (Para obtener más información dirígete a: “Usuario marcado automáticamente para que sus operaciones vayan por este flujo, con la marca “immediate_payment” en la API de users.
  • Vendedor “auto” marcado para que sus ventas vayan por este flujo.

Publica un artículo con pago inmediato

Si deseas que tu ítem se pueda abonar solamente con Mercado Pago, podrás definirlo al momento de crear un ítem nuevo, o bien modificar uno ya activo. Para eso, utilizarás el tag “inmediate_payment”.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
    "title": "Item de teste - Não Comprar",
    "category_id": "MLB437616",
    "price": 10,
    "currency_id": "BRL",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "description": "Publicação de teste, não comprar",
    "video_id": "YOUTUBE_ID_HERE",
    "tags": [
        "immediate_payment"
    ],
   "sale_terms":[
      {
         "id":"WARRANTY_TYPE",
         "value_name":"Garantia do vendedor"
      },
      {
         "id":"WARRANTY_TIME",
         "value_name":"90 días"
      }
   ],

    "pictures": [
         {
    "source": "https://www.motorino.com.br/site/wp-content/uploads/2018/01/produto_de_teste_amarelo_4_2_20171020224326-400x400.jpg"}

    ]
}
 
'
 
https://api.mercadolibre.com/items

Ejemplo:

{
    "id": "MLB1548991737",
    "site_id": "MLB",
    "title": "Item De Teste - Não Comprar",
    "subtitle": null,
    "seller_id": 419059118,
    "category_id": "MLB437616",
    "official_store_id": null,
    "price": 10,
    "base_price": 10,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "BRL",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantia",
            "value_id": "2230280",
            "value_name": "Garantia do vendedor",
            "value_struct": null,
            "values": [
                {
                    "id": "2230280",
                    "name": "Garantia do vendedor",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Tempo de garantia",
            "value_id": null,
            "value_name": "90 días",
            "value_struct": {
                "number": 90,
                "unit": "dias"
            },
            "values": [
                {
                    "id": null,
                    "name": "90 días",
                    "struct": {
                        "number": 90,
                        "unit": "dias"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2020-06-05T13:48:44.964Z",
    "stop_time": "2040-05-31T04:00:00.000Z",
    "end_time": "2040-05-31T04:00:00.000Z",
    "expiration_time": "2020-08-24T13:48:45.039Z",
    "condition": "new",
    "permalink": "http://produto.mercadolivre.com.br/MLB-1548991737-item-de-teste-no-comprar-_JM",
    "pictures": [
        {
            "id": "830983-MLB42088778762_062020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-PT.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-PT.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [ ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "me1",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "default",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1032937241,
        "comment": "",
        "address_line": "Rua Exemplo 123",
        "zip_code": "01234100",
        "city": {
            "id": "BR-SP-44",
            "name": "São Paulo"
        },
        "state": {
            "id": "BR-SP",
            "name": "São Paulo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "latitude": -23.6251244,
        "longitude": -46.7441422,
        "search_location": {
            "neighborhood": {
                "id": "TUxCQlZJTDI1OTI",
                "name": "Vila Andrade"
            },
            "city": {
                "id": "TUxCQ1NQLTkxMjE",
                "name": "São Paulo Zona Sul"
            },
            "state": {
                "id": "TUxCUFNBT085N2E4",
                "name": "São Paulo"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": -23.6251244,
        "longitude": -46.7441422
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230284",
            "value_name": "Novo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Novo",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-PT.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-PT.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "cart_eligible",
        "immediate_payment",
        "test_item"
    ],
    "warranty": "Garantia do vendedor: 90 días",
    "catalog_product_id": null,
    "domain_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-06-05T13:48:45.176Z",
    "last_updated": "2020-06-05T13:48:45.176Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Categorías con pago inmediato

Dentro de Mercado Libre existen categorías que exigen como única opción a Mercado Pago. Para saber si la categoría en la que se quiere publicar es una de ellas, consulta lo siguiente:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/categories/$CATEGORY_ID

"immediate_payment": "required",
    "item_conditions": [
      "new",
      "not_specified",
      "used"
    ],

Si tiene el campo "immediate_payment" en "required" es porque Mercado Pago es obligatorio. Si tiene “optional” es porque también acepta “Acuerdo con el vendedor”.



Publica un artículo en una Tienda Oficial


Nota:
Las marcas de publicación limitada solo podrán ser ofrecidas por Tiendas Oficiales y por vendedores acreditados por las marcas. Esta medida aplica:
- En Argentina, para Adidas y Reebok y Nike
- En Brasil, para Adidas y Reebok y Nike
- En Colombia, para Adidas y Reebok y Nike
- En México, para Adidas, Reebok y Nike
- En Peru, para Adidas y Reebok
- En Chile, para Adidas y Reebok

Publicar un artículo en una tienda oficial es lo mismo que publicar cualquier otro artículo, salvo que también debes agregar el atributo official_store_id en el JSON.

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
   "title":"Item de Test -No Ofertar",
   "category_id":"MLA5529",
   "price":10,
   "official_store_id":1,
   "currency_id":"ARS",
   "available_quantity":1,
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "condition":"new",
   "description":{
      "plain_text":"Item:, Ray-Ban WAYFARER Gloss Black RB2140 901 Model: RB2140. Size: 50mm. Name: WAYFARER. Color: Gloss Black. Includes Ray-Ban Carrying Case and Cleaning Cloth. New in Box"
   },
   "video_id":"YOUTUBE_ID_HERE",
   "sale_terms":[
      {
         "id":"WARRANTY_TYPE",
         "value_name":"Garantia do vendedor"
      },
      {
         "id":"WARRANTY_TIME",
         "value_name":"90 días"
      }
   ],

   "pictures":[
      {
         "source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
      },
      {
         "source":"http://en.wikipedia.org/wiki/File:Teashades.gif"
      }
   ]
}'https://api.mercadolibre.com/items

Si tu tienda es multimarca, debes especificar el official_store_id de la marca donde deseas publicar ese artículo. Consulta nuestra guía de Tiendas Oficiales para conocer más sobre este tema.


Selecciona el canal donde deseas ofertar productos

Importante:
Esta funcionalidad está disponible solo para Argentina, Brasil, México, Chile y Colombia, es decir, donde está activo Mercado Shops.

Utilizando el atributo exclusive_channel puedes elegir dónde publicar un artículo, ya sea solo en Mercado Libre, en Mercado Shops o en ambos canales. Los valores posibles son:
- Mercado Libre
- Mercado Shops

La presencia de este atributo determina en qué canal es visible el ítem de manera exclusiva y su ausencia indica que el ítem es visible en ambos canales. Un ítem con el atributo exclusive_channel con campo value_id en null, se comporta como si el atributo no existiera. A continuación puedes ver un ejemplo de un Ítem publicado exclusivamente en Mercado Shops:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...]
"attributes": [
  	{
		"id": "EXCLUSIVE_CHANNEL",
		"value_name": "Mercado Shops"
	}]
[...]
}
https://api.mercadolibre.com/items

El siguiente ejemplo corresponde a un ítem ofrecido exclusivamente en Mercado Libre:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
[...] 
"attributes": [
  	{
		"id": "EXCLUSIVE_CHANNEL",
		"value_name": "Mercado Libre"
	}]
[...]
}
https://api.mercadolibre.com/items

Conoce más sobre Mercado Shops.


Errores

Código de error Mensaje de error Descripción Posible solución
moderations.seller_id.not_authorized Seller is not authorized for this brand and category Ésta es una marca de publicación limitada. Para poder ofrecer sus productos en Mercado Libre debes ser un vendedor acreditado. El producto no será publicado. Esta restricción está activa en Argentina, Brasil, Colombia y México.
item.start_time.invalid La hora de inicio $startTime solo se puede actualizar en artículos NOT_YET_ACTIVE El campo hora de inicio no se puede actualizar. El parámetro start_time solo se puede actualizar si el estado del artículo es NOT_YET_ACTIVE.
item.category_id.invalid La categoría $categoryId no existe. Categoría no encontrada. Para ver las categorías disponibles, consulta page/sites/$siteId (Consulta $sideId).
item.category_id.invalid No se permite publicar en la categoría $categoryId. Asegúrate de publicar en una categoría hoja. $category.listing_allowed falso. Antes de publicar un artículo, asegúrate de publicar en la categoría elegida; consulta el parámetro listing_allowed en /categories/$categoryId.
item.buying_mode.invalid La categoría $categoryId solo soporta modos de publicación: $category.buyingModes. $item.buying_modes es inválido. Para ver los modos de publicación disponibles en categoría, consulta la página /categories/$categoryId en configuraciones de parámetros:{buying_modes:[…]}.
item.attributes.missing_required Los atributos $requiredAttributeIds son obligatorios para la categoría $item.categoryId. Controla que el atributo esté incluido en la lista de atributos o en la combinación de todos los atributos de variaciones. Categoría es un atributo obligatorio. Para ver los atributos obligatorios en esta categoría, consulta la página /categories/$categoryId/attributes en el parámetro {tags:{required:{true}}}.
item.listing_type_id.invalid listing_type_id inválido. El $item.listing_type_id es inválido. Para ver los tipos de publicaciones disponibles en la categoría, consulta la página /categories/$categoryId/listing_types.
item.listing_type_id.requiresPictures Las imágenes del artículo son obligatorias para el $item.listingTypeId del tipo de publicación. Las imágenes son obligatorias. Para ver si las imágenes son obligatorias en la categoría, consulta la página /categories/$categoryId/listing_types/silver en el parámetro requires_picture:{}.
item.site_id.invalid $item.siteId del site no existe. El $item.site_id es inválido. Para ver los sites disponibles, consulta la página /sites.
item.description.max El campo descripción es demasiado largo. No se permiten más de $maxSize caracteres. Cantidad de caracteres superada. La cantidad de caracteres en la descripción debe ser menor que 50.000 caracteres.
item.pictures.max Los artículos en $item.categoryId no pueden superar las imágenes $maxPicturesPerItem. Cantidad de imágenes superada. Para ver la cantidad de imágenes por artículo en la categoría, consulta la página /categories/$categoryId en el parámetro max_pictures_per_item:{}.
item.attributes.invalid_length Longitud de valor inválida para el atributo $it.attributeId. La longitud máxima es ${attribute.value_max_length}. Para ver los atributos max_length en este atributo, consulta la página /categories/$categoryId/attributes en el parámetro value_max_length para atributos con string [cadena] o número value_type.
seller.unable_to_list El vendedor no puede publicar. El vendedor por determinada causa no puede publicar. Identifica el campo “cause” dentro del response. - Consulta el significado de "cause" en /users#options ese status to list y podrás ver el significado.
- Prueba realizar una primer publicación manual desde Mi Cuenta de Mercado Libre para que aparezcan las advertencias en el flujo.

Advertencias

Código de advertencia Mensaje de error Descripción Posible solución
moderations.seller_id.not_authorized Seller is not authorized for this brand and category Ésta es una marca que debe ser acreditada, es decir, demostrar que se adquieren los productos a través de distribuidores o retailers autorizados por la marca en el país. Ingresar a Mercado Libre a la sección Ventas > Preferencias de ventas > Acreditaciones, seleccionar “Acreditar marca”, ingresar la marca a acreditar, adjuntar facturas de compra ¡y listo!

Referencias de código de respuesta HTTP

Items podrá devolver el código http 206 cuando no se haya podido obtener algún dato. Ten en cuenta que en la mayoría de los casos la información que recibas será suficiente para que puedas seguir trabajando.
En el header de respuesta X-Content-Missing tendrás el nombre de los campos sin información, que pueden ser "location", "geolocation" y/o "seller_address".

Llamada:

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

Respuesta http 200 OK:

{
    "id": "",
    "seller_id": ,
    ...
    "seller_address": {
        "id": 1011241361,
        "address_line": "Evaristo Lillo 112",
        "zip_code": "7200",
        "comment": "this is a comment",
        "city": {
            "id": "TUxDQ0xBUzU2MTEz",
            "name": "Las Condes"
        },
        "state": {
            "id": "CL-RM",
            "name": "RM (Metropolitana)"
        },
        "country": {
            "id": "CL",
            "name": "Chile"
        },
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "TUxDQ0xBUzU2MTEz",
                "name": "Las Condes"
            },
            "state": {
                "id": "TUxDUE1FVEExM2JlYg",
                "name": "RM (Metropolitana)"
            }
        },
        "latitude": -33.4140509,
        "longitude": -70.5814078
    },
    "location": {},
    "geolocation": {
        "latitude": -33.4140509,
        "longitude": -70.5814078
    },
    ...
}

Llamada:

curl -V https://api.mercadolibre.com/items/$ITEM_ID

Respuesta
< HTTP/1.1 206 Partial Content> X-Content-Missing: geolocation, seller_address:

{
    "id": "",
    "seller_id": ,
    ...
    "seller_address": {
        "id": 1011241361
    },
    "location": {},
    "geolocation": {},
    ...
}

Siguiente: Envío de productos.