Documentação do Mercado Shops

Confira todas as informações necessárias sobre as APIs Mercado Shops.
circulos azuis em degrade
Última atualização em 15/09/2023

Campanhas com parcelamento

Atualmente, contamos com novas campanhas de parcelamento ao mesmo preço que você publica para o canal Mshops:

  • 3 parcelas: em publicações Premium poderá escolher oferecer até 3 parcelas ao mesmo preço que você publica e pagar menos na tarifa de venda em sua loja do Mercado Shops. Você pagará 5,99%*. Assim, poderá oferecer preços mais competitivos. Para isso, modifique suas publicações e ative a opção de mshops_3x_campaign. Se você tem publicações Clássicas, altere para Premium e aproveite este benefício. Esta campanha está disponível para todos os vendedores.
*As campanhas aplicam exclusivamente a vendas no canal do MShops.

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_ID

Exemplo:

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

Resposta:


{
    "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_ID

Exemplo:

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/MLA810693730

Resposta:

{
    "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_ID

Exemplo:

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/MLA810693730

Resposta:

{
   "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": []
}