Publique seus anúncios novamente

Publicar novamente é uma ação que você só poderá realizar quando o status de sua publicação for "encerrado", seja manualmente ou através da API. Uma nova publicação implica a criação de um NOVO produto, contendo exatamente os mesmos elementos que denominamos "pai". Você pode enviar uma solicitação PUT em um status encerrado a qualquer momento, estando seu anúncio ativo ou pausado, e encerrá-lo você mesmo.


Conteúdos


Considerações sobre publicar novamente

Você vai perceber que, dependendo do tipo de produto que tiver publicado, alguns componentes mostrarão diversos comportamentos quando forem publicados novamente:

 

Ofertas e visitantes

Os produtos herdam ofertas e o histórico dos visitantes. Os produtos classificados não recebem ofertas, mas herdam o histórico de visitantes.
Perguntas: ao publicar novamente, só serão herdadas aquelas perguntas not_answered sobre o anúncio pai.
Análises: trata-se de um recurso especial da categoria "Serviços" dos produtos classificados. Toda vez que você publicar novamente um Serviço, ele herdará as análises do anúncio pai para manter as análises atualizadas.

Nota:

  • Os produtos pertencentes a leilões não herdam nada do anterior.

  • Os títulos em anuncias com leilões podem ser alterados.

Realize uma chamada GET para a API Produtos e verifique o atributo sold_quantity para saber a quantidade de ofertas recebidas por seu produto:

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

Exemplo:

 "initial_quantity": 3,
  "available_quantity": 3,
  "sold_quantity": 1,


Verificação do estado atual e da data de validade do anúncio

Antes de realizar alterações, talvez você deva verificar o status e data de validade de seu produto. Faça uma chamada ao recurso do produto com seu item_id:

curl GET -x https://api.mercadolibre.com/items/{item_id}

Uma vez recebida uma resposta, verifique o elemento stop_time para obter a data de validade do produto. Essas informações também são disponibilizadas no corpo da resposta que você recebe quando realiza uma publicação bem-sucedida do produto pela primeira vez. Por isso, caso você mantenha um banco de dados, talvez queira salvá-lo. Como já foi explicado, ao publicar novamente um produto, você estará gerando um produto NOVO, ou seja, o Mercado Livre alocará um novo ID de produto para ele. Você poderá obter o novo ID do JSON do corpo da resposta que você receberá quando publicar novamente seus produtos. O atributo parent_item_id da API é vinculado ao produto original.


Publique seu anúncio novamente

Lembre-se de que o status dos produtos deverá ser encerrado para que eles possam ser publicados novamente. Depois, você só precisa realizar uma solicitação POST para o recurso publicar novamente enviando preço, quantidade e listing_type_id no corpo da solicitação. Exemplo:

 curl -X POST -H "Content-Type: application/json" -d '{
  "price": 20000,
  "quantity": 1,
  "listing_type_id": "silver"
}' https://api.mercadolibre.com/items/{item_id}/relist?access_token=$ACCESS_TOKEN


Como relistar variações padrão

Se o seu anúncio foi encerrado, mas você ainda tem estoque disponível em algumas das variações, você pode relistar o anúncio enviando apenas as variações com estoque. Lembre-se de indicar a quantidade e preço em cada um deles. Exemplo:

 curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 10541993184,
            "price": 1000,
            "quantity": 2
        },
        {
            "id": 10541993186,
            "price": 1000,
            "quantity": 2
        },
                {
            "id": 10542199553,
            "price": 1000,
            "quantity": 1
        }
    ] }' https://api.mercadolibre.com/items/MLA601053403/relist?access_token=¢ACCESS_TOKEN


Como podemos ver na resposta, quando você relista um anúncio um novo anúncio é criado. Mas os campos item_id e variation_id devem ser renovados.


Como relistar variações customizadas

Caso seu anúncio já tenha finalizado mas ainda tem stock em algumas de suas variações pode relistar encaminhando as variações que deseja conservar, a quantidade disponível e o preço de cada uma delas. Exemplo:

curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 45339262332,
            "price": 15499,
            "quantity": 200
        },
        {
            "id": 45339262335,
            "price": 16000,
            "quantity": 100
        }
    ] }' https://api.mercadolibre.com/items/MLA821614634/relist?access_token=$ACCESS_TOKEN

Resposta:

{
    "id": "MLA821614634",
    "site_id": "MLA",
    "title": "Motorola G6 Plus 64 Gb Negro",
    "subtitle": null,
    "seller_id": 465432224,
    "category_id": "MLA1055",
    "official_store_id": null,
    "price": 15499,
    "base_price": 15499,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 300,
    "available_quantity": 200,
    "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
                }
            ]
        }
    ],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2019-10-24T13:51:46.000Z",
    "stop_time": "2039-10-19T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-821614634-motorola-g6-plus-64-gb-negro-_JM",
    "thumbnail": "http://mla-s1-p.mlstatic.com/975594-MLA31982048508_082019-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/975594-MLA31982048508_082019-I.jpg",
    "pictures": [
        {
            "id": "735698-MLA32074836338_092019",
            "url": "http://mla-s1-p.mlstatic.com/735698-MLA32074836338_092019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/735698-MLA32074836338_092019-O.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        },
        {
            "id": "975594-MLA31982048508_082019",
            "url": "http://mla-s1-p.mlstatic.com/975594-MLA31982048508_082019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/975594-MLA31982048508_082019-O.jpg",
            "size": "500x428",
            "max_size": "975x836",
            "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": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        },
        "latitude": 38.114697,
        "longitude": 13.356881,
        "id": 1061890913
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": 38.114697,
        "longitude": 13.356881
    },
    "coverage_areas": [],
    "attributes": [
        {
            "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": "7573635",
            "value_name": "Li-Ion",
            "value_struct": null,
            "values": [
                {
                    "id": "7573635",
                    "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": "CPU_MODEL",
            "name": "Modelo de CPU",
            "value_id": "7070889",
            "value_name": "4x2.2 GHz Cortex-A53/4x1.8 GHz Cortex-A53",
            "value_struct": null,
            "values": [
                {
                    "id": "7070889",
                    "name": "4x2.2 GHz Cortex-A53/4x1.8 GHz Cortex-A53",
                    "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": "NUMBER_OF_SIM_CARD_SLOTS",
            "name": "Cantidad de ranuras para tarjeta SIM",
            "value_id": "2087812",
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": "2087812",
                    "name": "1",
                    "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": [],
    "listing_source": "",
    "variations": [
        {
            "id": 45339262332,
            "price": 15499,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52055",
                    "value_name": "Blanco",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "52055",
                            "name": "Blanco",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 100,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "935916-MLA31045069993_062019",
                "785394-MLA31045072385_062019"
            ],
            "catalog_product_id": "MLA9452522"
        },
        {
            "id": 45339262335,
            "price": 15499,
            "attribute_combinations": [
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro",
                    "value_struct": null,
                    "values": [
                        {
                            "id": "52049",
                            "name": "Negro",
                            "struct": null
                        }
                    ]
                }
            ],
            "available_quantity": 100,
            "sold_quantity": 0,
            "sale_terms": [],
            "picture_ids": [
                "935916-MLA31045069993_062019",
                "785394-MLA31045072385_062019"
            ],
            "catalog_product_id": "MLA9452522"
        }
    ],
    "status": "active",
    "sub_status": [],
    "tags": [
        "extended_warranty_eligible",
        "test_item",
        "immediate_payment"
    ],
    "warranty": "Sin garantía",
    "catalog_product_id": "MLA9452522",
    "domain_id": "MLA-CELLPHONES",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-10-24T13:51:46.000Z",
    "last_updated": "2019-10-24T14:10:38.000Z",
    "health": null,
    "catalog_listing": false
}

Como pode ver na resposta, quando um produto é relistado se gera um novo anuncio pelo que renovaremos o “item_id” assim como o “Id” de suas variações.

ou registre-se para receber as últimas notícias sobre nossa API