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

# Resgatar recompensas em massa

As recompensas geralmente são resgatadas por meio de uma das suas integrações com o Advocate. Se precisar resgatar recompensas manualmente em um sistema externo, você pode usar este processo de resgate em lote para atualizar os saldos de recompensas disponíveis dos participantes.

{% hint style="success" %}
**Observação:** Este processo não emitirá recompensas específicas — como créditos, cartões-presente ou códigos de cupom — para os participantes. Em vez disso, ele atualiza seus registros para exibir corretamente os saldos de recompensas dos participantes depois que você resgatar as recompensas por outro sistema.
{% endhint %}

{% stepper %}
{% step %}
**Etapa 1: Baixar um relatório de saldos de recompensas disponíveis por usuário**

Este relatório lista todos os participantes com saldos de recompensas disponíveis em cada programa. Você pode usá-lo para resgatar recompensas manualmente em um sistema externo.

1. No menu de navegação à esquerda, selecione ![](https://res.cloudinary.com/product-enablement/image/upload/v1768905009/Accessibility%20Icons/engage-v2.svg) **\[Engage] → Reporting → Imports & Exports**.
2. Selecione **Criar relatório**.
3. Em *Escolher um tipo de relatório*, selecione **Saldos de recompensas disponíveis por usuário**.
4. Opcionalmente, selecione uma unidade de recompensa específica para limitar a lista de participantes. Isso pode ser útil se você quiser restringir o relatório gerado a uma única unidade de recompensa paga por um serviço externo.
5. Selecione o formato do relatório (.CSV ou Excel).
6. Selecione **Criar relatório**.

Um link para o relatório gerado será enviado ao endereço de e-mail associado a esta conta.
{% endstep %}

{% step %}
**Etapa 2: Atualizar o relatório**

Depois de resgatar manualmente as recompensas no sistema externo, você precisará atualizar o relatório de *saldos de recompensas disponíveis por usuário* . Assim, o Advocate poderá identificar quais participantes já tiveram suas recompensas resgatadas.

1. Em um aplicativo de planilhas, abra o relatório de *saldos de recompensas disponíveis por usuário* .
2. Para cada participante cujo resgate de recompensa foi feito manualmente, atualize a coluna `valueToRedeem` . Somente números positivos são aceitos.
3. Salve o relatório no formato .CSV.

**Observações sobre o resgate**

* Os saldos de recompensas precisam ser resgatados na mesma unidade (*por exemplo*. `CENTS` ou `CASH/USD`) em que o saldo é exibido (*ou seja,* não é possível resgatar dólares em valores de centavos).
* Somente as alterações no campo `valueToRedeem` serão processadas durante uma importação.
* As recompensas individuais de um saldo serão resgatadas na ordem de vencimento (`dateExpires`) e, em seguida, pela ordem em que foram disponibilizadas ao participante (`dateGiven`).
* Somente recompensas com status `AVAILABLE` serão resgatadas.
* Frações da unidade fracionária serão truncadas no resgate (*por exemplo,* um resgate de "10.556 USD" resgatará apenas "10.55 USD").
  {% endstep %}

{% step %}
**Etapa 3: Enviar o relatório atualizado**

Por fim, você precisará enviar para o Advocate seu relatório de *saldos de recompensas disponíveis por usuário* com os saldos atuais de recompensas.

1. No menu de navegação à esquerda, selecione ![](https://526234278-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. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) **Importar**.
3. Em *Tipo de importação*, selecione **Atualizar saldos de recompensas dos usuários**.
4. Para adicionar seu relatório atualizado, selecione **Escolher arquivo**.
5. Selecione **Importar**.

Quando a importação for concluída, você receberá um e-mail de confirmação. As importações podem levar até 30 minutos, dependendo da fila e do tamanho do arquivo.
{% 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/pt-br/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.
