Campañas co-fondeadas
Consultar detalles de campaña co-fondeada
Para obtener los detalles de una oferta co-fondeada, realiza la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=MARKETPLACE_CAMPAIGN
Respuesta:
{
"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 de esta campaña
Benefits: Detalle de los beneficios de la promoción.
- type: el vendedor no podrá enviar mensajes al comprador.
- meli_percent: porcentaje que aporta Mercado Libre.
Estados
Estos son los distintos estados por los que puede pasar una campaña co-fondeada.
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 co-fondeada
Para conocer los ítems candidatos y/o que forman parte de una campaña co-fondeada 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=MARKETPLACE_CAMPAIGN
Respuesta:
{
"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
}
}
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 sin offer id asignado. Al momento que el vendedor incorpora un ítem a la campaña su status se modifica y se le asigna un "offer_id" único.
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 |
---|---|
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 |
Indicar ítems para una campaña co-fondeada
Una vez que has sido invitado a participar en una campaña co-fondeada, puedes indicar qué productos deseas incluir en la misma.
Llamada:
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
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
"deal_id":"P-MLB379009",
"promotion_type":"MARKETPLACE_CAMPAIGN"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1834747833
Respuesta:
{
"offer_id": "MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
"price": 1800,
"original_price": 2000
}
Parámetros
deal_id: identificación de la promoción.
promotion_type: tipo de promoción (MARKETPLACE_CAMPAIGN).
Modificar ítems
Para modificar el precio de un ítem que se encuentra participando de una campaña co-fondeada se deben realizar los siguientes pasos, ya que no es posible modificar el precio directamente.
Pasos:
- Eliminar el ítem de la campaña
- Modificar el precio del ítem como la sincronización de precio normal
- Incluir nuevamente el ítem dentro de la campaña
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&offer_id=$OFFER_ID
Ejemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=MARKETPLACE_CAMPAIGN&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8
Respuesta: Status 200 OK
Conoce más sobre Campañas co-fondeadas.
Next post: Campañas con descuento por volumen