> 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/it/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md).

# Riscatta le ricompense in blocco

I premi vengono in genere riscattati tramite una delle tue integrazioni con Advocate. Se devi erogare manualmente i premi in un sistema esterno, puoi usare questa procedura di riscatto massivo per aggiornare i saldi dei premi disponibili dei partecipanti.

{% hint style="success" %}
**Nota:** Questa procedura non assegna ai partecipanti premi specifici, come crediti, buoni regalo o codici sconto. Aggiorna invece i tuoi dati per mostrare correttamente i saldi dei premi dei partecipanti dopo che li hai riscattati tramite un altro sistema.
{% endhint %}

{% stepper %}
{% step %}
**Passaggio 1: scarica un report dei saldi dei premi disponibili per utente**

Questo report elenca tutti i partecipanti con saldi dei premi disponibili per ciascun programma. Puoi usarlo per erogare manualmente i premi in un sistema esterno.

1. Nel menu di navigazione a sinistra, seleziona ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **\[Engage] → Reporting → Imports & Exports**.
2. Seleziona **Create Report**.
3. In *Choose a report type*, seleziona **Available reward balances by user**.
4. Facoltativamente, seleziona un'unità premio specifica per restringere l'elenco dei partecipanti. Può essere utile se vuoi limitare il report generato a una singola unità premio erogata tramite un servizio esterno.
5. Seleziona il formato del report (.CSV o Excel).
6. Seleziona **Create Report**.

Un link al report generato verrà inviato all'indirizzo email associato a questo account.
{% endstep %}

{% step %}
**Passaggio 2: aggiorna il report**

Dopo aver erogato manualmente i premi nel sistema esterno, dovrai aggiornare il report *available reward balances by user* . In questo modo, Advocate saprà quali partecipanti hanno ricevuto i premi.

1. Apri il report *available reward balances by user* usando un'applicazione per fogli di calcolo.
2. Per ogni partecipante a cui hai erogato manualmente un premio, aggiorna la colonna `valueToRedeem` . Sono accettati solo numeri positivi.
3. Salva il report in formato .CSV.

**Note sul riscatto**

* I saldi dei premi devono essere riscattati nella stessa unità (*ad es.*. `CENTS` o `CASH/USD`) in cui è mostrato il saldo (*ovvero* non è possibile riscattare importi in dollari usando i centesimi).
* Durante l'importazione verranno elaborate solo le modifiche al campo `valueToRedeem` .
* I singoli premi inclusi in un saldo verranno riscattati in base alla data di scadenza (`dateExpires`) e, a seguire, alla data in cui sono stati resi disponibili al partecipante (`dateGiven`).
* Verranno riscattati solo i premi con stato `AVAILABLE` .
* Le frazioni dell'unità frazionaria verranno troncate al momento del riscatto (*ad es.* riscattando "10.556 USD" verranno riscattati solo "10.55 USD").
  {% endstep %}

{% step %}
**Passaggio 3: carica il report aggiornato**

Infine, dovrai caricare il *report dei saldi dei premi disponibili per utente* con i saldi attuali dei premi in Advocate.

1. Nel menu di navigazione a sinistra, seleziona ![](https://1043985218-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. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) **Importa**.
3. In *Tipo di importazione*, seleziona **Aggiorna i saldi dei premi degli utenti**.
4. Per aggiungere il report aggiornato, seleziona **Scegli file**.
5. Seleziona **Importa**.

Al termine dell'importazione, riceverai un'email di conferma. L'importazione può richiedere fino a 30 minuti, a seconda della coda e delle dimensioni del file.
{% 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/it/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.
