Sincronização e modificaçã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:

Assuntos

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

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

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

Você também deve lembrar que:

  • A categoria não pode ser alterada através da API.
  • O tipo de publicação só pode ser alterado uma vez.

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 "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

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, 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.

Mudar os 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.
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"closed"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



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.
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



ativo: reativa um produto previamente pausado.
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"active"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Aclaração: 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.

Se seu produto 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 o artigo sobre ciclo de vida das publicações.

Fluxo de estados nas publicações

Active: O anúncio está ativo e pode receber ofertas ou perguntas. É possível alterar a exposição do anúncio (upgrade de listing type).

Payment required: Este caso se apresenta quando um usuário com dívida ou baixa política de crédito realiza um anúncio que será reativado automaticamente após o usuário realizar o pagamento.

Under Review: O item está sob revisão pelo Mercado Livre por causa dos motivos abaixo:

  • warning: item que continua ativo, porém, tem uma correção pendente a ser realizada pelo usuário. Se não for corrigido em 2 dias, passa para waiting_for_patch.
  • waiting_for_patch: item oculto até o usuário corrigir a infração informada.
  • held: item oculto no aguardo de uma moderação manual pelo Mercado Livre.
  • pending_documentation: item oculto até o usuário apresentar a documentação solicitada.
  • forbidden: item cancelado por moderação.

Paused: Pode se apresentar de forma automática (out of stock) ou por decisão do usuário.

  • out of stock: o item foi pausado por falta de estoque e será automaticamente ativado quando for restituído.

Nota: O item será pausado na VIP e não poderá receber ofertas.

Closed: Este é o status final do item, podendo se dever às seguintes causas:

  • waiting for patch
  • held
  • expired: chegou a data de finalização do anúncio (end_time) ainda tendo estoque.
  • deleted: é adicionado quando o item está fechado e o seller decide removê-lo. Ou quando o item finaliza e é automaticamente recadastrado.
  • suspended
  • freezed

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

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}

{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto! Seu produto será excluído.

Atualização do estoque

Atualizar o estoque de um artigo é muito fácil. Você deve somente acrescentar o valor no campo “available_quantity”, levando em consideração os seguintes pontos:

  • Ao fazer o PUT do available_quantity com 0, mudará o estado para “paused” com subestado out_of_stock.
  • Ao fazer o PUT do available_quantity com 0 e o subestado sendo out_of_stock, mudará o estado para ativo sem subestado out_of_stock.

Observação: É possível realizar esta modificação tanto para itens como para variações de um item.

Onde é possível essa funcionalidade?

Os sites que suportam pausa automática com estoque 0 são MLB, MLA, MLM, MLC, MPE, MLV.
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 6
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Fácil. Você pode consultar sua publicação e visualizar o estoque atualizado.
Se precisar atualizar o estoque ou realizar alterações em um produto com variações, você encontrará uma pequena diferença na maneira de realizar as atualizações.


Próximo:
Gerenciamento de contatos.

Qualifique entre 1 e 5