Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 15/03/2023

Sincronização de publicações

Assim que você tiver publicações ativas em nosso Marketplace, é provável que você tenha de fazer atualizações e alterações periodicamente para sincronizar o estoque com outras plataformas com as quais você trabalha, pausar publicações, melhorar descrições, atualizar preços etc. Leia o guia a seguir e saiba como fazer isso.


Considerações

Nem todos os campos podem ser atualizados, e isso irá variar se o produto já tiver vendas ou não. Além disso, lembre-se de que para poder alterar um produto, ele deve estar ativo. Você pode alterar valores para:

  • Title
  • Available_quantity
  • Price
  • Video
  • Pictures
  • Description
  • Shipping
  • Category

Se o produto tiver vendas, nenhum dos seguintes campos poderá ser alterado:

  • Title
  • Condition
  • Buying mode
  • Non Mercado Pago Payment Methods
  • Shipping dimensions
  • Warranty

Você também deve lembrar que:

  • O tipo de publicação só pode ser alterado uma vez.
  • O título não pode ser alterado em um produto que já tenha vendas, a menos que você faça parte das lojas oficiais do Mercado Livre.

Atualização de seu produto

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


Exemplo:

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 produto 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, e você pode fazer isso independentemente do produto ter ou não alguma oferta. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições, leia o artigo consulte o nosso artigo sobre descrições para ter certeza de que entendeu.


Imagens

Você sempre pode adicionar ou substituir imagens dos produtos. Consulte o nosso tutorial Trabalhar com imagens para saber qual a melhor maneira de fazer isso.


Tipos de publicação

Caso você queira dar mais exposição a seu produto, 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 Tipos de publicações e upgrades.


Mudança de status das publicações

Qualquer produto publicado em nosso Marketplace 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, o produto não poderá ser visualizado pelos outros usuários do Mercado Livre, mas não será encerrado e poderá ser reativado depois.
  • ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do produto, 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 produto 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 produto está encerrado, e você quer publicá-lo novamente, consulte artigo sobre como publicar novamente para fazer isso rapidamente.


Exclusão de publicações

Depois de excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Além disso, lembre-se de que não é necessário excluir os produtos encerrados porque eles serão automaticamente descartados depois de algum tempo.


Mas se você ainda precisar excluir um produto, por exemplo, produtos em estado payment_required, os quais não responderão ao status "encerrado”, faça o seguinte.


Primeiro passo:

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
Nota:

Se ao fazer o segundo PUT você obtiver o erro:

message: item optimistic

locking error: conflict

status: 409

cause: array(0)


Deverá esperar alguns segundos até a informação se atualizar. Eliminado o anúncio, ele continuará sendo visualizado na VIP durante um breve período com a legenda "anúncio finalizado".

Pronto! Seu produto será excluído.


Atualização do estoque

Atualizar o estoque de um produto é muito fácil. Você só precisa atualizar o valor do campo “available_quantity”.


Exemplo:

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

Fácil. Você pode consultar sua publicação e visualizar o estoque atualizado.


Próximo: Gerenciamento de contatos.