Publicar productos
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
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
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.
- 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:
- Para productos compatibles SIN marca:
- Separa las palabras con espacios no uses signos de puntuación ni símbolos.
- Revisa que no tenga errores de ortografía.
Ejemplo: Microondas Grill BGH Quick Chef B223D plata 23L 220V
[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
[Nombre del producto] + “para” o “compatible con” + [Marcas con la que es compatible]:
Ejemplo:
- Adaptador para speaker Tedge
- Adaptador compatible con speaker Tedge
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.
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.
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"
},
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"
},
Publica un artículo
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": []
}
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
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
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.