Gestionar ofertas
Contenidos
→Consultar las ofertas disponibles para el vendedor
→Consultar detalles de la oferta
↳Estado de la oferta
→Consultar ítems de la oferta
→Participar en una oferta
→Consultar ofertas del ítem
→Modificar ítems en una oferta
→Eliminar ítems en una oferta
→Asignar campaña de prueba
Consultar las ofertas disponibles para el vendedor
Recuerda que un usuario puede tener más de una invitación y de diferentes tipos..
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/$USER_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/631366846
Respuesta:
{
"results": [
{
"id": "MLA686",
"type": "DEAL",
"status": "started",
"start_date": "2019-02-04T17:50:00Z",
"finish_date": "2020-10-31T17:20:00Z",
"deadline_date": "2020-09-29T22:00:00Z",
"name": "HOTSALE"
},
{
"id": "P-MLA119001",
"type": "MARKETPLACE_CAMPAIGN",
"status": "started",
"start_date": "2020-10-15T18:37:40.881Z",
"finish_date": "2020-12-30T18:37:40.881Z",
"deadline_date": "2020-12-29T22:00:00Z",
"name": "P-MLA1252"
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 2
}
}
Campos de la respuesta
id: código de identificación de la oferta.
type: tipo de la oferta (DEAL, MARKETPLACE_CAMPAIGN).
status: estado de campaña tradicional, estado de campaña co-fondeada.
start_date: fecha de inicio de la oferta.
finish_date: fecha de fin de la oferta.
deadline_date: plazo máximo para aceptar la invitación.
name: nombre de la oferta.
Consultar detalles de la oferta
Realiza la siguiente consulta con el parámetro promotion_type (DEAL o MARKETPLACE_CAMPAIGN).
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=$PROMOTION_TYPE
Conoce más detalles sobre campaña tradicional y campaña co-fondeada (marketplace campaign).
Estado de la oferta
A continuación puedes encontrar los posibles estados que pueden tener los distintos tipos de oferta: estados de campaña tradicional y estado de una campaña co-fondeada .
Consultar ítems de la oferta
Para conocer los ítems que forman parte de una determinada oferta puedes realizar la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTIONS_ID/items?promotion_type=PROMOTIONS_TYPE
Además, puedes consultar ítems de una campaña tradicional e ítems de una campaña co-fondeada .
Participar de una oferta
Puedes participar en distintos tipos de campañas y ofrecer un descuento individual para los ítems:
- Indicando ítems para una campaña tradicional.
- Indicando ítems para una campaña co-fondeada.
- Ofreciendo un descuento individual para un ítem.
Consultar ofertas del ítem
Para ofertas de tipo DEALS solo devolveremos los ítems con estado aprobado (status=approved).
No aprobaremos campañas con ítems test, es decir, quedarán con estado pending_approval y no mostraremos el precio con oferta.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946
Respuesta:
[
{
"id": "2864-MLA876768946",
"type": "PRICE_DISCOUNT",
"status": "started",
"price": 680,
"top_price": 570,
"start_date": "2020-09-09T00:00:00",
"finish_date": "2020-09-15T00:00:00"
},
{
"id": "MLA686",
"type": "DEAL",
"status": "started",
"price": 680,
"start_date": "2019-02-04T17:50:00Z",
"finish_date": "2020-10-31T17:20:00Z",
"deadline_date": "2020-09-30T02:00:00Z",
"name": "Super deal"
},
{
"id": "P-MLA119001",
"type": "MARKETPLACE_CAMPAIGN",
"status": "started",
"start_date": "2020-10-15T18:37:40.881Z",
"finish_date": "2020-12-30T18:37:40.881Z",
"name": "P-MLA1252"
}
]
Modificar ítems en una oferta
Puedes modificar los ítems que están participando en una determinada oferta:
Eliminar ítems en una oferta
Puedes eliminar los ítems que están participando en una determinada oferta:
- Eliminando ítems en una campaña tradicional.
- Eliminando ítems en una campaña co-fondeada.
- Eliminando descuento individual a un item.
Asignar campaña de prueba
Para realizar pruebas con campañas de test, envíanos los datos de tu usuario y/o ítems en el siguiente formulario.
Recuerda que tanto los usuarios como los ítems deben ser de test.