Sincronização de publicações (veículos)

Assim que você tiver publicações ativas em nosso site, é provável que você tenha de fazer atualizações e alterações periodicamente para excluir anúncios já vendidos, pausar publicações, melhorar descrições, atualizar preços etc. Siga este guia para aprender como fazer.

Considerações

Você pode alterar valores para:

• Title
• Price
• Video
• Pictures
• Description
• Location
• Atributos da publicação (array “attributes”)
• Category

Você pode alterar valores para: o tipo de publicação só pode ser alterado uma vez.

Atualização de seu anúncio

Vejamos um exemplo básico de atualização do título e do preço de um anúncio. Você só precisará do item_id do produto publicado e do access_token do vendedor.

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID

Pronto. O título e o preço de seu anúncio foram atualizados, e você deverá receber um status de resposta com código 200 OK para confirmar que não houve inconvenientes. Lembre de que pode demorar um pouco até que as informações atualizadas fiquem visíveis.

Descrições

Atualizar uma descrição é muito simples. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições. Consulte o nosso artigo sobre descrições para ter certeza de que entendeu.

Imagens

Você sempre pode adicionar ou substituir imagens dos anúncios. Leia o nosso tutorial sobre como trabalhar com imagens para saber qual a melhor maneira de fazer isso.

Tipos de publicação

Caso você queira dar mais exposição ao seu anúncio, você deve atualizar o tipo de publicação. Conheça os detalhes e as considerações, e aprenda a fazer uma atualização em nosso tutorial de tipos de publicações e upgrades.

Mudança de status das publicações

Qualquer anúncio publicado em nosso site pode ter diferentes status. A seguir, analise a descrição de cada um deles:

• encerrado: finaliza sua publicação. Uma vez encerrada, a publicação não poderá ser ativada novamente, mas pode ser publicada novamente.
• pausado: pausa sua publicação. Uma vez pausado, os visitantes não poderão entrar em contato com você, pois os dados de contato do anúncio são removidos.
• ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do anúncio, deverá enviar um desses valores para o campo "status". Lembre de que o valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas. Para pausar um produto ativo, veja o exemplo a seguir:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID

Excelente! Seu anúncio já foi pausado. Agora você já pode tentar reativá-lo fazendo exatamente a mesma chamada, mas enviando "ativo" em vez de "pausado" como valor de status. Se seu anúncio está encerrado, e você quer publicá-lo novamente, consulte artigo sobre como publicar novamente para fazer isso rapidamente. Para obter mais informações sobre o status do produto, consulte a seção sobre tempo de validade da publicação.

Atualização com o atributo WITH_FINANCING_OPTIONS (Opções de financiamento)

O envio do campo WITH_FINANCING_OPTIONS possibilita ao vendedor indicar em suas publicações a disposição para negociar condições alternativas de pagamento (financiamento) com o comprador.

Para atualizar (adicionar ou modificar) o atributo de financiamento em uma publicação existente, você deve enviar o array sale_terms por meio de uma chamada PUT ao endpoint /items/{ItemID}. Este atributo é do tipo booleano, onde o value_id define se o produto é financiável ou não.

Exemplo de chamada:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA1568702067' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "WITH_FINANCING_OPTIONS",
      "value_id": "242085",
      "value_name": "Sim"    
    }
  ]
}'

Identificação do atributo na resposta:

{
  "id": "MLA1568702067",
  "site_id": "MLA",
  "title": "Citroën C4 Picasso 1.6 Origine Hdi 115cv",
  ...
  "sale_terms": [
    ...
    {
      "id": "WITH_FINANCING_OPTIONS",
      "name": "Com opções de financiamento",
      "value_id": "242085",
      "value_name": "Sim",
      ...
    }
  ]
}

Atualização com o atributo INITIAL_PAYMENT_AMOUNT (financiamento com entrada)

O atributo INITIAL_PAYMENT_AMOUNT permite ao vendedor informar o valor inicial (entrada) que o comprador deve pagar ao fechar a operação. Este campo é uma excelente forma de dar transparência à negociação. Ao ativar esta opção, enviando o atributo, o anúncio exibirá o valor da entrada.

Para atualizar (adicionar ou modificar) o atributo de valor da entrada em uma publicação existente, você deve enviar o array sale_terms por meio de uma chamada PUT ao endpoint /items/$ITEM_ID. Onde o campo value_name informa o valor da entrada do produto.

O valor informado no campo "value_name" deve corresponder à mesma moeda (currency_id) que o item. Caso o valor de "INITIAL_PAYMENT_AMOUNT" seja enviado em uma moeda diferente, o sistema realizará automaticamente a conversão para a moeda do item.

Exemplo de chamada:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA2736093652' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "INITIAL_PAYMENT_AMOUNT",
      "value_name": "7500000 ARS",
      "value_struct": {
        "unit": "ARS"
      }
    }
  ]
}'

Identificação do atributo na resposta:

"sale_terms": [
  {
    "id": "INITIAL_PAYMENT_AMOUNT",
    "name": "Valor da entrada",
    "value_id": null,
    "value_name": "7500000 ARS",
    "value_struct": {
      "number": 7500000,
      "unit": "ARS"
    }
  }
]

Como remover o valor de entrada?

Para remover o valor da entrada do anúncio, atualize o item enviando no array sale_terms o objeto com id igual a INITIAL_PAYMENT_AMOUNT e o campo value_name vazio ("").

Chamada de exemplo:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA2736093652' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "INITIAL_PAYMENT_AMOUNT",
      "value_name": ""
    }
  ]
}'

Se o atributo for removido corretamente, a API retornará um 200 OK com a representação completa do item atualizado, sem o atributo INITIAL_PAYMENT_AMOUNT que foi excluído.

Exclusão de publicações

Após excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Lembre-se sempre de excluir anúncios que já foram vendidos, pois, eles concorrem com seus outros anúncios que estão ativos.

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}
https://api.mercadolibre.com/items/ITEM_ID
Segundo passo
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID