Documentação do Mercado Shops
Confira todas as informações necessárias sobre as APIs Mercado Shops.
Documentação do
Última atualização em 15/09/2023
Campanhas com parcelamento
Publicações em campanha
Para consultar se um produto está habilitado na campanha de 3 parcelas ao mesmo preço que você publica, faça um GET ao recurso /items com o seu item_id e verifique que tenha a tag mshops_3x_campaign nos campos.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1234123456Resposta:
{
"id": "MLA1234123456",
"site_id": "MLA",
"title": "Procesador De Alimentos",
"subtitle": null,
"seller_id": 553421365,
"category_id": "MLA3530",
"official_store_id": null,
"price": 34345345,
"base_price": 34345345,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 1000,
"available_quantity": 500,
"sold_quantity": 150,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantía",
"value_id": "6150835",
"value_name": "Sin garantía",
"value_struct": null,
"values": [
{
"id": "6150835",
"name": "Sin garantía",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2022-05-16T16:54:20.000Z",
"stop_time": "2042-05-11T04:00:00.000Z",
"condition": "new",
"permalink": "https://articulo.mercadolibre.com.ar/MLA-1137574968-procesador-de-alimentos-_JM",
"thumbnail_id": "979379-MLA45885016540_052021",
"thumbnail": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
"secure_thumbnail": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-I.jpg",
"pictures": [
{
"id": "979379-MLA45885016540_052021",
"url": "http://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
"secure_url": "https://http2.mlstatic.com/D_979379-MLA45885016540_052021-O.jpg",
"size": "385x500",
"max_size": "459x596",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "not_specified",
"methods": [],
"tags": [],
"dimensions": null,
"local_pick_up": false,
"free_shipping": false,
"logistic_type": "not_specified",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"city": {
"name": "CABA"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"search_location": {
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
},
"id": 1098928639
},
"seller_contact": null,
"location": {},
"coverage_areas": [],
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "276243",
"value_name": "Genérica",
"value_struct": null,
"values": [
{
"id": "276243",
"name": "Genérica",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"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"
}
],
"warnings": [],
"listing_source": "",
"variations": [],
"status": "active",
"sub_status": [],
"tags": [
"good_quality_picture",
"standard_price_by_channel",
"test_item",
"immediate_payment",
"mshops_ahora-12"
],
"warranty": "Sin garantía",
"catalog_product_id": null,
"domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2022-05-16T16:54:20.000Z",
"last_updated": "2022-07-12T15:17:19.561Z",
"health": 0.8,
"catalog_listing": false,
"channels": [
"marketplace",
"mshops"
]Criar uma campanha
Para criar um item em uma campanha, realize o POST ao recurso /items incluindo a tag mshops_3x_campaign. Considere sempre enviar o atributo buying_mode, já que é requerido no POST para criar um item.
Os itens habilitados para oferecer até 3 parcela com a participação do programa mshops_3x_campaign devem ser produtos novos e sua publicação deve ser Premium, ou seja, apenas aquelas com listing_type_id: gold_pro.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items
{
"id": "MLA1150799152",
"site_id": "MLA",
"title": "Motorola G6 Plus 64 Gb Negro",
"subtitle": null,
"seller_id": 553421365,
"category_id": "MLA1055",
"official_store_id": null,
"price": 15499,
"base_price": 15499,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 150,
"available_quantity": 150,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantía",
"value_id": "6150835",
"value_name": "Sin garantía",
"value_struct": null,
"values": [
{
"id": "6150835",
"name": "Sin garantía",
"struct": null
}
]
},
{
"id": "INSTALLMENTS_CAMPAIGN",
"name": "Campaña de cuotas",
"value_id": null,
"value_name": "mshops_3x_campaign",
"value_struct": null,
"values": [
{
"id": null,
"name": "mshops_3x_campaign",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2022-08-09T19:09:40.763Z",
"stop_time": "2042-08-04T04:00:00.000Z",
"end_time": "2042-08-04T04:00:00.000Z",
"expiration_time": "2022-10-28T19:09:40.899Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-1150799152-motorola-g6-plus-64-gb-negro-_JM",
"pictures": [
{
"id": "735698-MLA32074836338_092019",
"url": "http://mla-s2-p.mlstatic.com/735698-MLA32074836338_092019-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/735698-MLA32074836338_092019-O.jpg",
"size": "500x500",
"max_size": "500x500",
"quality": ""
},
{
"id": "975594-MLA31982048508_082019",
"url": "http://mla-s2-p.mlstatic.com/975594-MLA31982048508_082019-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/975594-MLA31982048508_082019-O.jpg",
"size": "499x428",
"max_size": "975x836",
"quality": ""
},
{
"id": "653748-MLA31045072854_062019",
"url": "http://mla-s1-p.mlstatic.com/653748-MLA31045072854_062019-O.jpg",
"secure_url": "https://mla-s1-p.mlstatic.com/653748-MLA31045072854_062019-O.jpg",
"size": "500x430",
"max_size": "1268x1092",
"quality": ""
},
{
"id": "842262-MLA31045082089_062019",
"url": "http://mla-s2-p.mlstatic.com/842262-MLA31045082089_062019-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/842262-MLA31045082089_062019-O.jpg",
"size": "492x500",
"max_size": "1118x1136",
"quality": ""
},
{
"id": "935916-MLA31045069993_062019",
"url": "http://mla-s1-p.mlstatic.com/935916-MLA31045069993_062019-O.jpg",
"secure_url": "https://mla-s1-p.mlstatic.com/935916-MLA31045069993_062019-O.jpg",
"size": "491x500",
"max_size": "1118x1138",
"quality": ""
},
{
"id": "785394-MLA31045072385_062019",
"url": "http://mla-s2-p.mlstatic.com/785394-MLA31045072385_062019-O.jpg",
"secure_url": "https://mla-s2-p.mlstatic.com/785394-MLA31045072385_062019-O.jpg",
"size": "492x500",
"max_size": "1118x1136",
"quality": ""
}
],
"video_id": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_shipping": true,
"methods": [],
"dimensions": null,
"tags": [
"self_service_in"
],
"logistic_type": "drop_off",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 1098928639,
"comment": "",
"address_line": "Test 123",
"zip_code": "1111",
"city": {
"id": "",
"name": "CABA"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.60380890108137,
"longitude": -58.38289435479972,
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "",
"name": ""
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.60380890108137,
"longitude": -58.38289435479972
},
"coverage_areas": [],
"attributes": [
{
"id": "OPERATING_SYSTEM_VERSION",
"name": "Versión del sistema operativo",
"value_id": "7206959",
"value_name": "8.0 Oreo",
"value_struct": null,
"values": [
{
"id": "7206959",
"name": "8.0 Oreo",
"struct": null
}
],
"attribute_group_id": "",
"attribute_group_name": ""
},
{
"id": "PIXELS_PER_INCH",
"name": "Píxeles por pulgada",
"value_id": "7075680",
"value_name": "409 ppi",
"value_struct": {
"number": 409,
"unit": "ppi"
},
"values": [
{
"id": "7075680",
"name": "409 ppi",
"struct": {
"number": 409,
"unit": "ppi"
}
}
],
"attribute_group_id": "",
"attribute_group_name": ""
},
{
"id": "SCREEN_TECHNOLOGY",
"name": "Tecnología de pantalla",
"value_id": "80490",
"value_name": "IPS",
"value_struct": null,
"values": [
{
"id": "80490",
"name": "IPS",
"struct": null
}
],
"attribute_group_id": "",
"attribute_group_name": ""
},
{
"id": "WITH_SLOW_MOTION_CAMERA_FUNCTION",
"name": "Con función de cámara lenta",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "",
"attribute_group_name": ""
},
{
"id": "WITH_TOUCH_SCREEN",
"name": "Con pantalla táctil",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "",
"attribute_group_name": ""
},
{
"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": "BATTERY_CAPACITY",
"name": "Capacidad de la batería",
"value_id": "134141",
"value_name": "3200 mAh",
"value_struct": {
"number": 3200,
"unit": "mAh"
},
"values": [
{
"id": "134141",
"name": "3200 mAh",
"struct": {
"number": 3200,
"unit": "mAh"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "BATTERY_TYPE",
"name": "Tipo de batería",
"value_id": "7439811",
"value_name": "Li-Ion",
"value_struct": null,
"values": [
{
"id": "7439811",
"name": "Li-Ion",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "BRAND",
"name": "Marca",
"value_id": "2503",
"value_name": "Motorola",
"value_struct": null,
"values": [
{
"id": "2503",
"name": "Motorola",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "CARRIER",
"name": "Compañía telefónica",
"value_id": "298335",
"value_name": "Liberado",
"value_struct": null,
"values": [
{
"id": "298335",
"name": "Liberado",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "DEPTH",
"name": "Profundidad",
"value_id": "4604272",
"value_name": "8 mm",
"value_struct": {
"number": 8,
"unit": "mm"
},
"values": [
{
"id": "4604272",
"name": "8 mm",
"struct": {
"number": 8,
"unit": "mm"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "DISPLAY_RESOLUTION",
"name": "Resolución de la pantalla",
"value_id": "7207009",
"value_name": "1080 px x 2160 px",
"value_struct": null,
"values": [
{
"id": "7207009",
"name": "1080 px x 2160 px",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "FRONT_CAMERA_RECORDING_RESOLUTION",
"name": "Resolución de video de la cámara frontal",
"value_id": "7173215",
"value_name": "1920 px x 1080 px",
"value_struct": null,
"values": [
{
"id": "7173215",
"name": "1920 px x 1080 px",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "HEIGHT",
"name": "Altura",
"value_id": "6900532",
"value_name": "159.9 mm",
"value_struct": {
"number": 159.9,
"unit": "mm"
},
"values": [
{
"id": "6900532",
"name": "159.9 mm",
"struct": {
"number": 159.9,
"unit": "mm"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59726",
"value_name": "64 GB",
"value_struct": {
"number": 64,
"unit": "GB"
},
"values": [
{
"id": "59726",
"name": "64 GB",
"struct": {
"number": 64,
"unit": "GB"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "IS_WATERPROOF",
"name": "Es a prueba de agua",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "59187",
"value_name": "Moto",
"value_struct": null,
"values": [
{
"id": "59187",
"name": "Moto",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MAIN_FRONT_CAMERA_RESOLUTION",
"name": "Resolución de la cámara frontal principal",
"value_id": "7207052",
"value_name": "8 Mpx",
"value_struct": {
"number": 8,
"unit": "Mpx"
},
"values": [
{
"id": "7207052",
"name": "8 Mpx",
"struct": {
"number": 8,
"unit": "Mpx"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MAIN_REAR_CAMERA_RESOLUTION",
"name": "Resolución de la cámara trasera principal",
"value_id": "7199628",
"value_name": "12 Mpx",
"value_struct": {
"number": 12,
"unit": "Mpx"
},
"values": [
{
"id": "7199628",
"name": "12 Mpx",
"struct": {
"number": 12,
"unit": "Mpx"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MEMORY_CARD_TYPES",
"name": "Tipos de tarjeta de memoria",
"value_id": "7199655",
"value_name": "Micro-SD",
"value_struct": null,
"values": [
{
"id": "7199655",
"name": "Micro-SD",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MOBILE_NETWORK",
"name": "Red",
"value_id": "367876",
"value_name": "4G/LTE",
"value_struct": null,
"values": [
{
"id": "367876",
"name": "4G/LTE",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "2915826",
"value_name": "G6 Plus",
"value_struct": null,
"values": [
{
"id": "2915826",
"name": "G6 Plus",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7403813",
"value_name": "Android",
"value_struct": null,
"values": [
{
"id": "7403813",
"name": "Android",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "PROCESSOR_CORES_NUMBER",
"name": "Cantidad de núcleos del procesador",
"value_id": "7206961",
"value_name": "8",
"value_struct": null,
"values": [
{
"id": "7206961",
"name": "8",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "PROCESSOR_MODEL",
"name": "Modelo del procesador",
"value_id": "6900526",
"value_name": "Snapdragon 630",
"value_struct": null,
"values": [
{
"id": "6900526",
"name": "Snapdragon 630",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "PROCESSOR_SPEED",
"name": "Velocidad del procesador",
"value_id": "366052",
"value_name": "2.2 GHz",
"value_struct": {
"number": 2.2,
"unit": "GHz"
},
"values": [
{
"id": "366052",
"name": "2.2 GHz",
"struct": {
"number": 2.2,
"unit": "GHz"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "98852",
"value_name": "4 GB",
"value_struct": {
"number": 4,
"unit": "GB"
},
"values": [
{
"id": "98852",
"name": "4 GB",
"struct": {
"number": 4,
"unit": "GB"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "REAR_CAMERAS_NUMBER",
"name": "Cantidad de cámaras traseras",
"value_id": "7477262",
"value_name": "2",
"value_struct": null,
"values": [
{
"id": "7477262",
"name": "2",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "REAR_CAMERAS_RESOLUTION",
"name": "Resolución de las cámaras traseras",
"value_id": "7439826",
"value_name": "12 Mpx/5 Mpx",
"value_struct": null,
"values": [
{
"id": "7439826",
"name": "12 Mpx/5 Mpx",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "REAR_CAMERA_APERTURE",
"name": "Apertura del diafragma de la cámara trasera",
"value_id": "7444342",
"value_name": "f 1.7/f 2.2",
"value_struct": null,
"values": [
{
"id": "7444342",
"name": "f 1.7/f 2.2",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "REAR_CAMERA_RECORDING_RESOLUTION",
"name": "Resolución de video de la cámara trasera",
"value_id": "7199630",
"value_name": "3840 px x 2160 px",
"value_struct": null,
"values": [
{
"id": "7199630",
"name": "3840 px x 2160 px",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "STANDBY_TIME",
"name": "Duración de la batería en espera",
"value_id": "6900533",
"value_name": "495 h",
"value_struct": {
"number": 495,
"unit": "h"
},
"values": [
{
"id": "6900533",
"name": "495 h",
"struct": {
"number": 495,
"unit": "h"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "TALK_TIME",
"name": "Tiempo de conversación",
"value_id": "6900530",
"value_name": "27 h",
"value_struct": {
"number": 27,
"unit": "h"
},
"values": [
{
"id": "6900530",
"name": "27 h",
"struct": {
"number": 27,
"unit": "h"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WEIGHT",
"name": "Peso",
"value_id": "2087871",
"value_name": "167 g",
"value_struct": {
"number": 167,
"unit": "g"
},
"values": [
{
"id": "2087871",
"name": "167 g",
"struct": {
"number": 167,
"unit": "g"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WIDTH",
"name": "Ancho",
"value_id": "6900525",
"value_name": "75.5 mm",
"value_struct": {
"number": 75.5,
"unit": "mm"
},
"values": [
{
"id": "6900525",
"name": "75.5 mm",
"struct": {
"number": 75.5,
"unit": "mm"
}
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_ACCELEROMETER",
"name": "Con acelerómetro",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_BLUETOOTH",
"name": "Con Bluetooth",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_CAMERA",
"name": "Con cámara",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_ESIM",
"name": "Con eSIM",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_FINGERPRINT_READER",
"name": "Con lector de huella digital",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_FRONT_CAMERA_FLASH",
"name": "Con flash en la cámara frontal",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_GPS",
"name": "Con GPS",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_GYROSCOPE",
"name": "Con giroscopio",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_IMEI",
"name": "Con IMEI",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_MINI_HDMI",
"name": "Con mini HDMI",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_PHYSICAL_QWERTY_KEYBOARD",
"name": "Con teclado QWERTY físico",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_PROXIMITY_SENSOR",
"name": "Con sensor de proximidad",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_RADIO",
"name": "Con radio",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_REMOVABLE_BATTERY",
"name": "Con batería removible",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_TV_TUNER",
"name": "Con sintonizador de TV",
"value_id": "242084",
"value_name": "No",
"value_struct": null,
"values": [
{
"id": "242084",
"name": "No",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_USB_CONNECTOR",
"name": "Con conector USB",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "WITH_WIFI",
"name": "Con Wi-Fi",
"value_id": "242085",
"value_name": "Sí",
"value_struct": null,
"values": [
{
"id": "242085",
"name": "Sí",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
],
"warnings": [
{
"department": "items",
"cause_id": 145,
"code": "item.attributes.invalid",
"message": "Attribute: MAX_MEMORY_CARD_CAPACITY was dropped because does not exists",
"references": [
"item.attributes"
]
},
{
"department": "items",
"cause_id": 145,
"code": "item.attributes.invalid",
"message": "Attribute: CPU_MODEL was dropped because does not exists",
"references": [
"item.attributes"
]
},
{
"department": "items",
"cause_id": 145,
"code": "item.attributes.invalid",
"message": "Attribute: NUMBER_OF_SIM_CARD_SLOTS was dropped because does not exists",
"references": [
"item.attributes"
]
},
{
"department": "items",
"cause_id": 315,
"code": "item.price.dropped",
"message": "Item price was dropped by the highest-price variation.",
"references": [
"item.price"
]
},
{
"department": "items",
"cause_id": 145,
"code": "item.attributes.invalid",
"message": "Attribute: SIM_SIZES was dropped because does not exists",
"references": [
"item.attributes"
]
}
],
"listing_source": "",
"variations": [
{
"id": 174989635966,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "Blanco",
"value_struct": null,
"values": [
{
"id": "52055",
"name": "Blanco",
"struct": null
}
]
}
],
"price": 15499,
"available_quantity": 150,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"975594-MLA31982048508_082019",
"653748-MLA31045072854_062019",
"842262-MLA31045082089_062019",
"935916-MLA31045069993_062019",
"785394-MLA31045072385_062019"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [],
"inventory_id": null,
"item_relations": []
}
],
"thumbnail_id": "975594-MLA31982048508_082019",
"thumbnail": "http://mla-s2-p.mlstatic.com/975594-MLA31982048508_082019-I.jpg",
"secure_thumbnail": "https://mla-s2-p.mlstatic.com/975594-MLA31982048508_082019-I.jpg",
"status": "active",
"sub_status": [],
"tags": [
"cart_eligible",
"immediate_payment",
"mshops_3x_campaign",
"test_item"
],
"warranty": "Sin garantía",
"catalog_product_id": null,
"domain_id": "MLA-CELLPHONES",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2022-08-09T19:09:41.022Z",
"last_updated": "2022-08-09T19:09:41.022Z",
"health": null,
"catalog_listing": false,
"item_relations": [],
"channels": [
"mshops"
]
}Exemplo:
{
"id": "MLA810693730",
"site_id": "MLA",
"title": "Item De Test - No Ofertar",
"subtitle": null,
"seller_id": 443024908,
"category_id": "MLA3530",
"official_store_id": null,
"price": 100,
"base_price": 100,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2019-08-22T17:33:51.000Z",
"stop_time": "2039-08-17T04:00:00.000Z",
"end_time": "2039-08-17T04:00:00.000Z",
"expiration_time": "2019-11-10T17:33:51.000Z",
"condition": "new",
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"international_delivery_mode": "none",
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.5780655,
"longitude": -58.4265317
},
"coverage_areas": [],
"warnings": [],
"listing_source": "",
"variations": [],
"status": "active",
"sub_status": [],
"tags": [
"mshops_ahora-12",
"immediate_payment",
"test_item"
],
"warranty": null,
"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": "2019-08-22T17:33:51.000Z",
"last_updated": "2019-08-22T18:37:41.468Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}Lembre-se que retornaremos um HTTP error 400 sempre que não cumprir os requisitos nos casos em que:
- A exposição da publicação seja diferente de Premium.
Habilitar uma campanha
Para habilitar a campanha em um item, deverá realizar um PUT ao recurso /items incluindo o mshops_3x_campaign. Considere que se o item tem outras tags, também deverão ser enviados na modificação.
Os itens habilitados para oferecer até 3 parcela com a participação do programa mshops_3x_campaign devem ser produtos novos e sua publicação deve ser Premium, ou seja, apenas aquelas com listing_type_id: gold_pro.
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"tags":[
"cart_eligible",
"immediate_payment",
"test_item",
"mshops_3x_campaign"
]
}
https://api.mercadolibre.com/items/$ITEM_IDExemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"tags":[
"cart_eligible",
"immediate_payment",
"test_item",
"mshops_3x_campaign"
]
}
https://api.mercadolibre.com/items/MLA810693730Resposta:
{
"id": "MLA1150847088",
"site_id": "MLA",
"title": "Teste - Não Ofertar",
"subtitle": null,
"seller_id": 553421365,
"category_id": "MLA109027",
"official_store_id": null,
"price": 65,
"base_price": 65,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 10,
"available_quantity": 10,
"sold_quantity": 0,
"sale_terms": [
{
"id": "INSTALLMENTS_CAMPAIGN",
"name": "Campaña de cuotas",
"value_id": null,
"value_name": "mshops_3x_campaign",
"value_struct": null,
"values": [
{
"id": null,
"name": "mshops_3x_campaign",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2022-08-09T20:41:47.000Z",
"stop_time": "2042-08-04T04:00:00.000Z",
"end_time": "2042-08-04T04:00:00.000Z",
"expiration_time": "2022-10-28T20:41:47.000Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-1150847088-teste-no-ofertar-_JM",
"pictures": [
{
"id": "730122-MLA51062700753_082022",
"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": null,
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"shipping": {
"mode": "me2",
"local_pick_up": false,
"free_shipping": false,
"methods": [],
"dimensions": null,
"tags": [
"self_service_in"
],
"logistic_type": "drop_off",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"id": 1098928639,
"comment": "",
"address_line": "Test 123",
"zip_code": "1111",
"city": {
"id": "",
"name": "CABA"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"country": {
"id": "AR",
"name": "Argentina"
},
"latitude": -34.60380890108137,
"longitude": -58.38289435479972,
"search_location": {
"neighborhood": {
"id": "",
"name": ""
},
"city": {
"id": "",
"name": ""
},
"state": {
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal"
}
}
},
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.60380890108137,
"longitude": -58.38289435479972
},
"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": "BRAND",
"name": "Marca",
"value_id": null,
"value_name": "Sneakers",
"value_struct": null,
"values": [
{
"id": null,
"name": "Sneakers",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "GTIN",
"name": "Código universal de producto",
"value_id": null,
"value_name": "764536155299",
"value_struct": null,
"values": [
{
"id": null,
"name": "764536155299",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "SIZE_GRID_ID",
"name": "ID de la guía de talles",
"value_id": null,
"value_name": "212003",
"value_struct": null,
"values": [
{
"id": null,
"name": "212003",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"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"
},
{
"id": "GENDER",
"name": "Género",
"value_id": null,
"value_name": "Mulher",
"value_struct": null,
"values": [
{
"id": null,
"name": "Mulher",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": null,
"value_name": "Novíssimo",
"value_struct": null,
"values": [
{
"id": null,
"name": "Novíssimo",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
}
],
"warnings": [],
"listing_source": "",
"variations": [
{
"id": 174990023755,
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "52028",
"value_name": "Azul",
"value_struct": null,
"values": [
{
"id": "52028",
"name": "Azul",
"struct": null
}
]
},
{
"id": "SIZE",
"name": "Talle",
"value_id": "3259454",
"value_name": "44",
"value_struct": null,
"values": [
{
"id": "3259454",
"name": "44",
"struct": null
}
]
}
],
"price": 65,
"available_quantity": 10,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
"730122-MLA51062700753_082022"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
{
"id": "SIZE_GRID_ROW_ID",
"name": "ID de la fila de la guía de talles",
"value_id": null,
"value_name": "212003:1",
"value_struct": null,
"values": [
{
"id": null,
"name": "212003:1",
"struct": null
}
]
}
],
"inventory_id": null,
"item_relations": []
}
],
"thumbnail_id": "730122-MLA51062700753_082022",
"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": [
"cart_eligible",
"immediate_payment",
"mshops_3x_campaign",
"test_item"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-SNEAKERS",
"seller_custom_field": null,
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2022-08-09T20:41:48.000Z",
"last_updated": "2022-08-09T20:44:08.251Z",
"health": null,
"catalog_listing": false,
"item_relations": [],
"channels": [
"mshops"
]
}Lembre-se que retornaremos um HTTP error 400 sempre que não cumprir os requisitos nos casos em que:
- A exposição da publicação seja diferente de Premium.
Desabilitar uma campanha
Para desabilitar a campanha em um item, deverá realizar um PUT ao recurso /items, incluindo todas as tags que tinha anteriormente, exceto o mshops_3x_campaign.
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"tags": [
"immediate_payment",
"test_item"
],
}
https://api.mercadolibre.com/items/$ITEM_IDExemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"tags": [
"immediate_payment",
"test_item"
],
}
https://api.mercadolibre.com/items/MLA810693730Resposta:
{
"id": "MLA810693730",
"site_id": "MLA",
"title": "Item De Test - No Ofertar",
"subtitle": null,
"seller_id": 443024908,
"category_id": "MLA3530",
"official_store_id": null,
"price": 100,
"base_price": 100,
"original_price": null,
"inventory_id": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_pro",
"start_time": "2019-08-22T17:33:51.000Z",
"stop_time": "2039-08-17T04:00:00.000Z",
"end_time": "2039-08-17T04:00:00.000Z",
"expiration_time": "2019-11-10T17:33:51.000Z",
"condition": "new",
"descriptions": [],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [],
"international_delivery_mode": "none",
"seller_contact": null,
"location": {},
"geolocation": {
"latitude": -34.5780655,
"longitude": -58.4265317
},
"coverage_areas": [],
"warnings": [],
"listing_source": "",
"variations": [],
"status": "active",
"sub_status": [],
"tags": [
"immediate_payment",
"test_item"
],
"warranty": null,
"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": "2019-08-22T17:33:51.000Z",
"last_updated": "2019-08-22T18:37:41.468Z",
"health": null,
"catalog_listing": false,
"item_relations": []
}