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.
Comentários
0 comentário
Por favor, entre para comentar.