Sincronização e modificação de publicações

Considerações para atualizar itens

- Identifique a que canal corresponde a sua publicação (Mercado Libre ou Mercado Shops), pois caso corresponda a mshops terá que revisar a forma de aplicar as alterações de preço.

- Quando o item está ativo, você pode modificar:

• Available_quantity
• Price
• Video
• Pictures
• Description
• Shipping

- Quando o item tem vendas, você não pode mudar:

• Title
• Buying mode (só existe uma opção ativa atualmente)
• Mercado Pago Payment Methods

- Quando o item não tem vendas ("sold_quantity" = 0), você pode modificar:

• Title

- O tipo de publicação só pode ser alterado uma vez.
- Levar em consideração se a publicação possui variações.
- Verifique se o item tem uma oferta ativa.

Atualizar itens

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

Descrições

Consulte a nossa documentação sobre descrições de produtos.

Imagens

Você sempre pode adicionar ou substituir imagens dos produtos. Consulte Trabalhar com imagens.

Tipos de publicação

Aprenda a fazer uma atualização em Tipos de publicações e upgrades.

Fluxo e estados das publicações

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. Nesta condição o item poderá ser deletado somente de forma direta.

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, para evitar isso, o item deverá ser pausado com estoque =1.
• picture downloading pending: o item foi pausado até que a imagem seja baixada corretamente e será ativado quando isso aconteça.

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

Lembre que, depois de um tempo, os itens finalizados não serão mais mostrados para sua consulta.




Inactive: se a correção necessária para sair do status under review não for feita, o item passa para inactive. A correção pode se encontrar na conta do usuário na seção vendas na aba de anúncios "revisar".

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 republicar seus itens.

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

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 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/$ITEM_ID

ativo: reativa um produto previamente pausado. Exemplo:

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

Notas:
O valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas.

Apagar publicações

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:

• 1. Atualizar o status closed:

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

• 2. Apagar o ítem:

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

Estoque de itens

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 = 0, mudará o estado para “paused” com subestado out_of_stock.
• Ao fazer o PUT do available_quantity superior a 0 e o subestado sendo out_of_stock, mudará o estado para ativo sem subestado out_of_stock.
• Só pode pausar um item enviando available_quantity = 0 quando for do tipo condition = new e não for listing_type = free.

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

Estoque de itens usados

Conheça as categorias e países com limite de 1 (um) item com condição uasada ("condition":"used").

Tempo de disponibilidade (MANUFACTURING TIME)

Tempo de disponibilidade de estoque

Mostraremos a você como utilizar a funcionalidade que permite contar aos compradores quanto tempo leva ter os produtos prontos para a venda e poderá ser utilizado nos casos:

• Realização de pedidos por encargo.
• Fabricação de produtos.
• Customização de produtos para ser vendidos.
• Quando estoque do fornecedor seja recebido de forma periódica.

Assim, a publicação ficará ativa, ainda que os produtos não estejam prontos para a venda e os compradores poderão adquiri-los, sabendo o dia exato em que chegarão. Leve em consideração que quanto mais tempo for adicionado, menos exposição terão as publicações. Sempre mostraremos, em primeiro lugar, aqueles que tiverem estoque disponível, portanto, confira estar utilizando-a apenas quando for necessário.

Consultar tempo de disponibilidade de estoque

Dentro da seção sale_terms de um item, você poderá especificar o tempo de disponibilidade de estoque de sua publicação utilizando o sale_term MANUFACTURING_TIME.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA1577/sale_terms

Resposta:

