> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md).

# Canjear recompensas en bloque

Las recompensas suelen canjearse a través de una de tus integraciones con Advocate. Si necesitas entregar recompensas manualmente en un sistema externo, puedes usar este proceso de canje masivo de recompensas para actualizar los saldos de recompensas disponibles de tus participantes.

{% hint style="success" %}
**Nota:** Este proceso no emitirá recompensas específicas —como crédito, tarjetas de regalo o códigos de cupón— a los participantes. En su lugar, actualiza tus registros para mostrar correctamente los saldos de recompensas de los participantes después de que hayas canjeado las recompensas a través de otro sistema.
{% endhint %}

{% stepper %}
{% step %}
**Paso 1: Descarga un informe de saldos de recompensas disponibles por usuario**

Este informe muestra a todos los participantes con saldos de recompensas disponibles en cada programa. Puedes usarlo para entregar recompensas manualmente en un sistema externo.

1. En el menú de navegación de la izquierda, selecciona ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **\[Engage] → Reporting → Imports & Exports**.
2. Selecciona **Crear informe**.
3. En *Elegir un tipo de informe*, selecciona **Saldos de recompensas disponibles por usuario**.
4. Opcionalmente, selecciona una unidad de recompensa específica para reducir la lista de participantes. Esto puede ser útil si quieres limitar el informe generado a una unidad de recompensa específica que se haya pagado mediante un servicio externo.
5. Selecciona el formato del informe (.CSV o Excel).
6. Selecciona **Crear informe**.

Se enviará un enlace al informe generado a la dirección de correo electrónico asociada a esta cuenta.
{% endstep %}

{% step %}
**Paso 2: Actualiza el informe**

Después de entregar recompensas manualmente en tu sistema externo, tendrás que actualizar el informe de *saldos de recompensas disponibles por usuario* . Esto le permitirá a Advocate saber qué participantes ya recibieron sus recompensas.

1. Abre el informe de *saldos de recompensas disponibles por usuario* en una aplicación de hojas de cálculo.
2. Para cada participante al que hayas entregado una recompensa manualmente, actualiza la columna `valueToRedeem` . Solo se aceptan números positivos.
3. Guarda el informe en formato .CSV.

**Notas sobre el canje**

* Los saldos de recompensas deben canjearse en las mismas unidades (*p. ej.*. `CENTS` o `CASH/USD`) en las que se muestra el saldo (*es decir,* No se pueden canjear dólares en cantidades de centavos).
* Durante una importación, solo se procesarán los cambios realizados en el campo `valueToRedeem` .
* Las recompensas individuales de un saldo se canjearán según su fecha de vencimiento (`dateExpires`) y, después, según la fecha en que estuvieron disponibles para el participante (`dateGiven`).
* Solo se canjearán las recompensas con el estado `AVAILABLE` .
* Al canjear, las fracciones de la unidad fraccionaria se truncarán (*p. ej.* al canjear "10.556 USD", solo se canjearán "10.55 USD").
  {% endstep %}

{% step %}
**Paso 3: Sube el informe actualizado**

Por último, tendrás que subir tu *informe de saldos de recompensas disponibles por usuario* con los saldos actuales de las recompensas a Advocate.

1. En el menú de navegación de la izquierda, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Reporting → Imports & Exports**.
2. Selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) **Importar**.
3. En *Tipo de importación*, selecciona **Actualizar saldos de recompensas de usuarios**.
4. Para añadir el informe actualizado, selecciona **Elegir archivo**.
5. Selecciona **Importar**.

Cuando se complete la importación, se enviará un correo electrónico de confirmación. Las importaciones pueden tardar hasta 30 minutos, según la cola y el tamaño del archivo.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
