> 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/platform-features/promo-codes/bulk-upload-promo-codes.md).

# Carga masiva de códigos promocionales

Puede crear varios códigos promocionales de seguimiento a la vez desde un archivo CSV, XLS o XLSX. Después de cargar su archivo, impact.com valida cada fila para que pueda revisar y corregir cualquier error antes de crear los códigos promocionales.

Los archivos pueden tener hasta 5 MB para CSV o 1 MB para XLS y XLSX. La validación se basa solo en el tamaño del archivo, por lo que no hay límite en el número de filas.

## Cargue sus códigos promocionales

1. En el menú de navegación izquierdo, seleccione ![](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]** → **Contenido** → [**Códigos promocionales**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. En la *Códigos promocionales* pantalla, seleccione **Carga masiva**.
3. Opcionalmente, seleccione **Descargar** para obtener un archivo de plantilla de ejemplo, o seleccione **Ver detalles del formato** para ver las columnas requeridas.
4. Seleccione **Elegir archivo**, luego busque y seleccione su archivo. También puede arrastrar y soltar el archivo en la página.
5. Seleccione **Continuar**.
6. Revise la tabla de *Vista previa de datos* . La *Validación* columna muestra *Aprobado* para las filas que están listas, o un mensaje de error para las filas que necesitan cambios.
   * Opcionalmente, para ordenar las filas, seleccione un encabezado de columna o seleccione **Orden de clasificación**.
   * Para ver todos los errores de una fila, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FzdZvuTyltsDGVW39C6ZZ%2F%5BPlus%5D.svg?alt=media\&token=a2ba6db3-74b5-4ae1-b849-87501cf3a8ec) **\[Expandir]** junto al código promocional. La *Vista previa de errores* enumera cada columna, su valor y el problema.
   * Para corregir errores, actualice su archivo, seleccione **Cancelar** junto al nombre del archivo y, a continuación, cargue el archivo corregido.
7. Seleccione **Aceptar y crear códigos promocionales**. El mensaje junto al botón muestra el número de códigos promocionales aprobados que impact.com crea. Si no hay filas aprobadas, el botón se deshabilita.

impact.com crea los códigos promocionales aprobados y le devuelve a la *Códigos promocionales* pantalla. Solo se crean las filas aprobadas. Si se produce un error mientras impact.com crea sus códigos promocionales, aparecerá un mensaje de error con un código de error. Póngase en contacto con soporte e incluya este código.

Para cancelar una carga masiva, seleccione ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FYaEYpaDDip5FxDbF8lnO%2Fclose.svg?alt=media\&token=da6580c0-a38f-4bf9-a34a-619921f19e9e) **\[Cerrar]** en la esquina superior derecha de la pantalla y, a continuación, seleccione **Confirmar**.

{% hint style="success" %}
**Nota:** Los códigos promocionales con una fecha de inicio futura tienen un estado *Pendiente* . La *Códigos promocionales* pantalla muestra *Códigos promocionales activos* de forma predeterminada, así que cambie el filtro [*Programación del código* filtro](/brand/es/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md) para encontrarlos.
{% endhint %}

## Formatee su archivo de códigos promocionales

Su archivo debe usar exactamente los nombres de columna que se muestran a continuación, incluida la capitalización y los puntos, o la carga se rechaza.

