Publica produtos

Agora que já analisamos os assuntos autenticação, usuários e categorias, acreditamos que você esteja pronto para realizar sua primeira publicação. Leia o tutorial e aprenda a fazer isso.

Conteúdos

→Princípios básicos
→Resultados das publicações
→Página detalhes do produto
→Campos do produto
→Definição de atributos
    ↳Title
    ↳Description
    ↳Condition
    ↳Available quantity
    ↳Pictures
    ↳Category
    ↳Modalidade de compra
    ↳Price
    ↳Currency
    ↳Payment methods
    ↳Shipping
    ↳Identificadores de produtos
    ↳SKU
   
↳Variações
→Tipos de publicação
→Condição de um item
→Garantia do produto
→Publicação de um anúncio
→Items com Mercado Pago obrigatório
→Publique seu item com Pagamento Imediato
→Categorias com pagamento imediato
→Publicação de um anúncio em uma Loja Oficial
→Selecione o canal no qual deseja oferecer produtos
→Referências de código de erro da API
→Referências de código de resposta HTTP


Princípios básicos

Na API do Mercado Livre, as publicações são itens que contêm produtos e outros atributos que você pode vender ou comprar. Os usuários não podem trocar informações de contato imediatamente. Por isso, toda vez que há intenção de comprar um produto, os potenciais compradores podem formular tantas perguntas quantas quiserem sobre o produto e, quando estiverem prontos, devem fazer uma oferta pelo produto do vendedor para que um pedido seja criado, tanto para o comprador quanto para o vendedor, detalhando a transação como venda ou compra para cada um deles. É nesse momento que as informações de contato ficam automaticamente visíveis para ambos os usuários.


Resultados das publicações

Todos os produtos que você publicar aparecerão nos resultados das publicações de uma determinada busca. Por exemplo, quando um usuário estiver buscando a consulta “ipod”, ele obterá como resultado uma lista de todos os produtos relacionados. Seu produto pode estar nessa lista. Quando alguém clica em um produto, a página Detalhes do produto é exibida junto com todas as informações sobre o produto que tenham sido fornecidas no momento da publicação. Para obter mais informações, continue lendo a respeito.


Página detalhes do produto

Quando um usuário seleciona um produto no resultado, essa página mostra os seguintes detalhes do produto:

  • Item_id
  • Title
  • Category
  • Pictures
  • Price
  • City
  • Sold quantity
  • Questions
  • Seller’s reputation
  • Detailed description

Campos do produto

Agora vamos ver um produto normal detalhadamente. Isso é fácil, pois você só precisa conhecer o item_id associado ao produto e, como ele é público, pode obtê-lo na página Detalhes do produto na parte superior da página, conforme mostrado na imagem do exemplo: É preciso acrescentar o site_id antes do número e pronto. Agora você pode chamar o recurso Items para obter todas as informações associadas:

Chamada:

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

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLB1191972200

Resposta:

