> 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 masivas con Advocate

Aunque muchas recompensas se activan automáticamente por reglas del programa (como una conversión de referido), a veces es posible que necesite recompensar a los participantes por acciones manuales o fuera de línea, como completar una encuesta o ganar un concurso.

Los valores de **Recompensas masivas** la herramienta de importación le permite emitir efectivo, puntos o tarjetas de regalo a varios defensores a la vez mediante la carga de un archivo CSV. Esta función incluye un mecanismo de seguridad de ejecución de prueba para asegurar que sus datos sean correctos antes de desembolsar cualquier fondo.

### Prepare su archivo de importación

{% hint style="success" %}
**Nota**: Si utiliza la configuración global de importación, entonces solo necesitaría enviar una `userId` lista.
{% endhint %}

Para comenzar, necesitará un archivo CSV o JSONL que contenga la lista de usuarios a los que desea recompensar.

* **Columnas obligatorias**: Su archivo debe incluir como mínimo `userId` para identificar al usuario.
* **Columnas opcionales**: Puede incluir detalles de la recompensa (p. ej., importe, unidad, tipo) en el archivo. Alternativamente, recomendamos establecerlos como *valores predeterminados globales* en la plataforma durante el proceso de importación para simplificar su archivo.

#### Referencia de 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 a recompensar (p. ej., 50).</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>rewardUnit</code></td><td>La unidad de la recompensa (p. ej., USD, POINTS).</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>globalRewardKey</code></td><td>La clave de una recompensa preconfigurada que se va a otorgar.</td><td><p>Condicional<br>(No requerido si se establece un valor predeterminado global)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>El importe a recompensar como descuento</td><td>Condicional<br>(No requerido si se establece un valor predeterminado global)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Posponga 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 el archivo se vuelve a ejecutar.</td></tr><tr><td><code>customerNote</code></td><td>Añada una nota que será visible para el cliente.</td><td>Opcional</td></tr><tr><td><code>internalNote</code></td><td>Añada una nota para uso interno que el cliente no podrá ver.</td><td>Opcional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Configurar la importación

1. En el menú de navegación de la izquierda, selecciona ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage] → Informes → Importaciones y exportaciones**.
2. En la esquina superior derecha, seleccione **Importar**.
3. En *Tipo de importación*, selecciona **Recompensas**.

<div data-with-frame="true"><figure><img src="/files/61a3385c389647d46bc022eda113a6a94aa6b5c5" alt=""><figcaption></figcaption></figure></div>

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

Para ahorrar tiempo y reducir errores en su archivo CSV, puede definir valores preestablecidos que se apliquen a cada fila de su importación.

* **Recompensa**: Elija una recompensa preconfigurada o especifique una unidad manual (p. ej., "Cash/USD").
* **Programa**: Asocie estas recompensas con un programa específico con fines de informes.
* **Duración de recompensa pendiente**: ![](/files/56e1fcd9ba564ade1200e6210703a468dfffe350) **\[Activar]** para añadir un margen de seguridad (p. ej., 30 días) antes de que la recompensa esté disponible para el usuario. Esto permite tiempo para retractaciones, si fuera necesario.

{% hint style="success" %}
**Nota**: Si establece un valor aquí (p. ej., Unidad de recompensa: USD), **no** necesita incluir esa columna en su archivo CSV.
{% endhint %}
{% endstep %}

{% step %}

#### Cargar y ejecutar prueba

Debido a que las recompensas en efectivo son definitivas y no pueden revertirse, el sistema requiere una ejecución de prueba (importación de prueba) para que pueda revisar los detalles con confianza antes de procesar las recompensas.

1. En la sección *Cargue su archivo CSV o JSONL de usuarios de importación* seleccione **Elegir archivo**.
2. Selecciona **Ejecutar importación de prueba** para iniciar el estado de prueba.
3. El sistema procesará el archivo **sin** crear recompensas.

<div data-with-frame="true"><figure><img src="/files/d8599553f403959943a8e5f4e09b9bb777a8ae56" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Revisar y finalizar

Una vez completada la ejecución de prueba, verá una entrada de estado en la lista de Importaciones y exportaciones. Es posible que se envíen correos electrónicos como parte del proceso de revisión (tarjetas de regalo, configuración de pagos, etc.).

1. **Revisar**: Si hay errores (indicados con ![](/files/362403424cd7d7aa73e9547471dd79c695eea00a) **\[Signo de exclamación]**), seleccione **Descargar informe de errores** para corregir su archivo e intentarlo de nuevo. Además, seleccione **Descargar informe** para obtener un registro de todas las recompensas que se crearán. Haya o no un error, se recomienda revisarlo.
2. **Confirmar**: Si la prueba es exitosa (indicada con una ![](/files/c0e6881bcd07073a36e9b558b14cb4222f9bfbae) **\[Marca de verificación]**), seleccione **Ejecutar importación**.
3. Aparecerá un modal de confirmación que resumirá el impacto total (p. ej., "Al ejecutar esta importación se crearán 412 recompensas"). Seleccione **Ejecutar importación** para confirmar y desembolsar las recompensas.

Si decide no continuar, simplemente puede cancelar la ejecución y luego seleccionar Descartar para eliminar la ejecución de prueba.

<div data-with-frame="true"><figure><img src="/files/0321764174195a3564d21df62211b73d521c5513" 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 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/es/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.