Campanha com participação do Mercado Livre
Consultar detalhes da campanha com participação do Mercado Livre
Para obter os detalhes de uma oferta com participação do Mercado Livre, realize o seguinte consulta.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=MARKETPLACE_CAMPAIGN'
Resposta:
{
"id": "MLA686",
"type": "MARKETPLACE_CAMPAIGN",
"status": "started",
"start_date": "2019-02-04T17:50:00Z",
"finish_date": "2020-10-31T17:20:00Z",
"deadline_date": "2020-09-30T02:00:00Z",
"name": "P-MLA1252",
"benefits": {
"type": "REBATE",
"meli_percent": 20,
"seller_percent": 10
}
}
Campos específicos desta campanha
Benefits: Detalhe dos benefícios da promoção.
- type: tipo de benefício.
- meli_percent: porcentagem contribuída pelo Mercado Livre.
Status
Esses são os diferentes estados pelos quais uma campanha cofinanciada pode passar:
Status | Descrição |
---|---|
pending | Promoção aprovada que ainda não começou. |
started | Promoção ativa. |
finished | Promoção finalizada. |
Consultar itens em uma campanha com participação do Mercado Livre
Para conhecer os itens candidatos e / ou que fazem parte de uma campanha coparticipação, 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=MARKETPLACE_CAMPAIGN
Resposta:
{
"results": [
{
"id": "MLA877277006",
"status": "ACTIVE",
"price": 1349,
"original_price": 1500,
"offer_id": "MLA877277006-e2c63989-ad16-4ef3-9b6d-0c6da0ac40a5"
},
{
"id": "MLA1767902544",
"status": "candidate",
"price": 0,
"original_price": 0
}
],
"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 é atribuído um "offer_id" único.
Status do 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 candidato a participar da promoção. |
programmed | Item com promoção aprovada e programada. |
active | Item ativo na campanha. |
Indicar itens para uma campanha com participação do Mercado Livre
Depois de ter sido convidado a participar de uma campanha de coparticipação, 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-MLA147001",
"promotion_type":"MARKETPLACE_CAMPAIGN"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876618673
Resposta:
{
"offer_id": "MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
"price": 1800,
"original_price": 2000
}
Parâmetros
deal_id: identificação da oferta do tipo MARKETPLACE_CAMPAIGN.
promotion_type: oferta do tipo MARKETPLACE_CAMPAIGN.
Modificar itens
Para modificar o preço de um item que pertence a uma campanha com participação do Mercado Livre devem ser realizados os seguintes passos, já que não é possível modificar o preço diretamente.
Passos:
- Exclua o item da campanha
- Modifique o preço do item como se você fosse realizar uma sincronização normal de preços
- Inclua o item novamente à campanha
Eliminar itens
Com este recurso é possível eliminar uma 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/MLB1834747833?promotion_type=MARKETPLACE_CAMPAIGN&deal_id=P-MLB379009&offer_id=MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8'
Resposta: Status 200 OK
Conheça mais sobre Descontos por quantidade.
Seguinte: Campanhas de desconto por volume