{
    "id": "MLB1191972200",
    "site_id": "MLB",
    "title": "iPhone Xs  64gb",
    "subtitle": null,
    "seller_id": 386261073,
    "category_id": "MLB1055",
    "official_store_id": 2162,
    "price": 7299,
    "base_price": 7299,
    "original_price": null,
    "currency_id": "BRL",
    "initial_quantity": 5,
    "available_quantity": 2,
    "sold_quantity": 0,
    "sale_terms": [
        {
            "id": "WARRANTY_TYPE",
            "name": "Tipo de garantia",
            "value_id": "2230279",
            "value_name": "Garantia de fábrica",
            "value_struct": null,
            "values": [
                {
                    "id": "2230279",
                    "name": "Garantia de fábrica",
                    "struct": null
                }
            ]
        },
        {
            "id": "WARRANTY_TIME",
            "name": "Tempo de garantia",
            "value_id": null,
            "value_name": "12 meses",
            "value_struct": {
                "number": 12,
                "unit": "meses"
            },
            "values": [
                {
                    "id": null,
                    "name": "12 meses",
                    "struct": {
                        "number": 12,
                        "unit": "meses"
                    }
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2019-03-11T20:12:44.000Z",
    "stop_time": "2039-03-06T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://produto.mercadolivre.com.br/MLB-1191972200-iphone-xs-64gb-_JM",
    "thumbnail": "http://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-I.jpg",
    "secure_thumbnail": "https://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-I.jpg",
    "pictures": [
        {
            "id": "948658-MLB31730426082_082019",
            "url": "http://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/948658-MLB31730426082_082019-O.jpg",
            "size": "247x500",
            "max_size": "526x1064",
            "quality": ""
        },
        {
            "id": "710945-MLB31730422159_082019",
            "url": "http://mlb-s1-p.mlstatic.com/710945-MLB31730422159_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/710945-MLB31730422159_082019-O.jpg",
            "size": "500x409",
            "max_size": "1064x872",
            "quality": ""
        },
        {
            "id": "866876-MLB31730419625_082019",
            "url": "http://mlb-s1-p.mlstatic.com/866876-MLB31730419625_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/866876-MLB31730419625_082019-O.jpg",
            "size": "247x500",
            "max_size": "457x924",
            "quality": ""
        },
        {
            "id": "667919-MLB31730432393_082019",
            "url": "http://mlb-s1-p.mlstatic.com/667919-MLB31730432393_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/667919-MLB31730432393_082019-O.jpg",
            "size": "500x404",
            "max_size": "1064x861",
            "quality": ""
        },
        {
            "id": "679523-MLB31730442422_082019",
            "url": "http://mlb-s1-p.mlstatic.com/679523-MLB31730442422_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/679523-MLB31730442422_082019-O.jpg",
            "size": "249x500",
            "max_size": "503x1008",
            "quality": ""
        },
        {
            "id": "916431-MLB31730432193_082019",
            "url": "http://mlb-s1-p.mlstatic.com/916431-MLB31730432193_082019-O.jpg",
            "secure_url": "https://mlb-s1-p.mlstatic.com/916431-MLB31730432193_082019-O.jpg",
            "size": "500x401",
            "max_size": "1074x863",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLB1191972200-2009065041"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "me2",
        "free_methods": [
            {
                "id": 100009,
                "rule": {
                    "default": true,
                    "free_mode": "country",
                    "free_shipping_flag": true,
                    "value": null
                }
            }
        ],
        "tags": [
            "mandatory_free_shipping",
            "optional_me2_chosen"
        ],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": true,
        "logistic_type": "drop_off",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "id": "TUxCQ1NFUmI1ZGQx",
            "name": "Serra"
        },
        "state": {
            "id": "BR-ES",
            "name": "Espírito Santo"
        },
        "country": {
            "id": "BR",
            "name": "Brasil"
        },
        "search_location": {
            "neighborhood": {
                "id": "TUxCQk1BVEQ3N0Q2",
                "name": "Mata da Serra"
            },
            "city": {
                "id": "TUxCQ1NFUmI1ZGQx",
                "name": "Serra"
            },
            "state": {
                "id": "TUxCUEVTUE8xN2Y3NA",
                "name": "Espírito Santo"
            }
        },
        "latitude": -20.204721,
        "longitude": -40.305973,
        "id": 1017932319
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": -20.204721,
        "longitude": -40.305973
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MP3",
            "name": "MP3",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "USB_CONNECTION",
            "name": "USB",
            "value_id": null,
            "value_name": "Lightning",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "Lightning",
                    "struct": null
                }
            ],
            "attribute_group_id": "",
            "attribute_group_name": ""
        },
        {
            "id": "BATTERY_CAPACITY",
            "name": "Capacidade da bateria",
            "value_id": "7070610",
            "value_name": "2658 mAh",
            "value_struct": {
                "number": 2658,
                "unit": "mAh"
            },
            "values": [
                {
                    "id": "7070610",
                    "name": "2658 mAh",
                    "struct": {
                        "number": 2658,
                        "unit": "mAh"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "BATTERY_TYPE",
            "name": "Tipo de bateria",
            "value_id": "95013",
            "value_name": "Íon de lítio",
            "value_struct": null,
            "values": [
                {
                    "id": "95013",
                    "name": "Íon de lítio",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "9344",
            "value_name": "Apple",
            "value_struct": null,
            "values": [
                {
                    "id": "9344",
                    "name": "Apple",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "CARRIER",
            "name": "Operadora",
            "value_id": "298335",
            "value_name": "Desbloqueado",
            "value_struct": null,
            "values": [
                {
                    "id": "298335",
                    "name": "Desbloqueado",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "CPU_MODEL",
            "name": "Modelo de CPU",
            "value_id": "6927770",
            "value_name": "2x2.5 GHz Vortex/4x1.6 GHz Tempest",
            "value_struct": null,
            "values": [
                {
                    "id": "6927770",
                    "name": "2x2.5 GHz Vortex/4x1.6 GHz Tempest",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DEPTH",
            "name": "Profundidade",
            "value_id": "6288970",
            "value_name": "7.7 mm",
            "value_struct": {
                "number": 7.7,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6288970",
                    "name": "7.7 mm",
                    "struct": {
                        "number": 7.7,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DIGITAL_ZOOM",
            "name": "Zoom digital",
            "value_id": "7199637",
            "value_name": "10x",
            "value_struct": {
                "number": 10,
                "unit": "x"
            },
            "values": [
                {
                    "id": "7199637",
                    "name": "10x",
                    "struct": {
                        "number": 10,
                        "unit": "x"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISPLAY_RESOLUTION",
            "name": "Resolução da tela",
            "value_id": "7199639",
            "value_name": "1125 px x 2436 px",
            "value_struct": null,
            "values": [
                {
                    "id": "7199639",
                    "name": "1125 px x 2436 px",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "DISPLAY_SIZE",
            "name": "Tamanho da tela",
            "value_id": null,
            "value_name": "5.8 polegadas",
            "value_struct": {
                "number": 5.8,
                "unit": "polegadas"
            },
            "values": [
                {
                    "id": null,
                    "name": "5.8 polegadas",
                    "struct": {
                        "number": 5.8,
                        "unit": "polegadas"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FRONT_CAMERAS_NUMBER",
            "name": "Número de câmeras frontais",
            "value_id": "7477216",
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": "7477216",
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "FRONT_CAMERA_RECORDING_RESOLUTION",
            "name": "Resolução de vídeo da câmera 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": "Outros"
        },
        {
            "id": "HEIGHT",
            "name": "Altura",
            "value_id": "6936436",
            "value_name": "143.6 mm",
            "value_struct": {
                "number": 143.6,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6936436",
                    "name": "143.6 mm",
                    "struct": {
                        "number": 143.6,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "INTERNAL_MEMORY",
            "name": "Memória interna",
            "value_id": null,
            "value_name": "64 GB",
            "value_struct": {
                "number": 64,
                "unit": "GB"
            },
            "values": [
                {
                    "id": null,
                    "name": "64 GB",
                    "struct": {
                        "number": 64,
                        "unit": "GB"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "IS_DUAL_SIM",
            "name": "É Dual SIM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "IS_WATERPROOF",
            "name": "É à prova d'água",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condição do item",
            "value_id": "2230284",
            "value_name": "Novo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Novo",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "LINE",
            "name": "Linha",
            "value_id": "58993",
            "value_name": "iPhone",
            "value_struct": null,
            "values": [
                {
                    "id": "58993",
                    "name": "iPhone",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAIN_FRONT_CAMERA_RESOLUTION",
            "name": "Resolução da câmera frontal principal",
            "value_id": "7199634",
            "value_name": "7 Mpx",
            "value_struct": {
                "number": 7,
                "unit": "Mpx"
            },
            "values": [
                {
                    "id": "7199634",
                    "name": "7 Mpx",
                    "struct": {
                        "number": 7,
                        "unit": "Mpx"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAIN_REAR_CAMERA_RESOLUTION",
            "name": "Resolução da câmera traseira 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": "Outros"
        },
        {
            "id": "MAX_BRIGHTNESS",
            "name": "Brilho máximo",
            "value_id": "6877637",
            "value_name": "625 cd/m²",
            "value_struct": {
                "number": 625,
                "unit": "cd/m²"
            },
            "values": [
                {
                    "id": "6877637",
                    "name": "625 cd/m²",
                    "struct": {
                        "number": 625,
                        "unit": "cd/m²"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MAX_MEMORY_CARD_CAPACITY",
            "name": "Capacidade máxima do cartão de memória",
            "value_id": null,
            "value_name": "64 GB",
            "value_struct": {
                "number": 64,
                "unit": "GB"
            },
            "values": [
                {
                    "id": null,
                    "name": "64 GB",
                    "struct": {
                        "number": 64,
                        "unit": "GB"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "MOBILE_NETWORK",
            "name": "Rede",
            "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": "Outros"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": null,
            "value_name": "MT9G2BZ/A",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "MT9G2BZ/A",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "NUMBER_OF_SIM_CARD_SLOTS",
            "name": "Quantidade de ranhuras para cartão SIM",
            "value_id": "2087812",
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": "2087812",
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPERATING_SYSTEM_NAME",
            "name": "Nome do sistema operacional",
            "value_id": "7404961",
            "value_name": "iOS",
            "value_struct": null,
            "values": [
                {
                    "id": "7404961",
                    "name": "iOS",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPERATING_SYSTEM_VERSION",
            "name": "Versão do sistema operacional",
            "value_id": null,
            "value_name": "iOS12",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "iOS12",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "OPTICAL_ZOOM",
            "name": "Zoom óptico",
            "value_id": "1344",
            "value_name": "2x",
            "value_struct": {
                "number": 2,
                "unit": "x"
            },
            "values": [
                {
                    "id": "1344",
                    "name": "2x",
                    "struct": {
                        "number": 2,
                        "unit": "x"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "ORIGIN",
            "name": "Origem",
            "value_id": "97214",
            "value_name": "Brasil",
            "value_struct": null,
            "values": [
                {
                    "id": "97214",
                    "name": "Brasil",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PIXELS_PER_INCH",
            "name": "Pixels por polegada",
            "value_id": "7070609",
            "value_name": "458 ppi",
            "value_struct": {
                "number": 458,
                "unit": "ppi"
            },
            "values": [
                {
                    "id": "7070609",
                    "name": "458 ppi",
                    "struct": {
                        "number": 458,
                        "unit": "ppi"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_CORES_NUMBER",
            "name": "Quantidade de núcleos do processador",
            "value_id": "7199636",
            "value_name": "6",
            "value_struct": null,
            "values": [
                {
                    "id": "7199636",
                    "name": "6",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_MODEL",
            "name": "Modelo do processador",
            "value_id": "6927771",
            "value_name": "Apple A12 Bionic",
            "value_struct": null,
            "values": [
                {
                    "id": "6927771",
                    "name": "Apple A12 Bionic",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "PROCESSOR_SPEED",
            "name": "Velocidade do processador",
            "value_id": "365850",
            "value_name": "2.5 GHz",
            "value_struct": {
                "number": 2.5,
                "unit": "GHz"
            },
            "values": [
                {
                    "id": "365850",
                    "name": "2.5 GHz",
                    "struct": {
                        "number": 2.5,
                        "unit": "GHz"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "RAM",
            "name": "Memória RAM",
            "value_id": "-1",
            "value_name": null,
            "value_struct": null,
            "values": [
                {
                    "id": "-1",
                    "name": null,
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERAS_NUMBER",
            "name": "Número de câmeras traseiras",
            "value_id": "7477262",
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": "7477262",
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERAS_RESOLUTION",
            "name": "Resolução das câmeras traseiras",
            "value_id": "7405025",
            "value_name": "12 Mpx/12 Mpx",
            "value_struct": null,
            "values": [
                {
                    "id": "7405025",
                    "name": "12 Mpx/12 Mpx",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERA_APERTURE",
            "name": "Abertura do diafragma da câmera traseira",
            "value_id": "7505957",
            "value_name": "f 1.8/f 2.4",
            "value_struct": null,
            "values": [
                {
                    "id": "7505957",
                    "name": "f 1.8/f 2.4",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "REAR_CAMERA_RECORDING_RESOLUTION",
            "name": "Resolução de vídeo da câmera traseira",
            "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": "Outros"
        },
        {
            "id": "SCREEN_TECHNOLOGY",
            "name": "Tecnologia de tela",
            "value_id": "80491",
            "value_name": "OLED",
            "value_struct": null,
            "values": [
                {
                    "id": "80491",
                    "name": "OLED",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "SIM_SIZES",
            "name": "Tamanhos de cartão SIM compatíveis",
            "value_id": "80453",
            "value_name": "Nano-SIM",
            "value_struct": null,
            "values": [
                {
                    "id": "80453",
                    "name": "Nano-SIM",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "TALK_TIME",
            "name": "Autonomia conversação",
            "value_id": "2087877",
            "value_name": "20 h",
            "value_struct": {
                "number": 20,
                "unit": "h"
            },
            "values": [
                {
                    "id": "2087877",
                    "name": "20 h",
                    "struct": {
                        "number": 20,
                        "unit": "h"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WEIGHT",
            "name": "Peso",
            "value_id": "980195",
            "value_name": "177 g",
            "value_struct": {
                "number": 177,
                "unit": "g"
            },
            "values": [
                {
                    "id": "980195",
                    "name": "177 g",
                    "struct": {
                        "number": 177,
                        "unit": "g"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WIDTH",
            "name": "Largura",
            "value_id": "6936437",
            "value_name": "70.9 mm",
            "value_struct": {
                "number": 70.9,
                "unit": "mm"
            },
            "values": [
                {
                    "id": "6936437",
                    "name": "70.9 mm",
                    "struct": {
                        "number": 70.9,
                        "unit": "mm"
                    }
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_ACCELEROMETER",
            "name": "Com acelerômetro",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_BLUETOOTH",
            "name": "Com Bluetooth",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_CAMERA",
            "name": "Com câmera",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_ESIM",
            "name": "Com eSIM",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_FINGERPRINT_READER",
            "name": "Com leitor de impressão digital",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_FRONT_CAMERA_FLASH",
            "name": "Com flash na câmara frontal",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_GPS",
            "name": "Com GPS",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_GYROSCOPE",
            "name": "Com giroscópio",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_IMEI",
            "name": "Com IMEI",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_MINI_HDMI",
            "name": "Com mini HDMI",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_PHYSICAL_QWERTY_KEYBOARD",
            "name": "Com teclado QWERTY físico",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_PROXIMITY_SENSOR",
            "name": "Com sensor de proximidade",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_RADIO",
            "name": "Com radio",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_REMOVABLE_BATTERY",
            "name": "Com bateria removível",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_SLOW_MOTION_CAMERA_FUNCTION",
            "name": "Com função de câmara lenta",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_TOUCH_SCREEN",
            "name": "Com tela tátil",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_TV_TUNER",
            "name": "Com sintonizador de TV",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_USB_CONNECTOR",
            "name": "Com conector USB",
            "value_id": "242084",
            "value_name": "Não",
            "value_struct": null,
            "values": [
                {
                    "id": "242084",
                    "name": "Não",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        },
        {
            "id": "WITH_WIFI",
            "name": "Com Wi-Fi",
            "value_id": "242085",
            "value_name": "Sim",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sim",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Outros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [
        {
            "id": 33898892473,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "162060",
                    "value_name": "Cinza-espacial",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "162060",
                            "name": "Cinza-espacial",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 1,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "948658-MLB31730426082_082019",
                "710945-MLB31730422159_082019"
            ],
            "catalog_product_id": "MLB12866584"
        },
        {
            "id": 33898892476,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "976",
                    "value_name": "Prata",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "976",
                            "name": "Prata",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 1,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "866876-MLB31730419625_082019",
                "667919-MLB31730432393_082019"
            ],
            "catalog_product_id": "MLB12866585"
        },
        {
            "id": 33898892479,
            "price": 7299,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Cor",
                    "value_id": "283164",
                    "value_name": "Dourado",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "283164",
                            "name": "Dourado",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 0,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "679523-MLB31730442422_082019",
                "916431-MLB31730432193_082019"
            ],
            "catalog_product_id": "MLB12866583"
        }
    ],
    "status": "active",
    "sub_status": [],
    "tags": [
        "brand_verified",
        "good_quality_picture",
        "good_quality_thumbnail",
        "immediate_payment",
        "cart_eligible"
    ],
    "warranty": "Garantia de fábrica: 12 meses",
    "catalog_product_id": "MLB12866583",
    "domain_id": "MLB-CELLPHONES",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [
        "MLB1556",
        "MLB1553"
    ],
    "automatic_relist": false,
    "date_created": "2019-03-11T20:12:44.000Z",
    "last_updated": "2019-11-27T11:06:33.000Z",
    "health": 0.9,
    "catalog_listing": false
}
Nota:
Para consultar a descrição é preciso usar o recuso /item/descriptions, para consultar basta pegar o descriptions_id no recurso /items.
curl -X GET https://api.mercadolibre.com/items/item_id/descriptions


Definição de atributos

Ao criar um anúncio, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão adicionados automaticamente. Eles definirão o modo de exibição do produto, como pode ser adquirido pelos compradores e sua posição nos resultados da busca, entre outras variáveis.


Title

O título é fundamental para que os compradores encontrem o seu produto. Por isso, ele deve ser o mais claro possível.

  • Crie o título com Produto + Marca + modelo do produto + algumas especificações que ajudem a identificar o produto.
  • Evite colocar no título informações sobre outros serviços, como devoluções, frete grátis ou parcelamento. Estes dados serão incluídos por nós para que os compradores possam vê-los antes mesmo de entrar no anúncio.
  • Caso seu produto seja novo, usado ou recondicionado, não inclua isto no título, nós informaremos no detalhe do anúncio.
  • Se você vende o mesmo produto, porém em várias cores, evite especificar isso no título. É melhor criar variações, assim tudo ficará em um único anúncio.
  • Caso você tenha estoque em apenas uma determinada cor, adicione a quantidade na variação correspondente ao anunciar, ou em Modificar.
  • Se você oferecer algum desconto, destacaremos isso no seu anúncio, indicando a porcentagem do desconto.
  • Separe as palavras com espaço, não use sinais de pontuação nem símbolos.
  • Revise para garantir que não tenha erros de ortografia.
  • Não está permitido mencionar a palavra estoque, e caso o faça a publicação será moderada. Outro ponto importante, é que o limite de caracteres permitidos nos títulos das publicações que são estabelecidos segundo a categoria a qual a publicação pertenece ("max_title_length").

Por exemplo: Notebook HP Dual Core 425 LED 14 320 GB 4 GB Wifi HDMI

Nota:
Você poderá fazer todas as alterações necessárias, realizando um PUT no recurso de itens, modificando o campo tittle, sempre que sold_quantity seja 0.

Description

Informações detalhadas irão melhorar as suas possibilidades de vender um produto e poupar o seu tempo ao não ter de responder perguntas. Ao trabalhar com descrições, existem algumas considerações a fazer; por exemplo, não é permitido publicar uma descrição contendo as informações de contato. Se quiser saber mais sobre o assunto, acesse o Guia com descrições de artigos.

Nota:
Lembre-se de que a descrição do produto deve estar em texto simples.

Condition

Ao publicar um produto, você deve dizer se seu estado é novo, usado ou não especificado. Esse atributo é obrigatório para concluir a operação de publicação.


Available quantity

Esse atributo define o estoque, isto é, a quantidade de produtos disponíveis para a venda desse produto. O tipo de publicação escolhida definirá o valor mais alto. Para obter mais detalhes, consulte a seção tipos de publicação.


Além disso, quando você deseja publicar produtos no Fulfillment, pode especificar a quantidade disponível para zero, modificando o campo de available_quantity para 0. Dessa forma, a publicação será criada com um status de pausa e substatus out_of_stock. Isso impedirá que você tenha vendas e não possa entregá-las devido à falta de estoque. O que acontece quando você faz PUT aos itens e não tem estoque? Ele suporta as mesmas operações que um item em pausa devido à falta de estoque, ou seja, você não poderá ativá-lo e deve adicionar unidades para que ele seja ativado automaticamente.

Exemplo:

curl -X POST -H "Content-Type: application/json" -d

'{
    ...
    "available_quantity": 0,
    ...
}'
 
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Resposta:

{
    "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"
    ],
    ...
}
Importante:
Essa possibilidade se aplica apenas à Argentina, México e Brasil onde operamos Fulfillment.

Pictures

Imagens de boa qualidade podem fazer com que seu produto seja mais atrativo e oferecer aos usuários uma ideia mais precisa de como ele é. Basicamente, você deve adicionar um conjunto de até seis imagens URL no 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"}
 ]
 ...
}

Recomendamos não usar servidores lentos para hospedar suas imagens, pois pode gerar inconvenientes ao fazer a publicação. Você também pode adicionar ou alterar as imagens de seu produto aqui posteriormente. Leia mais sobre isso para saber quais são os tipos de imagens permitidas e como trabalhar com elas.


Category

Os vendedores deverão definir uma categoria no site do Mercado Livre. Esse atributo é obrigatório e somente aceita IDs pré-estabelecidos. Para obter mais informações, leia o guia de categorias. Para obter uma sugestão de categorias, acesse leia o artigo.

Chamada:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID

Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLA1055

Resposta:

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

Considerações
Com o recurso /categorias, você poderá reconhecer se a categoria está ativada no site que você deseja publicar.
Com os campos listing_allowed e status você poderá identificar se as categorias estão ativadas para publicação no site. Para identificar aqueles que estão ativados, o campo listing_allowed deveria ter a valor true e o campostatus, o valor enabled.


Modalidade de compra

Importante:
Arremate é uma funcionalidade que não está mais ativa para o site do Mercado Livre desde Janeiro de 2019.

A modalidade de arremate ("buying_mode"="auction") ainda aparecerá nas APIs de algumas categorias, mas não poderá ser utilizada. Como fazemos a revisão constante de categorias, em breve, todas as APIs já estarão atualizadas.
Removemos essa modalidade de anúncio, pois quase 100% dos nossos anúncios tinham "Preço Fixo" e vimos que a experiência para o Vendedor e para o Comprador era prejudicada quando a negociação era por "Arremate".
Desde então, está disponível apenas a modalidade de compra imediata ("buying_mode"="buy_it_now"), que garante que uma Order só aparecerá para o vendedor quando o pagamento estiver aprovado, garantindo mais segurança nas transações.


Price

Este atributo é obrigatório. Ao definir um novo produto, ele deve ter um preço. Sugerimos que você busque produtos similares em nosso Marketplace para saber qual é o melhor preço e aumentar sua competitividade. Se você já tiver definido um preço, mas não está satisfeito com ele, poderá alterá-lo posteriormente. Aprenda como modificar anúncios.


Currency

Além do preço, você deverá definir uma moeda. Esse atributo também é obrigatório. A moeda deverá ser definida usando um ID pré-estabelecido. Você vai saber qual é o ID a enviar chamando para o recurso Moedas.


Payment methods

É importante que você considere quais as formas de pagamento disponibilizará. Isso vai variar dependendo do país onde você está trabalhando. Consulte o guia a seguir para saber mais sobre o assunto.


Shipping

Os detalhes de envio não são obrigatórios, mas há muitas opções, e o envio dos produtos que você vende representa uma vantagem competitiva. Saiba mais sobre as opções de envio disponíveis aqui


Identificadores de produtos

Também não é um atributo obrigatório e está disponível apenas para alguns países e tipos de usuários. Saiba mais sobre Identificadores de produto.


SKU

Esta informação ajudará que seus vendedores possam identificar, localizar e fazer o seguimento interno de um produto. Apenas tenha em conta que a informação é carregada em atributos SELLER_SKU, e não em seller_custom_field. Aproveite opara conhecer mais consideraçoes de Variações.


Variações

Com o campo variações você poderá incluir em um mesma publicação todas as variações de um item, mantendo inclusive um estoque diferencial para cada uma das variações. desta forma, quando você receber uma compra, poderá ver no pedido de compra a cor, o modelo, o tamanho escolhido pelo comprador, facilitando assim o seu processo de pós-venda. Conhece mais sobre Variações.


Tipos de publicação

É outro caso de atributo obrigatório que só aceita valores pré-definidos, e é muito importante que você entenda isso. Existem diferentes tipos de publicações disponibilizadas para cada país. Você deve fazer uma chamada combinada através dos sites e recursos listing_types para saber quais são os listing_types aceitos.

Chamada:

 curl https://api.mercadolibre.com/sites/{Site_id}/listing_types

Exemplo:

 curl https://api.mercadolibre.com/sites/MLA/listing_types

Resposta:

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

As tarifas cobradas pela venda do produto, junto com sua classificação nos resultados da busca, vão variar dependendo do tipo de publicação. Você encontrará informações sobre os feeds e características de cada tipo de publicação nas Perguntas Frequentes do Marketplace de cada país, ou poderá fazer uma chamada à API, conforme mostrado a seguir:

Chamada:

 curl https://api.mercadolibre.com/sites/{Site_id}/listing_types/{Listing_type}

Exemplo:

 curl https://api.mercadolibre.com/sites/MLA/listing_types/silver

Resposta:

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


Condição de um item

Para definir se um produto é novo, usado ou remodelado, será necessário enviar o atributo “item_condition” com o valor que se quiser atribuir. Para conhecer os atributos que correspondem a uma categoria e os valores suportados, sugerimos a leitura da documentação de Atributos.

Nota:
Embora atualmente seja permitido enviar quando um item é novo ou usado dentro do campo "condition", nos casos de "recondicionado" deverá ser colocado como atributo.

Exemplo:

 curl -X GET https://api.mercadolibre.com/categories/MLB266916/attributes

Resposta:

{
"id": "ITEM_CONDITION",
"name": "Condição do item",
"tags": {
"hidden": true
},
"hierarchy": "ITEM",
"relevance": 2,
"value_type": "list",
"values": [
{
"id": "2230284",
"name": "Novo"
},
{
"id": "2230581",
"name": "Usado"
},
{
"id": "2230582",
"name": "Recondicionado"
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
},
Importante:
Quando o aviso tem condição "recondicionado" é necessário enviar a Garantia do produto na seção "sale_terms".


Garantia do produto

Dentro da seção "sale_terms" de um item, deverá ser definida a garantia que o produto anunciado vai ter. Para isso, terá que passar a informação em uma combinação de atributos:
Tipo de Garantia: representa as formas que essa garantia pode ter. Por exemplo: garantia de vendedor, de fábrica, etc.
Tempo Garantia: representa o tempo durante o qual essa garantia terá vigência.

Chamada:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms

Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLB169492/sale_terms

Resposta:

{
        "id": "WARRANTY_TYPE",
        "name": "Tipo de garantia",
        "tags": {},
        "hierarchy": "SALE_TERMS",
        "relevance": 2,
        "value_type": "list",
        "values": [
            {
                "id": "2230280",
                "name": "Garantia do vendedor"
            },
            {
                "id": "2230279",
                "name": "Garantia de fábrica"
            }
        ],
        "attribute_group_id": "OTHERS",
        "attribute_group_name": "Outros"
    },
    {
        "id": "WARRANTY_TIME",
        "name": "Tempo de garantia",
        "tags": {},
        "hierarchy": "SALE_TERMS",
        "relevance": 2,
        "value_type": "number_unit",
        "value_max_length": 255,
        "allowed_units": [
            {
                "id": "dias",
                "name": "dias"
            },
            {
                "id": "anos",
                "name": "anos"
            },
            {
                "id": "meses",
                "name": "meses"
            }
        ],
        "default_unit": "dias",
        "attribute_group_id": "OTHERS",
        "attribute_group_name": "Outros"
    }
Nota:
Ao configurar um item como recondicionado, isso deve ser feito com uma garantia de 90 dias ou mais. Veja mais sobre Anuncios.


Publicação de um anúncio

Agora você está pronto para publicar seu primeiro anúncio. Lembre-se de que, para isso, você precisará de um access_token. Se tiver dúvidas sobre como obter seu token de acesso, veja como obter seu token. Também recomendamos a utilização de usuários de teste para publicar produtos. Se ainda não tem seu usuário de test, consulte a realização de testes para obter o seu. Você pode criar um JSON para seu item com base no exemplo abaixo, ou enviá-lo como está, e você estará publicando um produto de amostra no site:

Chamada:

curl -XPOST -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",
  "description":{
     "plain_text":"Descripción con Texto Plano \n"
  },
  "video_id":"YOUTUBE_ID_HERE",
  "sale_terms":[
     {
        "id":"WARRANTY_TYPE",
        "value_name":"Garantía del vendedor"
     },
     {
        "id":"WARRANTY_TIME",
        "value_name":"90 días"
     }
  ],
  "pictures":[
     {
        "source":"http://mla-s2-p.mlstatic.com/968521-MLA20805195516_072016-O.jpg"
     }
  ],
  "attributes":[
     {
        "id":"BRAND",
        "value_name":"Marca del producto"
     },
     {
        "id":"EAN",
        "value_name":"7898095297749"
     }
  ]
}' 'https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN'

Exemplo:

{
   "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",
   "description":{
      "plain_text":"Descripción con Texto Plano \n"
   },
   "video_id":"YOUTUBE_ID_HERE",
   "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"
      }
   ]
}
Nota:
Se você tiver problemas ao tentar publicar, consulte a referência na tabela de códigos de erros da API no final deste guia.

Items com Mercado Pago obrigatório

Assim como um user ou uma categoria podem ser marcados com pagamento imediato, também um item pode ser assim marcado. Este situação se apresenta em:


Publique seu item com Pagamento Imediato

Se você quiser que seu item seja somente pago através de Mercado Pago, pode definir isso no momento de criar um novo item, ou pode alterar um item já ativo. Para isso, será necessário adicionar o tag "inmediate_payment".

Chamada:

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

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

    ]
}
 
'
 
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Resposta:

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

Categorias com pagamento imediato

Dentro do Mercado Livre há categorias que têm Mercado Pago como única opção. Para saber se a categoria em que você quer anunciar é uma delas, consulte:

curl https://api.mercadolibre.com/sites/categories/{category_id}

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

Caso o campo "inmediate_payment" esteja marcado como "required", o pagamento através do Mercado Pago é obrigatório. Se estiver marcado como "optional", também aceitará pagamento "A combinar com o vendedor".


Publicação de um anúncio em uma Loja Oficial

A publicação de um anúncio em uma Loja Oficial é exatamente da mesma forma que a publicação de outro anúncio, porém, você deverá adicionar o atributo official_store_id no JSON.

Exemplo:

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

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

Nota:
Se sua loja é multimarcas, você deverá especificar o official_store_id da marca onde quer publicar esse produto. Consulte o guia de lojas oficiais para saber mais sobre o assunto.

Selecione o canal no qual deseja oferecer produtos

Importante:
Esta funcionalidade está disponível apenas para Argentina, Brasil e México, ou seja, onde o Mercado Shops está ativo.

Usando o atributo exclusive_channel você pode escolher onde publicar um artigo, apenas no Mercado Livre, no Mercado Shops ou nos dois canais. Os valores possíveis são:
- Mercado Libre
- Mercado Shops

A presença desse atributo determina em qual canal o item é visível exclusivamente e sua ausência indica que o item é visível nos dois canais. Um item com o atributo exclusive_channel com o campo valor_id em nulo se comporta como se o atributo não existisse.

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

O exemplo a seguir corresponde a um item oferecido exclusivamente no Mercado Livre:

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

Conheça mais sobre Mercado Shops.



Referências de código de erro da API

Error_code Mensagem de erro Descrição Possível solução
item.start_time.invalid A hora de início $startTime só pode ser atualizada nos produtos NOT_YET_ACTIVE. O campo hora de início não pode ser atualizado. O parâmetro start_time só pode ser atualizado se o status do produto for NOT_YET_ACTIVE.
item.category_id.invalid A categoria $categoryId não existe. Categoria não encontrada. Para visualizar as categorias disponíveis, consulte page/sites/$siteId (Consulta $sideId).
item.category_id.invalid Não é permitido publicar na categoria $categoryId. Verifique se está publicando em uma categoria folha. $category.listing_allowed falso. Antes de publicar um anúncio, verifique se está publicando na categoria escolhida; consulte o parâmetro listing_allowed em /categories/$categoryId.
item.buying_mode.invalid A categoria $categoryId só aceita modos de publicação: $category.buyingModes. $item.buying_modes não é válido. Para visualizar os modos de publicação disponibilizados na categoria, consulte a página /categories/$categoryId nas configurações do parâmetro:{buying_modes:[…]}.
item.attributes.missing_required Os atributos $requiredAttributeIds são obrigatórios para a categoria $item.categoryId. Verifique se o atributo está incluído na lista de atributos ou na combinação de todos os atributos das variações. A categoria é um atributo obrigatório. Para visualizar os atributos obrigatórios dessa categoria, consulte a página /categories/$categoryId/attributes no parâmetro {tags:{required:{true}}}.
item.listing_type_id.invalid listing_type_id não válido. $item.listing_type_id é inválido. Para visualizar tipos de publicações disponíveis na categoria, consulte a página /categories/$categoryId/listing_types.
item.listing_type_id.requiresPictures As imagens do produto são obrigatórias para o $item.listingTypeId do tipo de publicação. As imagens são obrigatórias. Para saber se as imagens são obrigatórias na categoria, consulte a página /categories/$categoryId/listing_types/silver no parâmetro requires_picture:{}.
item.site_id.invalid $item.siteId do site não existe. O $item.site_id é inválido. Para visualizar os sites disponibilizados, consulte a página /sites.
item.description.max O campo descrição é longo demais. Não são permitidos mais de $maxSize caracteres. Quantidade de caracteres ultrapassada. O número de caracteres da descrição deve ter menos de 50.000 caracteres.
item.pictures.max O número de itens em $item.categoryId não pode ultrapassar o número de imagens de $maxPicturesPerItem. Quantidade de imagens ultrapassada. Para visualizar a quantidade de imagens permitida por item na categoria, consulte a página /categories/$categoryId no parâmetro max_pictures_per_item:{}.
item.attributes.invalid_length Tamanho de valor inválido para o atributo $it.attributeId. O tamanho máximo é ${attribute.value_max_length}. Para visualizar os atributos max_length neste atributo, consulte a página /categories/$categoryId/attributes no parâmetro value_max_length para atributos com cadeia de caracteres ou número value_type.
seller.unable_to_list O vendedor não pode anunciar. O vendedor, por alguma causa, não pode anunciar. Identifica o campo "cause" dentro do response. - Consulte o significado de "cause" em /users#options esse status to list para ver o significado.
- Tente realizar uma primeira postagem manual a partir de Minha Conta do Mercado Livre para que as notificações apareçam no fluxo.

 

Referências de código de resposta HTTP

Items começarão a devolver o código http 206 quando não for possível obter algum dado. Tenha em conta que na maioria dos casos a informação recebida será suficiente para que você possa seguir trabalhando.
No header de resposta X-Content-Missing estarão disponibilizados os nomes dos campos que podem não conter informações. São eles: "location", "geolocation" e/ou "seller_address".

Chamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

Resposta http 200 OK:

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

Chamada:

curl -V https://api.mercadolibre.com/items/$ITEM_ID?access_token=$ACCESS_TOKEN

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

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

Artigos relacionados: Tutorial tipos de publicação e atualização de anúncios. Variações.

Próximo: Envio de produto.