> 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

Os prêmios geralmente são resgatados por meio de uma de suas integrações com a Advocate. Se você precisar processar manualmente os prêmios em um sistema externo, então pode usar este processo de resgate em massa de prêmios para atualizar os saldos de prêmios disponíveis dos seus participantes.

{% hint style="success" %}
**Observação:** Esse processo não emitirá prêmios específicos — como crédito, cartões-presente ou códigos de cupom — para os participantes. Em vez disso, ele atualiza seus registros para exibir com precisão os saldos de prêmios dos participantes depois que você tiver resgatado os prêmios por meio de outro sistema.
{% endhint %}

{% stepper %}
{% step %}
**Etapa 1: Baixe um relatório de saldos de prêmios disponíveis por usuário**

Este relatório lista todos os participantes com saldos de prêmios disponíveis em cada programa. Você pode usar este relatório para processar manualmente prêmios 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] → Relatórios → Importações e exportações**.
2. Selecione **Criar relatório**.
3. Em *Escolha um tipo de relatório*, selecione **Saldos de prêmios disponíveis por usuário**.
4. Opcionalmente, selecione uma unidade de prêmio específica para restringir a lista de participantes. Isso pode ser útil se você quiser limitar o relatório gerado a uma unidade de prêmio específica que foi paga por meio de 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 para o endereço de e-mail associado a esta conta.
{% endstep %}

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

Depois de processar manualmente os prêmios em seu sistema externo, você precisará atualizar o *saldos de prêmios disponíveis por usuário* relatório. Isso permitirá que a Advocate saiba quais participantes tiveram seus prêmios processados.

1. Usando um aplicativo de planilhas, abra o *saldos de prêmios disponíveis por usuário* relatório.
2. Para cada participante para o qual você processou manualmente um prêmio, atualize a `valueToRedeem` coluna. Apenas números positivos são aceitos.
3. Salve o relatório no formato .CSV.

**Observações sobre o resgate**

* Os saldos de prêmios precisam ser resgatados nas mesmas unidades (*ex.*. `CENTAVOS` ou `DINHEIRO/USD`) em que o saldo é exibido (*ou seja,* Não é possível resgatar dólares em valores de centavos).
* Somente alterações no `valueToRedeem` campo serão processadas durante uma importação.
* Prêmios individuais dentro de um saldo de prêmios serão resgatados na ordem em que expiram (`dateExpires`), e depois quando foram disponibilizados ao participante (`dateGiven`).
* Somente prêmios com status `AVAILABLE` serão resgatados.
* As frações da unidade fracionária serão truncadas no resgate (*ex.* o resgate de "10,556 USD" resgatará apenas "10,55 USD").
  {% endstep %}

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

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

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage] → Relatórios → Importações e exportações**.
2. Selecione ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) **Importar**.
3. Em *Tipo de importação*, selecione **Atualizar saldos de prêmios do usuário**.
4. Para adicionar seu relatório atualizado, selecione **Escolher arquivo**.
5. Selecione **Importar**.

Quando a importação for concluída, um e-mail de confirmação será enviado. 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