| Columna                | Tipo       | Requerido | Descripción                                                                                                                                                                                                                                                                                                                                            |
| ---------------------- | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Operación`            | Cadena     | Sí        | La operación de carga masiva. Valor permitido: `CREATE`.                                                                                                                                                                                                                                                                                               |
| `media.id`             | Entero     | Sí        | <p>El ID de media de impact.com al que se asigna el código promocional. Puede ser un ID de cuenta de socio o un ID de fuente de media.</p><p>Cada código promocional de seguimiento solo puede asignarse a 1 socio o fuente de media. Si otro socio promociona ese código, impact.com marca la conversión resultante como no válida y la revierte.</p> |
| `código`               | Cadena     | Sí        | El código promocional único. No puede contener signos de menor que (`<`, `>`) ni comillas dobles.                                                                                                                                                                                                                                                      |
| `creditRule`           | Cadena     | Sí        | <p>La regla de crédito del código promocional. Valores permitidos:</p><p><code>ALWAYS</code> (Siempre crédito)</p><p><code>INVOLVED</code> (Crédito si está involucrado)</p><p><code>WINNER</code> (Crédito si gana)</p>                                                                                                                               |
| `matchMode`            | Cadena     | Sí        | <p>El modo de coincidencia del código promocional. Valores permitidos:</p><p><code>LI</code> (Exacta/Literal)</p><p><code>RE</code> (Regex/Expresión regular)</p>                                                                                                                                                                                      |
| `deal.id`              | Entero     | No        | El ID del [acuerdo](/brand/es/what-would-you-like-to-learn-about/platform-features/deals.md) que se asociará con el código promocional. El acuerdo ya debe existir en su programa.                                                                                                                                                                     |
| `scheduling.startDate` | Fecha      | Sí        | Cuándo el código promocional estará disponible. Introduzca una fecha y hora locales sin desplazamiento de zona horaria, en el formato `YYYY-MM-DDTHH:mm:ss` (por ejemplo, `2026-10-01T00:00:00`).                                                                                                                                                      |
| `scheduling.endDate`   | Fecha      | Sí        | Cuándo expira el código promocional. Use el mismo formato que `scheduling.startDate` (por ejemplo, `2026-12-31T23:59:59`).                                                                                                                                                                                                                             |
| `scheduling.timezone`  | Cadena     | Sí        | La zona horaria IANA (Internet Assigned Numbers Authority) para las fechas programadas (por ejemplo, `America/New_York`).                                                                                                                                                                                                                              |
| `emailAddresses`       | cadena CSV | No        | Una lista de direcciones de correo electrónico separadas por comas para notificar sobre este código promocional.                                                                                                                                                                                                                                       |
| `comments`             | Cadena     | No        | Comentarios de texto libre para esta fila.                                                                                                                                                                                                                                                                                                             |

Ejemplo: Esta fila crea el código promocional `10PEROFF` para 1 socio, disponible del 1 de octubre al 31 de diciembre de 2026, hora de Nueva York.

```csv
Operation,media.id,code,creditRule,matchMode,deal.id,scheduling.startDate,scheduling.endDate,scheduling.timezone,emailAddresses,comments
CREATE,1299679,10PEROFF,ALWAYS,LI,,2026-10-01T00:00:00,2026-12-31T23:59:59,America/New_York,carrie.oakey@acmecorporation.io,Holiday promo
```

<details>

<summary>Referencia del error de validación</summary>

| Mensaje de validación                                                                    | Cómo corregirlo                                                                                                  |
| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| *Valor no reconocido*                                                                    | El valor no es uno de los valores permitidos, o una fecha usa el formato incorrecto. Consulte la tabla anterior. |
| *El valor no puede contener signos de menor que (<, >) ni comillas dobles.*              | Elimine estos caracteres del código promocional.                                                                 |
| *El código promocional ya existe para este programa.*                                    | Use un código promocional que aún no esté en su programa.                                                        |
| *El socio de medios \[ID] no está vinculado a la campaña \[ID]*                          | Use el ID de media de un socio o fuente de media que esté vinculado a su programa.                               |
| *Acuerdo no encontrado*                                                                  | Use el ID de un acuerdo existente, o deje `deal.id` en blanco.                                                   |
| *Solo CREATE es compatible con los procedimientos programados de códigos promocionales.* | Establecer `Operación` a `CREATE`.                                                                               |

</details>


---

# 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/platform-features/promo-codes/bulk-upload-promo-codes.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.
