> 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md).

# Enviar modificaciones y reversiones por lotes

Cuando un socio genera una conversión —como una venta— y aún no ha transcurrido el período de bloqueo de esa acción, puedes corregir cualquier dato incorrecto de la acción enviando una modificación o una reversión. Así te aseguras de que se pague correctamente al socio cuando finalice el período de bloqueo.

Por lo general, las acciones se modifican o revierten cuando los clientes devuelven pedidos, cometen errores durante el proceso de pago o cuando los artículos están agotados.

Puedes enviar modificaciones y reversiones en lote a través de la API o mediante FTP/correo electrónico, como se explica en este artículo. La plantilla que necesitas para los envíos por FTP/correo electrónico depende de si haces el seguimiento a nivel de pedido o de artículo, ya que cada opción requiere campos distintos. Si no sabes qué archivo usar, consulta con tu CSM o [ponte en contacto con soporte](https://app.impact.com/support/portal.ihtml).

### ¿Qué método de envío es el adecuado para ti?

| Si quieres...                                      | Usa este método...                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enviar manualmente un archivo único, sin programar | ​[Correo electrónico](#step-2-submit-your-data-file) procesamiento por lotes o [carga de archivos mediante FTP](#step-2-submit-your-data-file)​                                                                                                                                                                                        |
| Configurar informes automatizados de conversiones  | ​[Conversiones](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Acciones](https://integrations.impact.com/brand-api-reference/reference/actions) API, [envío de archivos mediante FTP](#step-2-submit-your-data-file), o [descarga de archivos mediante FTP​](#step-2-submit-your-data-file) |

### Aspectos que debes tener en cuenta:

* **Usa formatos de archivo admitidos** — El archivo que envíes debe estar en formato .CSV o .XML.
* **No agregues nuevos puntos de datos** — No puedes agregar campos nuevos a una transacción; solo puedes actualizar los existentes.
* **Ten en cuenta cómo se gestionan los duplicados** — Cuando varias acciones comparten el mismo *Oid/OrderId*, impact.com aplica las actualizaciones a la acción más reciente *ActionId*. Para reemplazarla, especifica el *ActionId*.
* **Usa&#x20;*****Amount*****&#x20;correctamente para las reversiones** — Para revertir una acción, puedes establecer *Amount = 0*. Sin embargo, si el valor original de *Amount = 0*, dejarlo en 0 se registrará como una modificación y la acción no se revertirá.

{% stepper %}
{% step %}

#### Paso 1: Prepara el archivo de datos

1. Identifica el archivo de plantilla que corresponda a tu caso de uso.
   * Consulta [Referencia de modificaciones y reversiones en lote](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) para encontrar archivos de plantilla con datos de ejemplo.
2. Pega el contenido de la plantilla en una aplicación de hojas de cálculo (por ejemplo, Microsoft Excel) o en un editor de texto (por ejemplo, Notepad).
3. Empieza a agregar los datos modificados de la acción debajo de la fila de encabezados.

   * Si usas un editor de texto, separa cada punto de datos con comas.
   * Si usas un editor de hojas de cálculo, agrega cada punto de datos en una celda distinta.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Asegúrate de editar las celdas de la hoja de cálculo en formato «Texto sin formato» o «Texto» para evitar que se omitan valores por accidente.</p></div>
4. Guarda el archivo con un nombre que permita identificarlo, por ejemplo: `Batch_Mods/Reversals_2025_02_12.csv`
   * Para ver una lista de los campos que se usan habitualmente en el procesamiento por lotes mediante FTP/correo electrónico, consulta [Referencia de modificaciones y reversiones en lote](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md). También puedes consultar nuestra [Referencias de campos de acciones y conversiones](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) para consultar la lista completa de campos admitidos.
     {% endstep %}

{% step %}

#### Paso 2: Envía tu archivo de datos

impact.com permite un máximo de 1.000 modificaciones por acción. Si después necesita realizar más modificaciones, [póngase en contacto con soporte](https://app.impact.com/support/portal.ihtml).

1. En la barra de navegación superior, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil de usuario] → Configuración**.
2. En la columna de la derecha, en *Seguimiento*, selecciona [**Tipos de eventos**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Seleccione el **nombre** del tipo de evento para el que desea enviar modificaciones por lotes.
4. Junto a *Procesamiento de devoluciones*, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Editar]**.
5. Selecciona **Automatizar el procesamiento de devoluciones (avanzado)**, luego selecciona **Carga por lotes**.
6. Elija uno de los siguientes métodos relacionados con FTP o correo electrónico para enviar el archivo:

<details>

<summary>Cargar el archivo en el servidor FTP del sistema</summary>

{% hint style="info" %}
Recomendamos dividir los archivos FTP/SFTP para que cada archivo tenga menos de 10.000 entradas.
{% endhint %}

1. Seleccione **Cargar el archivo en el servidor FTP del sistema.**
2. Seleccione **Enviar por correo electrónico el nombre de usuario y la contraseña de FTP** y **Guardar**.
3. Cuando haya recibido sus credenciales FTP por correo electrónico, use un cliente FTP para conectarse a impact.com con la siguiente información:

   |                       | FTP                                                                                    | SFTP                                                                                    |
   | --------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
   | **Servidor**          | batch.impact.com                                                                       | sftp\://batch.impact.com                                                                |
   | **Puerto**            | 21                                                                                     | 22                                                                                      |
   | **Nombre de usuario** | (Su nombre de usuario FTP de impact.com, que distingue entre mayúsculas y minúsculas). | (Su nombre de usuario SFTP de impact.com, que distingue entre mayúsculas y minúsculas). |
   | **Contraseña**        | (Su contraseña FTP de impact.com, que distingue entre mayúsculas y minúsculas).        | (Su contraseña SFTP de impact.com, que distingue entre mayúsculas y minúsculas).        |
4. Una vez conectado, carga el archivo en el directorio principal del servidor.
   * Si no ha recibido el correo electrónico con las credenciales FTP, póngase en contacto con la persona que creó su cuenta de impact.com. También puede [ponerse en contacto con soporte](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Obtener el archivo de su propio servidor FTP</summary>

{% hint style="info" %}
Recomendamos dividir los archivos FTP/SFTP para que cada archivo tenga menos de 10.000 entradas.
{% endhint %}

1. Seleccione **Obtener el archivo de su propio servidor FTP**.
2. Introduzca la **URL del servidor**, **Puerto**, y la **Ruta del directorio** del archivo de modificaciones por lotes en su servidor FTP. Introduzca el **Nombre de usuario** y la **Contraseña** que impact.com usará para conectarse a su servidor FTP.
3. Seleccione **Guardar** y continuar.
4. Cargue el archivo en el *directorio* que especificó arriba.
   * impact.com intenta conectarse y descargar archivos de tu servidor FTP cada 24 horas, por lo que el procesamiento de tu archivo puede tardar hasta 24 horas después de subirlo.

</details>

<details>

<summary>Enviar el archivo por correo electrónico al servidor SMTP del sistema</summary>

1. Seleccionar **Enviar el archivo por correo electrónico al servidor SMTP del sistema.**
2. Justo debajo del método que hayas seleccionado, se te proporcionará una dirección de correo electrónico única. Copia esta dirección.
3. Con cualquier cliente de correo electrónico, envía un correo a la dirección única y adjunta el archivo con las modificaciones por lotes.
   * Incluye únicamente la dirección de correo electrónico única correspondiente al tipo de evento en el campo *Para:* Si necesitas enviar este archivo a otras personas, inclúyelas en el campo *CC:* .
4. Puedes dejar en blanco el asunto y el cuerpo del mensaje.
   * A continuación, puedes ver un ejemplo de la dirección de correo electrónico (la tuya será ligeramente diferente):

<div data-with-frame="true"><figure><img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### Paso 3: Revisa el envío de tu archivo

Una vez que hayas enviado tu archivo .CSV o .XML a impact.com, puedes consultar su estado para ver si se procesó.

1. En la barra de navegación superior, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Perfil de usuario] → Configuración**.
2. En la columna izquierda, desplázate hasta la sección *Técnico* y selecciona [**Envíos de archivos**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. Usa la tabla para revisar los envíos de archivos recientes que recibió impact.com, incluido el estado actual del procesamiento.
   * Los archivos enviados aparecerán en un plazo de 10 a 15 minutos, mientras que las actualizaciones generales de los informes pueden tardar más de 2 horas.
   * A continuación se indican varios problemas que puedes encontrar al revisar los envíos de archivos y las medidas que puedes tomar para resolverlos.

<details>

<summary>Referencia para solucionar problemas de envíos</summary>

| Problema                                           | Medida que debes tomar                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La columna Registros muestra 0                     | Asegúrate de que la extensión del archivo sea .CSV o .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `NO_CHANGE`                                        | No se han realizado cambios en la acción. Asegúrate de ingresar el importe final en la columna *Importe* (por ejemplo, ingresa 0 si quieres revertir acciones).                                                                                                                                                                                                                                                                                                                                                                                            |
| `BAD_DISPOSITION`                                  | <p>El código de motivo que proporcionaste no es válido. Usa uno de los <a href="https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">códigos de motivo</a>.</p><p>estándar. También puedes configurar un <a href="https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">código de disposición personalizado</a>.</p> |
| `ALREADY_LOCKED`                                   | El período de bloqueo de la acción ya venció. Ya no se pueden modificar ni revertir las acciones.                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `ActionTrackerld:ActionTrackerld value is invalid` | Esto debe corresponder al [ID del tipo de evento](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) ingresado.                                                                                                                                                                                                                                                                                                                                                         |
| `ACTION_NOT_FOUND`                                 | El `OID` que proporcionaste es incorrecto. Proporciona un `OID`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `ALREADY_REVERSED`                                 | La acción ya se revirtió.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `ALREADY_APPROVED`                                 | La acción ya se aprobó.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

</details>
{% 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/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.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.
