> 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 de PXA</a>

Si algo acerca de una acción cambia (por ejemplo, se canceló un pedido, se devolvió un artículo, etc.), puedes usar la API para modificarla (o revertirla), cambiando el importe 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, de una sola vez, sin código | ​[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 por 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)                                                                                                                                                                                                                         |
| Configurar 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 por 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 por 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 en la API:

* [Modificar o revertir uno o más artículos de una acción mediante la API](https://integrations.impact.com/brand-api-reference/reference/actions/actions)
* [Revertir 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 la acción mediante la API, necesitarás su `ActionId` valor. Luego puedes usarlo para encontrar la acción que quieres modificar mediante la API.

* Puedes especificar un rango de fechas en tu llamada — de lo contrario, el endpoint muestra por defecto las acciones de los últimos 30 días.
* [Límites de tasa](https://integrations.impact.com/brand-api-reference/readme/rate-limits) se aplican.
* Consulte la [Listar 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 en una acción (o en los elementos de la acción)?</summary>

Si una acción ha sido modificada o revertida antes de su fecha de bloqueo, puedes enviar `RESET` como motivo para restaurar 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 mediante el `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 usan 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 admitidos:

<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>APPROVED</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 intentas aprobar acciones, <code>Aprobar</code> debe configurarse como un <a href="/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></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>Otro motivo</td></tr></tbody></table>

</details>

<details>

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

Puedes usar el [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` el valor es diferente de un `ActionId` valor — debes usar el `ActionUpdatesID` valor para recuperar las 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.