Campaña co-fondeada para PIX

Consultar detalle de la campaña

Identifica las campañas cofinanciadas para pagos con Pix mediante el type BANK y sub_type COFINANCED.

Para obtener los detalles de la promoción del type BANK puedes realizar la siguiente consulta:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=BANK&app_version=v2

Respuesta:

{
  "id": "P-MLB369023",
  "type": "BANK",
  "sub_type": "COFINANCED",
  "status": "pending",
  "start_date": "2025-01-31T03:00:00Z",
  "finish_date": "2025-02-31T02:59:59Z",
  "deadline_date": "2025-02-31T02:59:59Z",
  "name": "test promotion pix",
  "payment_method": "PIX"
}

Campos de respuesta

• id: identificador de la campaña.
• type: tipo de campaña (BANK).
• sub_type: subtipo de campaña (COFINANCED).
• status: status de la campaña. Valores posibles:
  • pending: promoción aprobada que aún no inició.
  • started: promoción activa.
  • finished: promoción finalizada.
• start_date: fecha que empieza la campaña.
• finish_date: fecha que se cierra la campaña.
• name: nombre de la campaña.
• payment_method: es el método de pago bancario, PIX.

Consultar ítems de una campaña

Para conocer los ítems que forman parte de una campaña Bank puedes realizar la siguiente consulta:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID/items?promotion_type=BANK&app_version=v2

Respuesta:

{
  "id": "MLB535819198",
  "status": "candidate|started|pending",
  "original_price": 5000,
  "offer_id": "OFFER-MLB535819198-123456",
  "meli_percentage": 8,
  "seller_percentage": 11,
  "start_date": "2025-01-31T03:00:00Z",
  "end_date": "2025-02-31T02:59:59Z",
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 1
  }
}

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

Indicar ítems para una campaña

Una vez que el status del ítem es candidate, puedes sumarlo a la campaña.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "promotion_id": "$PROMOTION_ID",
  "promotion_type": "$PROMOTION_TYPE",
  "offer_id":"CANDIDATE-MLB1-0101"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
  "promotion_id": "P-MLA81",
  "promotion_type": "BANK",
  "offer_id":"CANDIDATE-MLB1-0101"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB3293481659?app_version=v2

Respuesta:

{
  "price": 0,
  "original_price": 0,
  "offer_id": "OFFER-MLA123-1111"
}

Parámetros obligatorios:

• promotion_id: es el id de la campaña.
• promotion_type: BANK para este tipo de campañas.
• offer_id: id del candidato a subir a la campaña. Puede obtenerse del endpoint Consultar ítems de una campaña.

Campos de respuesta:

• price: indica el nuevo precio rebajado.
• original_price: es el precio original sobre el que se aplica el descuento.
• offer_id: id de la oferta subida.

Modificar ítems

Para modificar el precio de un ítem que se encuentra participando de una campaña Bank se deben realizar los siguientes pasos, ya que no es posible modificar el precio directamente.

1. 1. Eliminar el ítem de la campaña.
2. 2. Modificar el precio del ítem como la sincronización de precio normal.
3. 3. Incluir nuevamente el ítem dentro de la campaña.

Eliminar Campaña

Podrás eliminar una oferta en estado pendiente o activo.

Llamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=BANK&promotion_id=$PROMOTION_ID&offer_id=$OFFER_ID&app_version=v2

Errores

• 400 - Bad Request:
  • No offers found for item: se da cuando no se encuentran ofertas para el itemId ingresado.
  • Invalid promotion type: se da cuando no se envía promotion_type correcto, ya sea porque no es un tipo de promoción válido o porque aún no se habilitaron campañas de volumen y se está consultando por una campaña de id C-MLXXXX.