Campanhas tradicionais
Consultar detalhes de uma campanha tradicional
Para obter os detalhes de uma oferta do tipo Deal, realize o seguinte GET:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=DEAL
Resposta:
{
"id": "MLA686",
"type": "DEAL",
"status": "started",
"start_date": "2019-02-04T17:50:00Z",
"finish_date": "2020-10-31T17:20:00Z",
"deadline_date": "2020-09-30T02:00:00Z",
"name": "HOTSALE",
"categories": [
"MLA1182",
"MLA3937",
"MLA1459"
]
}
O detalhe de cada campo da resposta pode ser encontrado em gerenciar promoções.
Status
Esses são os diferentes estados pelos quais uma campanha tradicional pode passar:
Status | Descrição |
---|---|
pending | Promoção aprovada que ainda não iniciou. |
started | Promoção ativa. |
finished | Promoção finalizada. |
Consultar itens de uma campanha tradicional
Para conhecer os itens que fazem parte de uma campanha tradicional pode-se fazer a seguinte consulta:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/MLA686/items?promotion_type=DEAL'
Resposta:
{
"results": [
{
"id": "MLA875050287",
"status": "pending_approval",
"price": 300,
"original_price": 1000
},
{
"id": "MLA876387768",
"status": "approved",
"price": 900,
"original_price": 1000
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 2
}
}
Status dos itens
Na tabela a seguir você encontra os possíveis status que os itens podem assumir neste tipo de campanha.
Status | Descrição |
---|---|
candidate | Item elegível para a deal. |
pending | Item foi enviado para a deal porém não iniciou. |
started | Item com deal já iniciada. |
Identificar itens para uma campanha tradicional
Uma vez convidado a participar de uma campanha, você pode indicar quais produtos deseja incluir nela.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
"deal_id":"$DEAL_ID",
"regular_price":$REGULAR_PRICE,
"deal_price":$DEAL_PRICE,
"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":"MLA1804",
"regular_price":350,
"deal_price":240,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876768946
Resposta:
{
"price": 240,
"original_price": 350
}
Parâmetros
deal_id: identificação da promoção.
regular_price: preço do item antes de ser incluído na promoção.
deal_price: preço do item na promoção.
promotion_type: tipo de promoção (DEAL).
Modificar itens
Para modificar os itens que estão participando de uma promoção, execute a seguinte operação:
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
"deal_id":"$DEAL_ID",
"regular_price":$REGULAR_PRICE,
"deal_price":$DEAL_PRICE,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
Exemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
"deal_id":"MLA1804",
"regular_price":350,
"deal_price":220,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1676902612
Resposta:
{
"price": 220,
"original_price": 350
}
Eliminar itens
Com este recurso você pode eliminar itens de uma campanha tradicional.
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'
Exemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=DEAL&deal_id=1804'
Resposta: Status 200 OK
