> 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/batch-process-reversals-via-api-web-services-overview.md).

# Modificar o revertir por lotes mediante API

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">Realiza el curso PXA</a>

Si algo acerca de una acción cambia (p. ej., un pedido fue cancelado, un artículo fue devuelto, etc.), puedes usar la API para modificarla (o revertirla), cambiando el monto de la comisión de la acción.

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

| Si quieres...                                   | Usa este método...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Envía un archivo manual único, sin programación | ​[Correo electrónico](/brand/es/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md#before-you-start) procesamiento por lotes o [subir archivo mediante FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server)                                                                                                                                                                                                                              |
| Configura informes automáticos de conversiones  | ​[Conversiones](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [Acciones](https://integrations.impact.com/brand-api-reference/reference/actions) API, [enviar archivo mediante FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#upload-file-to-system-ftp-server), o [extraer archivo mediante FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals#pull-file-from-your-own-ftp-server) |

### Opciones de reversión de la API:

* [Modifica o revierte uno o más elementos de una acción mediante la API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)
* [Revierte una acción completa mediante la API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)

### Requisito previo: Recupera el *ActionId* valor

Para modificar los datos de una acción mediante la API, necesitarás su `ActionId` valor. Luego puedes usar esto para encontrar la acción que deseas modificar mediante la API.

* Puedes especificar un rango de fechas en tu llamada; de lo contrario, el endpoint mostrará de forma predeterminada los últimos 30 días de acciones.
* [Límites de tasa](https://integrations.impact.com/brand-api-reference/readme/rate-limits) se aplican.
* Ver la [Lista todas las acciones](https://integrations.impact.com/brand-api-reference/reference/actions/actions) documentación del endpoint de la API para obtener más información.

### Preguntas frecuentes

<details>

<summary>¿Cómo restablezco una modificación / reversión realizada a una acción (o a elementos de la acción)?</summary>

Si una acción se ha modificado o revertido antes de su fecha de bloqueo, puedes enviar `RESET` como motivo para devolver la acción a su estado predeterminado:

```programlisting
curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Reason=RESET'
```

Las acciones que se han restablecido a través del `RESET` código pueden no aparecer correctamente en los informes (p. ej., los valores de ingresos pueden calcularse incorrectamente).

</details>

<details>

<summary>¿Cuál es la diferencia entre un código de disposición y un motivo?</summary>

Ambos *Códigos de disposición* y *Motivos* se utilizan en el mismo contexto — *Motivos* son códigos predefinidos que la API aceptará de forma predeterminada, mientras que *Códigos de disposición* son motivos personalizados que puedes configurar. [Obtén más información sobre los Códigos de disposición](/brand/es/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md).

Códigos de motivo compatibles:

<table><thead><tr><th width="234">Código</th><th>Descripción</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Fraude del consumidor</td></tr><tr><td><code>CONS_ERROR</code></td><td>Error del consumidor</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>El artículo fue devuelto</td></tr><tr><td><code>APROBADO</code></td><td><p>La acción está aprobada</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Nota:</strong> Si estás intentando aprobar acciones, <code>Aprobar</code> debe configurarse como un <a href="/pages/61d2253dcaae4720a805ca3f841b1a9ff58c8b46">código de disposición personalizado</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Error del pedido</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>El pedido fue actualizado</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Disputa de actividad del socio</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Disputa de actividad de la marca</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>No cumple con los términos</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>El artículo está agotado</td></tr><tr><td><code>TEST_ACTION</code></td><td>Acción de prueba</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Cuenta de socio desactivada</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Acreditado a otro socio</td></tr><tr><td><code>OTRO</code></td><td>Otra razón</td></tr></tbody></table>

</details>

<details>

<summary>¿Cómo puedo ver cuándo se aplican modificaciones / reversiones a una acción?</summary>

Puede usar los [actualizaciones de la acción](https://integrations.impact.com/brand-api-reference/reference/actions/models) endpoint para ver cuándo se actualizó por última vez una acción y cuál es su estado actual.

{% hint style="info" %}
**Nota:** Un `ActionUpdatesID` valor es diferente de un `ActionId` valor — debes usar el `ActionUpdatesID` valor para recuperar actualizaciones de una acción.
{% endhint %}

</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 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/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-process-reversals-via-api-web-services-overview.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.