Como manter Anúncios no Mercado Livre

Olá, desenvolvedor!

   Neste artigo, iremos descrever um passo-a-passo sobre como funcionam os anúncios no ML. Antes disso, é importante contextualizar como funcionam os anúncios neste canal de vendas:

   O Mercado Livre oferece três tipos de anúncios, sendo eles: grátis, clássico e premium. O anúncio grátis é elegível apenas para alguns produtos, sendo eles na sua maioria produtos usados, e não dispõe de um bom ranqueamento, portanto não é nem um pouco indicado para varejistas, portanto não há este formato de anúncio disponível em nossa plataforma.

   A criação de diferentes tipos de anúncios é uma das estratégias adotadas por vendedores no mercado livre, isto é, oferecer por um preço a mais alguns recursos como parcelamento sem juros, ter mais visitas e clientes acharem seus produtos mais rapidamente. 

Introdução

Diferentemente dos outros canais, o Mercado Livre possui a particularidade de permitir mais de um anúncio para um mesmo SKU. É possível, por exemplo, cadastrar dois anúncios para a mesma variação de uma camiseta, cada um com preço, nome e descrição diferente do outro.

Sendo assim, implementamos três novas rotas para que seja possível realizar o controle destes cadastros. Sendo assim, não mais é possível realizar este controle por meio das rotas POST e PUT products.

Como criar um anúncio no Mercado Livre

URL:

Sandbox: POST https://api.sandbox.plug4market.com.br/products/announcements

Produção: POST https://api.plug4market.com.br/products/announcements

JSON:

{
   "saleChannel": 7,
   "announcements": [
   {
      "sellerId": "1111111111111",
      "listingType": "CLASSICO",
      "sku": "1100100001-8",
      "description": "Teste teste\r\nteste\r\nteste",
      "productName": "Suporte Para Cpu Com Rodinhas Gv Preto-8"
   }
]
}

Vale lembrar que, para obter o sellerId, é necessário contatar nossa equipe de suporte e os tipos de anúncio permitidos no Mercado Livre são "CLASSICO" e "PREMIUM"

Como alterar um anúncio no Mercado Livre

URL:

Sandbox: PUT https://api.sandbox.plug4market.com.br/products/(SKU)/announcements

Produção: PUT https://api.plug4market.com.br/products/{sku}/announcements

JSON:

{
   "announcementId": "646e20eb1b195f000188b1fe",
   "saleChannel": 7,
   "sellerId": "123",
   "listingType": "CLASSICO",
   "description": "Descrição alterada 123",
   "productName": "teste dos anúncios",
   "price": 50,
   "forSale": {
      "salePrice": 599.99,
      "saleDateStart": "2020-04-30T13:22:00Z",
      "saleDateEnd": "2025-05-30T13:22:00Z"
   }
} 

Obs: Para obter a informação "announcementId", é necessário consultar o SKU pela rota GET https://api.sandbox.plug4market.com.br/products/{sku}. O campo será retornado dentro de um array de objetos chamado mercadoLivreAds, conforme exemplo: 

{
   "id": "63446ee6f88f1000017bb30b",
   "sku": "0004539",
   "productId": "00549-5",
   "skuAssociation": null,
   "storeId": "616dd9d0c918e60001c81ea1",
   "customId": "000011",
   "saleChannelProductId": null,
   "saleChannelsku": null,
   "categoryId": "5d420cb3e2f97a00163d677f",
   "saleChannel": null,
   "salesChannels": [
      7
   ],
   "saleChannelStatus": null,
   "saleChannelStatusUpdateDate": [],
   "saleChannelErrors": [],
   "createProduct": "2022-10-10T19:13:42.988Z",
   "updateProduct": "2023-05-30T13:33:29.89Z",
   "productName": "Tênis Casual De Botões Lolla Maria",
   "name": "Tênis Casual De Botões Lolla Maria Preto-39",
   "newProduct": true,
   "reviewed": false,
   "blockedMarketplaceIntegration": false,
   "mercadoLivreAds": [
   {
      "id": "63446ee7f88f1000017bb30e",
      "sellerId": "876456456",
      "sellerName": "TESTE_V1",
      "listingTypeId": "gold_special",
      "logisticType": null,
      "saleChannelProductId": null,
      "saleChannelsku": null,
      "skuAssociation": null,
      "saleChannelStatus": 9,
      "saleChannelStatusUpdateDate": [
      {
         "updateDate": "2022-10-10T19:13:43.013Z",
         "saleChannelStatus": 9
      }
   ],
   "saleChannelErrors": null,
   "overwritePrice": true,
   "price": 44.99,
   "salePrice": 42.99,
   "saleDateStart": "2023-02-26T11:00:00Z",
   "saleDateEnd": "2023-02-28T22:00:00Z",
   "productName": null,
   "description": null
}

Como excluir um anúncio do Mercado Livre

URL:

Sandbox: DELETE https://api.sandbox.plug4market.com.br/products/{SKU}/announcements

Produção: DELETE https://api.plug4market.com.br/products/{SKU}/announcements

JSON:

{
   "announcementId": "646e12291b195f000188b1df",
   "saleChannel": 7,
   "sellerId": "123",
   "listingType": "PREMIUM"
}

Obs: As informações devem ser exatamente as mesmas do anúncio.