[
  {
    "id": "INVOICE",
    "name": "Facturación",
    "tags": {
      "hidden": true,
      "multivalued": true
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 1,
    "value_type": "list",
    "values": [
      {
        "id": "6891885",
        "name": "Factura A"
      },
      {
        "id": "6891886",
        "name": "Factura B"
      },
      {
        "id": "6891887",
        "name": "Factura C"
      },
      {
        "id": "6891888",
        "name": "No factura"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "SUBSCRIBABLE",
    "name": "Suscribible",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "PRICE_SUBSCRIPTION",
    "name": "Precio por suscripción",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "SUBSCRIPTION_FREE_SHIPPING",
    "name": "Envío gratis por suscripciones",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "boolean",
    "values": [
      {
        "id": "242084",
        "name": "No",
        "metadata": {
          "value": false
        }
      },
      {
        "id": "242085",
        "name": "Sí",
        "metadata": {
          "value": true
        }
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_1",
    "name": "Precio por nivel 1 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_2",
    "name": "Precio por nivel 2 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_3",
    "name": "Precio por nivel 3 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_4",
    "name": "Precio por nivel 4 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_5",
    "name": "Precio por nivel 5 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "LOYALTY_LEVEL_6",
    "name": "Precio por nivel 6 de loyalty",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "USD",
        "name": "USD"
      },
      {
        "id": "UVA",
        "name": "UVA"
      },
      {
        "id": "ARS",
        "name": "ARS"
      }
    ],
    "default_unit": "USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "CHECKOUT_EXCHANGE_RATE",
    "name": "Tipo de cambio para checkout",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "ARS/USD",
        "name": "ARS/USD"
      }
    ],
    "default_unit": "ARS/USD",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "DISCOUNT_SUBSCRIPTION",
    "name": "Descuento por suscripciones",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "%",
        "name": "%"
      }
    ],
    "default_unit": "%",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TYPE",
    "name": "Tipo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "list",
    "values": [
      {
        "id": "2230280",
        "name": "Garantía del vendedor"
      },
      {
        "id": "2230279",
        "name": "Garantía de fábrica"
      },
      {
        "id": "6150835",
        "name": "Sin garantía"
      }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "WARRANTY_TIME",
    "name": "Tiempo de garantía",
    "tags": {
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      },
      {
        "id": "meses",
        "name": "meses"
      },
      {
        "id": "años",
        "name": "años"
      }
    ],
    "default_unit": "meses",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  },
  {
    "id": "MANUFACTURING_TIME",
    "name": "Tiempo de elaboración",
    "tags": {
      "hidden": true
    },
    "hierarchy": "SALE_TERMS",
    "relevance": 2,
    "value_type": "number_unit",
    "value_max_length": 255,
    "allowed_units": [
      {
        "id": "días",
        "name": "días"
      }
    ],
    "default_unit": "días",
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros"
  }
]

Considerações

• No momento de configurar a disponibilidade de estoque, você não pode setear valores superiores a 45 dias.
• Não poderá especificar essas informações em publicações que correspondam às verticais Imóveis, Automóveis e Serviços.
• Não será permitido setear tempo de disponibilidade de estoque em itens que permitam envios flex ou pertençam a Fulfillment.
• Ao adicionar ou modificar o sale term, utilize sempre alguma das unidades disponíveis. Vai achá-las dentro da seção allowed_units. Seguindo o exemplo anterior, você pode apreciar que apenas a unidade “dias” está disponível para ser utilizada dentro da categoria MLA1577.

Criar item com disponibilidade de estoque

Para criar uma publicação com MANUFACTURING_TIME, você deve primeiro verificar e verificar se a categoria na qual deseja publicar tem MANUFACTURING_TIME disponível.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
  "site_id": "MLA",
  "title": "Item de testeo, por favor no contactar --kc:off",
  "category_id": "MLA1577",
  "price": 4000,
  "currency_id": "ARS",
  "pictures": [{
    "source": "http://mla-s2-p.mlstatic.com/777099-MLA26466460545_112017-O.jpg"
  }],
  "buying_mode": "buy_it_now",
  "listing_type_id": "gold_special",
  "condition": "new",
  "available_quantity": 10,
  "sale_terms": [{
    "id": "MANUFACTURING_TIME",
    "value_name": "20 días"
  }]
}
https://api.mercadolibre.com/items

Modificar disponibilidade de estoque

Execute um PUT semelhante ao anterior especificando o novo valor do sale_term em value_name.

Exemplo:

curl -X PUT -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
   "sale_terms": [{
       "id": "MANUFACTURING_TIME",
       "value_name": "30 días"
   }]
}
https://api.mercadolibre.com/items/11000222

Eliminar disponibilidade de estoque

Para eliminar o sale term MANUFACTURING_TIME, envie null nos campos value_id e value_name dele.

Chamada:

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

Quantidade máxima de compra

Quantidade máxima

No contexto do consumo responsável pela Covid-19, limitamos o número de itens por compra para evitar o abuso e a escassez de produtos essenciais na categoria Supermercado. Verifique se a categoria possui a condição quantidade máxima de compra por operação com $CATEGORY_ID.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLM167991/sale_terms

Resposta:

{
  [
[...]
{
        "id": "PURCHASE_MAX_QUANTITY",
        "name": "Cantidad máxima de compra",
        "tags": {
            "hidden": true,
            "read_only": true
        },
        "hierarchy": "SALE_TERMS",
        "relevance": 2,
        "value_type": "number",
        "value_max_length": 18,
        "attribute_group_id": "OTHERS",
        "attribute_group_name": "Otros"
    }
[...]
]
}

Carregue o valor máximo de compra em uma publicação

Chamada:

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

Exemplo:

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

Conheça mais sobre Sincronizamos suas publicações.