Recursos Cross
Explora los recursos principales de nuestras APIs
Documentación
Puedes usar esta documentación para las siguientes unidades de negocio:
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_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLA1136716168Respuesta:
{
"id": "MLA1136716168",
"site_id": "MLA",
"title": "Zapatillas Avid Fof - Test Item",
"seller_id": 1108966308,
"category_id": "MLA109027",
"official_store_id": null,
"price": 15000,
"base_price": 15000,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 2,
--- No aparece sin token propietario
"available_quantity": 2,
--- No aparece sin token propietario
"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",
"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"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "11823494",
"value_name": "Propia"
},
{
"id": "FOOTWEAR_TYPE",
"name": "Tipo de calzado",
"value_id": "517583",
"value_name": "Zapatilla"
},
{
"id": "GENDER",
"name": "Género",
"value_id": "339666",
"value_name": "Hombre"
},
{
"id": "ITEM_CONDITION",
"name": "Condición del ítem",
"value_id": "2230284",
"value_name": "Nuevo"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": null,
"value_name": "EQ2122"
},
{
"id": "SIZE_GRID_ID",
"name": "ID de la guía de talles",
"value_id": null,
"value_name": "210052"
},
{
"id": "STYLE",
"name": "Estilo",
"value_id": "6694773",
"value_name": "Urbano"
}
],
"listing_source": "",
"variations": [
{
"id": 174497701554,
"price": 15000.00,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52049",
"value_name": "Negro"
},
{
"id": "SIZE",
"name": "Talle",
"value_id": "11505183",
"value_name": "45,0 AR"
],
"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"
{
"id": "SIZE",
"name": "Talle",
"value_id": "11505178",
"value_name": "44,0 AR"
}
],
"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,
"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", --- No aparece sin token propietario
"mshops" --- No aparece sin token propietario
],
"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
Antes de crear la descripción de un producto, debes crear la publicación sin descripción pero incluyendo todos los atributos e información detallada del ítem.
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_IDRespuesta:
{
"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
Antes de publicar un producto, utiliza el predictor de categorías para definir en base al título, la categoría adecuada donde publicar un producto. Recuerda que si el vendedor elige otra categoría que no sea la recomendada por Mercado Libre, será moderado. Si tu aplicación publica masivamente, te recomendamos realizar una validación de sus categorías previa a publicar los productos.
Modalidad de compra
La modalidad de compra inmediata ("buying_mode"="buy_it_now") garantiza que una order sólo aparecerá para el vendedor cuando el pago esté aprobado.
Precio
Es un atributo obligatorio: cuando defines un nuevo artículo, debe tener precio. Para consultar y editar precios debes utilizar la API de prices.
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
Conoce los diferentes tipos de publicación (listing_types).
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/attributesRespuesta:
{
"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_termsEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1642/sale_termsRespuesta:
{
"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"
},
Género de una publicación
En algunos dominios /domains/$DOMAIN_ID/technical_specs podrás encontrar que dentro de sus atributos principales se solicita la especificación del género "id": "GENDER". Más información de dominios y categorías aquí.
Este atributo tiene como finalidad detallar el género de una publicación y así poderlos segmentar con mayor facilidad al momento que el comprador quiera hacer una búsqueda selectiva dentro de las publicaciones. Ejemplo: Bicicleta disco hidraulico adulto.
El atributo género es una lista, que únicamente permite las siguientes opciones:
{
"attributes": [{
"id": "GENDER",
"name": "Género",
"value_type": "list",
"tags": [
"catalog_listing_required",
"grid_template_required",
"grid_filter",
"catalog_required",
"required"
],
"values": [{
"id": "339665",
"name": "Mujer"
},
{
"id": "339666",
"name": "Hombre"
},
{
"id": "339668",
"name": "Niñas"
},
{
"id": "339667",
"name": "Niños"
},
{
"id": "110461",
"name": "Sin género"
},
{
"id": "19159491",
"name": "Sin género infantil"
},
{
"id": "371795",
"name": "Bebés"
}
],
"hierarchy": "PARENT_PK",
"relevance": 1
}]
Donde la opción de “Sin género” estará enfocada en segmentar publicaciones unisex para adultos, mientras que “Sin género infantil” se enfocará únicamente para publicaciones unisex de niños.
El atributo GENDER principalmente se encuentra en dominios de moda, para los cuales debes recordar que la guía de talles es obligatoria. Posterior al PUT o POST del recurso /items si usaste un género que no se encuentra en la lista de la ficha técnica, mostrará el siguiente error impidiendo la creación de la nueva publicación, hasta que realices la respectiva corrección:
{
"department": "structured-data",
"cause_id": 2516,
"type": "error",
"code": "error.item.attribute.business_conditional.value_name",
"references": [
"item.name"
],
"message": "Attribute [GENDER] is not valid"
}Adicionalmente, el atributo de título para publicaciones donde el GENDER es requerido, será validado y devolverá error en caso de que el título “title" haga referencia a un género diferente, al que se especificó en el atributo "id": "GENDER", puedes consultar el detalle de las validaciones.
Publica un artículo
Antes de publicar un producto, te recomendamos utilizar usuarios de test para publicar artículos de prueba. Si aún no tienes 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/itemsEjemplo:
{
"id": "MLA880314064",
"site_id": "MLA",
"title": "Item De Test - No Ofertar",
"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"
},
{
"id": "WARRANTY_TIME",
"name": "Tiempo de garantía",
"value_id": null,
"value_name": "90 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"
{
"id": "GTIN",
"name": "Código universal de producto",
"value_id": null,
"value_name": "7898095297749",
"value_struct": null
{
"id": "BRAND",
"name": "Marca",
"value_id": null,
"value_name": "Marca del producto"
}
],
"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,
"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.
Conoce más sobre las Validaciones para publicar.
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/itemsEjemplo:
{
"id": "MLB1548991737",
"site_id": "MLB",
"title": "Item De Teste - Não Comprar",
"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"
},
{
"id": "WARRANTY_TIME",
"name": "Tempo de garantia",
"value_id": null
}
],
"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"
}
],
"listing_source": "",
"variations": [],
"thumbnail": "http://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,
"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/itemsSi 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.
Publicar en Mercado Shops
Al crear una nueva publicación puedes definir, mediante el array channels, en qué canal quieres ofertar (Mercado Libre y/o Mercado Shops).
Conoce más sobre como publicar en Mercado Shops.
A continuación puedes ver un ejemplo de un Ítem publicado exclusivamente en Mercado Shops:
Errores
| Código de error | Mensaje de error | Descripción | Posible solución |
|---|---|---|---|
| item.category_id.invalid | Category $CATEGORY_ID does not exist. | La categoría enviada no existe | Consulta las categorías disponibles por site. |
| body.invalid_fields | The fields [$FIELD_ID] are invalid for requested call. | El campo $FIELD_ID es invalido para la categoría. | Consulta los campos válidos en /categories/$CATEGORY_ID |
| seller.unable_to_list | The seller is not allowed to publish. | 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 primera publicación manual desde Mi Cuenta de Mercado Libre para que aparezcan las advertencias en el flujo. |
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.
Siguiente: Envío de productos.