> 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/create-bulk-cash-rewards-with-advocate.md).

# Crear recompensas en efectivo en bloque con Advocate

Aunque muchas recompensas se activan automáticamente mediante reglas del programa (como una conversión por recomendación), a veces es posible que necesites recompensar a los participantes por acciones manuales o realizadas sin conexión, como completar una encuesta o ganar un concurso.

La herramienta **Importación masiva de recompensas** te permite otorgar dinero, puntos o tarjetas de regalo a varios promotores a la vez mediante la carga de un archivo CSV. Esta función incluye un mecanismo de seguridad de simulación para comprobar que los datos sean correctos antes de desembolsar fondos.

### Prepara el archivo de importación

{% hint style="success" %}
**Nota**: Si utilizas la configuración global de importación, solo tendrás que enviar una lista de `userId` .
{% endhint %}

Para empezar, necesitarás un archivo CSV o JSONL que contenga la lista de usuarios a los que quieres recompensar.

* **Columnas obligatorias**: El archivo debe incluir, como mínimo, `userId` para identificar al usuario.
* **Columnas opcionales**: Puedes incluir los detalles de la recompensa (por ejemplo, el importe, la unidad y el tipo) en el archivo. Como alternativa, te recomendamos establecerlos como *valores predeterminados globales* en la plataforma durante el proceso de importación para simplificar el archivo.

#### Referencia de las columnas del archivo

<table data-header-hidden><thead><tr><th width="297.484375">Columna</th><th>Descripción</th><th>Requisito</th></tr></thead><tbody><tr><td><code>userId</code></td><td>El ID único del usuario.</td><td><mark style="color:$danger;">Obligatorio</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>El importe de la recompensa (por ejemplo, 50).</td><td>Condicional<br>(No es obligatorio si se establece un valor predeterminado global)</td></tr><tr><td><code>rewardUnit</code></td><td>La unidad de la recompensa (por ejemplo, USD, POINTS).</td><td>Condicional<br>(No es obligatorio si se establece un valor predeterminado global)</td></tr><tr><td><code>globalRewardKey</code></td><td>La clave de una recompensa preconfigurada que se otorgará.</td><td><p>Condicional<br>(No es obligatorio si se establece un valor predeterminado global)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>El importe de la recompensa en forma de descuento</td><td>Condicional<br>(No es obligatorio si se establece un valor predeterminado global)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Posponer la recompensa hasta esta fecha.</td><td>Opcional</td></tr><tr><td><code>uniqueId</code></td><td>Un identificador único para la transacción.</td><td><mark style="color:$success;">Recomendado</mark><br>Se usa como clave de seguridad para evitar recompensas duplicadas si se vuelve a ejecutar la importación del archivo.</td></tr><tr><td><code>customerNote</code></td><td>Añade una nota que el cliente podrá ver.</td><td>Opcional</td></tr><tr><td><code>internalNote</code></td><td>Añade una nota de uso interno que el cliente no podrá ver.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configura los ajustes de importación

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] → Informes → Importaciones y exportaciones**.
2. En la esquina superior derecha, selecciona **Importar**.
3. En *Tipo de importación*, selecciona **Recompensas**.

<div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**Establecer valores predefinidos (valores predeterminados globales)**

Para ahorrar tiempo y reducir errores en el archivo CSV, puedes definir valores predefinidos que se aplicarán a todas las filas de la importación.

* **Recompensa**: Elige una recompensa preconfigurada o especifica una unidad manual (por ejemplo, "Efectivo/USD").
* **Programa**: Asocia estas recompensas a un programa específico para fines de generación de informes.
* **Duración del periodo de espera de la recompensa**: ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Activar]** para añadir un margen de seguridad (por ejemplo, 30 días) antes de que la recompensa esté disponible para el usuario. Esto da tiempo para revocarla si es necesario.

{% hint style="success" %}
**Nota**: Si estableces aquí un valor (por ejemplo, Unidad de recompensa: USD), **no** es necesario incluir esa columna en el archivo CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Subir y ejecutar una prueba

Como las recompensas en efectivo son definitivas y no se pueden revertir, el sistema requiere una prueba de importación para que puedas revisar los detalles con confianza antes de procesar las recompensas.

1. En *Sube el archivo CSV o JSONL de usuarios para importar* selecciona **Elegir archivo**.
2. Seleccionar **Ejecutar importación de prueba** para iniciar la prueba.
3. El sistema procesará el archivo **sin** crear recompensas.

<div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar y finalizar

Una vez finalizada la prueba, verás una entrada de estado en la lista de importaciones y exportaciones. Es posible que se envíen correos electrónicos durante el proceso de revisión (tarjetas de regalo, configuración de pagos, etc.).

1. **Revisión**: Si hay errores (indicados con ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **\[Signo de exclamación]**), selecciona **Descargar informe de errores** para corregir el archivo y volver a intentarlo. También selecciona **Descargar informe** para obtener un registro de todas las recompensas que se crearán. Se recomienda revisarlo, haya errores o no.
2. **Confirmación**: Si la prueba se realizó correctamente (indicado con una ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **\[Marca de verificación]**), selecciona **Ejecutar importación**.
3. Aparecerá una ventana de confirmación que resumirá el impacto total (por ejemplo: «Al ejecutar esta importación, se crearán 412 recompensas»). Selecciona **Ejecutar importación** para confirmar y distribuir las recompensas.

Si decides no continuar, puedes cancelar la ejecución y luego seleccionar Descartar para eliminar la prueba.

<div data-with-frame="true"><figure><img src="https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% 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/create-bulk-cash-rewards-with-advocate.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.
