Campañas tradicionales
Contenidos
→Consultar detalle de deal
↳Estados
→Consultar ítems en un deal
↳Estado de los ítems
→Indicar ítems para un deal
→Modificar ítems
→Eliminar ítems
Consultar detalle de deal
Para obtener los detalles de una oferta de tipo Deal, realiza la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=DEAL
Respuesta:
{
"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"
}
Estados
Estos son los distintos estados por lo que puede pasar una campaña tradicional.
Estado | Descripción |
---|---|
pending | Promoción aprobada que aún no inició. |
started | Promoción activa. |
finished | Promoción finalizada. |
Consultar ítems en un deal
Para conocer los ítems que forman parte de una determinado deal puedes realizar la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686/items?promotion_type=DEAL
Respuesta:
{
"results": [
{
"id": "MLA875050287",
"status": "pending_approval",
"price": 300,
"original_price": 1000
},
{
"id": "MLA876387768",
"status": "pending_approval",
"price": 900,
"original_price": 1000
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 2
}
}
Estado de los ítems
En las siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.
Estado | Descripción |
---|---|
approved | Ítem aprobado para la oferta. |
pending_approval | Ítem pendiente de aprobación para la oferta. |
rejected | Ítem rechazado para la oferta. |
Indicar ítems para un deal
Una vez invitado a participar en una campaña de ofertas, puedes indicar qué productos deseas incluir en la misma.
Llamada:
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
Ejemplo:
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
Respuesta:
{
"price": 240,
"original_price": 350
}
Parámetros
deal_id: identificación de la promoción.
regular_price: precio del ítem antes de incluirse en la promoción.
deal_price: precio del ítem en la promoción.
promotion_type: tipo de promoción (DEAL.)
Modificar ítems
Para modificar los ítems que están participando de una oferta realiza el siguiente PUT:
Llamada:
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
Ejemplo:
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
Respuesta:
{
"price": 220,
"original_price": 350
}
Eliminar ítems
Con este recurso podrás eliminar la oferta del ítem.
Llamada:
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
Ejemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=DEAL&deal_id=1804
Respuesta: Status 200 OK