Campanhas de desconto por volume
Visão do vendedor

Consultar os detalhes de uma campanha com desconto por volume
Para obter os detalhes de uma campanha de desconto por volume, faça a seguinte consulta:
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB379009?promotion_type=VOLUME
Resposta:
{
"id": "P-MLB379009",
"type": "VOLUME",
"status": "started",
"start_date": "2021-03-25T16:40:00Z",
"finish_date": "2021-04-30T18:00:00Z",
"deadline_date": "2021-04-30T18:00:00Z",
"name": "test volume MLB",
"benefits": {
"type": "VOLUME",
"meli_percent": 8,
"seller_percent": 17,
"name": "4x3",
"buy_quantity": 4,
"pay_quantity": 3,
"item_discount_percent": 25
}
}
Campos específicos desta campanha
Benefícios: Detalhe dos benefícios da promoção.
Tipos de desconto
Estes são os diferentes tipos de descontos que existem neste tipo de campanha:
- Leva 4 paga 3
- 70% OFF comprando 2
- 70% OFF na 2ª unidade
Status
Esses são os diferentes status pelos quais uma campanha de desconto por volume pode passar.
Status | Descrição |
---|---|
pending | Promoção aprovada que ainda não começou. |
started | Promoção ativa |
finished | Promoção finalizada |
Consultar os itens em uma campanha de desconto por volume
Para conhecer os itens candidatos e / ou que fazem parte de uma campanha com desconto por volume, pode-se fazer a seguinte consulta:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB379009/items?promotion_type=VOLUME
Resposta:
{
"results": [
{
"id": "MLB1834747833",
"status": "candidate",
"price": 0,
"original_price": 0
},
{
"id": "MLB1834747833",
"status": "active",
"price": 3750,
"original_price": 5000,
"offer_id": "MLB1834747833-47a4b043-adb6-4e29-93b7-b36880013fef"
}
],
"paging": {
"total": 2
}
}
Ao criar uma nova campanha, todos os itens aplicáveis a ela são selecionados. O estado inicial (status) dos itens é "candidato" e sem um ID de oferta atribuído. Assim que o vendedor incorpora um item à campanha, seu status é modificado e um "offer_id" exclusivo é atribuído a ele.
Status dos itens
Na tabela a seguir pode encontra os possíveis status que os itens podem assumir neste tipo de campanha.
Status | Descrição |
---|---|
candidate | Item candidato a participar da promoção |
programmed | Item com promoção aprovada e programada |
active | Item ativo na campanha |
Indicando itens para uma campanha de desconto por volume
Depois de ter sido convidado a participar neste tipo de campanha, você pode indicar quais produtos deseja incluir nela.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
"deal_id":"$DEAL_ID",
"promotion_type":"$PROMOTION_TYPE"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
Exemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
"deal_id":"P-MLB379009",
"promotion_type":"VOLUME"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1834747833
Resposta:
{
"offer_id": "MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
"price": 1800,
"original_price": 2000
}
Parâmetros
deal_id: identificação da promoção.
promotion_type: tipo de promoção (VOLUME).
Modificar itens
Para modificar o preço de um item que participa de uma campanha com desconto por volume, devem ser realizados os seguintes passos, uma vez que não é possível modificar o preço diretamente.
- Eliminar o item da campanha
- Modifique o preço do item como sincronização normal de preço
- Incluir o item novamente na campanha
Eliminar itens
Com este recurso você pode eliminar a oferta do item.
Chamada:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&deal_id=$DEAL_ID&offer_id=$OFFER_ID
Exemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=VOLUME&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8
Resposta: Status 200 OK
Conheça mais sobre Desconto por volume.
Seguinte: Desconto pré-acordado por item
