Campañas tradicionales
Contenidos
→Consultar detalle de una campaña tradicional
↳Estados
→Consultar ítems en una campaña tradicional
↳Estado de los ítems
→Filtrar por ítems y estado
→Indicar ítems para una campaña tradicional
→Modificar ítems
→Eliminar ítems
Consultar detalle de una campaña tradicional
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",
"categories": [
"MLA1182",
"MLA3937",
"MLA1459"
]
}
El detalle de cada campo de la respuesta lo puedes encontrar en gestionar promociones .
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 una campaña tradicional
Para conocer los ítems que forman parte de una campaña tradicional 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. |
Filtrar por ítems y estado
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=DEAL&status=$STATUS&item_id=$ITEM_ID
Ejemplo de filtro por ítem:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&item_id=MLA604400000
Respuesta:
{
"results": [
{
"id": "MLA604400000",
"status": "rejected",
"price": 23968,
"original_price": 28549
}
],
"paging": {...}
}
Ejemplo de filtro por status approved:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&status=approved
Respuesta:
{
"results": [
{
"id": "MLA639970000",
"status": "approved",
"price": 4037,
"original_price": 4427
},
{
"id": "MLA639973333",
"status": "approved",
"price": 6007,
"original_price": 6587
},
],
"paging": [...]
}
Indicar ítems para una campaña tradicional
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 en una promoción realiza la siguiente operación:
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
Next post: Campañas co-fondeadas