Descuento pre-acordado por ítem
Vista del vendedor

Consultar detalles de una campaña con descuento pre-acordado
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=PRE_NEGOTIATED
Respuesta:
{
"id": "P-MLM394001",
"type": "PRE_NEGOTIATED",
"status": "started",
"start_date": "2021-03-30T18:30:15.525Z",
"finish_date": "2021-12-27T17:59:59.525Z",
"deadline_date": "2021-05-27T17:59:59.525Z",
"name": "Prueba descuento x item sin benefit",
"offers": [
{
"id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
"original_price": 101,
"new_price": 21,
"status": "active",
"start_date": "2021-05-10T16:00:00Z",
"end_date": "2021-05-11T15:00:00Z",
"benefits": {
"type": "REBATE",
"meli_percent": 9.9,
"seller_percent": 69.3
}
}
]
}
Campos específicos de esta campaña
Offers: Detalle del descuento pre-acordado
- type: tipo de beneficio
- meli_percent: porcentaje que aporta Mercado Libre
- seller_percent: porcentaje que aporta el vendedor
Estados
Estos son los distintos estados por los que puede pasar una campaña con descuento pre-acordado.
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 con descuento pre-acordado
Para conocer los ítems que forman parte de una campaña con descuento pre-acordado puedes realizar la siguiente consulta:
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLM686/items?promotion_type=PRE_NEGOTIATED
Respuesta:
{
"results": [
{
"id": "MLM848619385",
"status": "candidate",
"price": 21,
"original_price": 101,
"offer_id": "MLM848619385-0e2f3064-0e13-425d-b4a7-0dee85414835",
"meli_percentage": 24.8,
"seller_percentage": 54.5,
"start_date": "2021-05-11T22:00:00Z",
"end_date": "2021-05-13T01:00:00Z"
}
],
"paging": {
"total": 1
}
}
Al crearse una nueva campaña se seleccionan todos los ítems aplicables a la misma. El estado inicial (status) de los ítems es "candidate"y cuentan con un "offer_id" único. Al momento que el vendedor incorpora un ítem a la campaña su status se modifica y pasa a estar programmed o active.
Estado de los ítems
En la siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.
Estado | Descripción |
---|---|
candidate | Ítem candidato para participar de la promoción. |
pending | Ítem con promoción aprobada y programada. |
started | Ítem activo en la campaña |
finished | Ítem eliminado de la campaña. |
Aceptar descuento pre-acordado por ítem
Una vez que se ha acordado un descuento para un ítem, con el siguiente recurso se puede dar la confirmación por parte del vendedor al pre-acuerdo.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
"deal_id":"$DEAL_ID",
"offer_id":"$OFFER_ID",
"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":"P-MLM394001",
"offer_id":"MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
"promotion_type":"PRE_NEGOTIATED"
}'
https://api.mercadolibre.com/seller-promotions/items/MLM848619385
Respuesta:
{
"offer_id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
"price": 21,
"original_price": 101
}
Parámetros
deal_id: identificación de la promoción.
offer_id: identificación de la oferta acordada.
promotion_type: tipo de promoción (PRE_NEGOTIATED).
Eliminar descuento pre-acordado
Con esta función puede 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&offer_id=$OFFER_ID
Ejemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLB1834747833?promotion_type=PRE_NEGOTIATED&deal_id=P-MLM394001&offer_id=MLM1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8
Respuesta: Status 200 OK
Next post: Descuento individual