> 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-modifications-and-reversals-reference.md).

# Referencia de modificaciones y reversiones en lote

Cuando modifiques o reviertas datos de acciones en masa, comienza descargando uno de los archivos de plantilla proporcionados por impact.com y reemplazando los datos de ejemplo con los tuyos. Cuando agregues tus propios datos, asegúrate de seguir las pautas de la tabla de referencia correspondiente para garantizar que el envío de tu archivo tenga el formato correcto. Una vez que tu archivo de envío esté listo, puedes continuar con [enviar tus modificaciones/reversiones por lotes](/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#submit-your-data-file-0-1) archivo.

{% hint style="info" %}
Este artículo de referencia incluye los campos más utilizados para modificaciones y reversiones por lotes. Para ver una referencia completa y detallada, incluida la descripción de los campos, consulta [Referencias de campos de acción y conversión](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references).
{% endhint %}

**Consulta las referencias a continuación para:**

* Aprender qué campos usar en una modificación o reversión por lotes por FTP/SMTP
* Descargar archivos de plantilla con datos de ejemplo de marcador de posición
* Entender qué códigos de motivo aplicar y cuándo

#### Modificaciones a nivel de pedido

Esto es para cuando quieras actualizar datos de acciones en masa a nivel de pedido en lugar de a nivel de artículo, por ejemplo, cambiar el importe del pedido de varios pedidos.

<details>

<summary>Parámetros aceptados</summary>

| Campo             | ¿Requerido?                  | ¿Editable?  | Nota                                                                                                                                   |
| ----------------- | ---------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Requerido condicionalmente\* | No editable | Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.                                             |
| `Oid / OrderId`   | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *ActionTrackerId*.                                                        |
| `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*.                                                            |
| `Importe`         | Opcional                     | Editable    | Establece el nuevo importe total del pedido.                                                                                           |
| `currencyCode`    | Opcional                     | Editable    | Establece la moneda de ingresos de la acción. De forma predeterminada, será la moneda de tu cuenta de impact.com si no se proporciona. |
| `CustomerStatus`  | Opcional                     | Editable    | Establece el estado del cliente en el momento de la conversión, por ejemplo, NUEVO / EXISTENTE.                                        |
| `Motivo`          | Obligatorio                  | Editable    | Proporciona un código de motivo válido para la modificación.                                                                           |

\*Debe proporcionarse al menos una ruta de identificador, es decir, o bien *ActionId* **o** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>Archivos de plantilla</summary>

* [Plantilla de modificaciones a nivel de pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [Plantilla de aprobaciones a nivel de pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### Reversiones a nivel de pedido

Esto es para cuando quieras revertir en masa acciones impulsadas por socios a nivel de pedido en lugar de a nivel de artículo, por ejemplo, revertir varios pedidos.

<details>

<summary>Parámetros aceptados</summary>

| Campo             | ¿Requerido?                    | ¿Editable?  | Nota                                                                                       |
| ----------------- | ------------------------------ | ----------- | ------------------------------------------------------------------------------------------ |
| `ActionID`        | Requerido condicionalmente\*   | No editable | Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta. |
| `Oid / OrderId`   | Requerido condicionalmente\*   | No editable | Proporcionar este identificador es obligatorio cuando se usa *ActionTrackerId*.            |
| `ActionTrackerID` | Requerido condicionalmente\*   | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*.                |
| `Importe`         | Requerido condicionalmente\*\* | Editable    | Establecer en **0** para revertir el pedido, a menos que el importe original = 0\*\*       |
| `Motivo`          | Obligatorio                    | Editable    | Proporciona un código de motivo válido para la reversión.                                  |

\*Debe proporcionarse al menos una ruta de identificador, es decir, o bien *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Si el importe original *Importe = 0*, deja *Importe* sin cambios para evitar clasificarlo erróneamente como una modificación.

</details>

<details>

<summary>Archivos de plantilla</summary>

* [Plantilla de reversiones a nivel de pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### Modificaciones a nivel de artículo

Esto es para cuando quieras actualizar datos de acciones en masa a nivel de artículo en lugar de a nivel de pedido, por ejemplo, cambiar el importe de varios artículos de un pedido.

<details>

<summary>Parámetros aceptados</summary>

| Campo             | ¿Requerido?                  | ¿Editable?  | Nota                                                                                                                                     |
| ----------------- | ---------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Requerido condicionalmente\* | No editable | Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.                                               |
| `Oid / OrderId`   | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *ActionTrackerId*.                                                          |
| `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*.                                                              |
| `SKU`\*\*         | Obligatorio                  | No editable | Proporciona el valor de SKU del artículo que deseas modificar.                                                                           |
| `Importe`\*\*     | Requerido condicionalmente   | Editable    | Establece el nuevo importe del artículo, es decir, precio\*cantidad. Si modificas la cantidad, este campo también requiere modificación. |
| `Cantidad`\*\*    | Opcional                     | Editable    | Establece la nueva cantidad de artículos del pedido.                                                                                     |
| `Categoría`\*\*   | Opcional                     | Editable    | Establece la categoría del artículo.                                                                                                     |
| `Motivo`\*\*      | Obligatorio                  | Editable    | Proporciona un código de motivo válido para la reversión.                                                                                |

\*Debe proporcionarse al menos una ruta de identificador, es decir, o bien *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Estos campos deben incluirse para cada artículo que modifiques. Los campos identificadores solo se incluyen una vez por pedido.

</details>

<details>

<summary>Archivos de plantilla</summary>

* [Plantilla de modificaciones a nivel de artículo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [Plantilla de aprobaciones a nivel de artículo](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### Reversiones a nivel de artículo

Esto es para cuando quieras revertir en masa datos de acciones a nivel de artículo en lugar de a nivel de pedido, por ejemplo, revertir varios artículos de un pedido.

<details>

<summary>Parámetros aceptados</summary>

| Campo             | ¿Requerido?                  | ¿Editable?  | Nota                                                                                                                                     |
| ----------------- | ---------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Requerido condicionalmente\* | No editable | Se recomienda proporcionar este identificador cuando la ventana de deduplicación es corta.                                               |
| `Oid / OrderId`   | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *ActionTrackerId*.                                                          |
| `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*.                                                              |
| `SKU`\*\*         | Obligatorio                  | No editable | Proporciona el valor de SKU del artículo que deseas modificar.                                                                           |
| `Importe`\*\*     | Requerido condicionalmente   | Editable    | Establece el nuevo importe del artículo, es decir, precio\*cantidad. Si modificas la cantidad, este campo también requiere modificación. |
| `Cantidad`\*\*    | Opcional                     | Editable    | Establece la nueva cantidad de artículos del pedido.                                                                                     |
| `Motivo`\*\*      | Obligatorio                  | Editable    | Proporciona un código de motivo válido para la modificación.                                                                             |

\*Debe proporcionarse al menos una ruta de identificador, es decir, o bien *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Estos campos deben incluirse para cada artículo que modifiques. Los campos identificadores solo se incluyen una vez por pedido.

</details>

<details>

<summary>Archivos de plantilla</summary>

* [Plantilla de reversiones a nivel de artículo](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

El SKU O7427540 aparece dos veces en este ejemplo porque una línea está revirtiendo (Importe=0) y otra está modificando (Importe=15).

</details>

{% hint style="info" %}
**Nota:** Si anticipas tener OrderIds duplicados *OrderIds* y optas por usar la combinación de *OrderId + ActionTrackerID*, impact.com aplica tu actualización al más reciente *ActionId* de forma predeterminada. Usa el antiguo *ActionId* si quieres aplicar la actualización al más antiguo *ActionId*.
{% endhint %}

#### Códigos de motivo

Cada vez que modifiques o reviertas datos de acciones, debes proporcionar un motivo. Usa el código de motivo correspondiente a continuación para explicar por qué se está actualizando la acción.

{% hint style="warning" %}
**Advertencia:** Si se proporciona un valor no aceptado, la entrada no se procesará y, en su lugar, devolverá un error. Si necesitas códigos de motivo personalizados, ponte en contacto con tu CSM o [**contacte con soporte**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **para hablar de los códigos de disposición**.
{% endhint %}

<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>


---

# 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-modifications-and-reversals-reference.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.
