> 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 reversos en lote

Cuando modifique o revierta datos de acciones de forma masiva, comience descargando uno de los archivos de plantilla proporcionados por impact.com y reemplazando los datos de ejemplo por los suyos. Al agregar sus propios datos, asegúrese de seguir las pautas de la tabla de referencia correspondiente para garantizar que el envío de su archivo esté formateado correctamente. Una vez que su archivo de envío esté listo, puede continuar con [el envío de sus modificaciones / reversiones masivas](/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 masivas. Para ver una referencia completa y detallada, incluidas las descripciones de los campos, consulte [Referencias de campos de acción y conversión](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references).
{% endhint %}

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

* Aprender qué campos usar en una modificación o reversión masiva 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 desea actualizar datos de acciones de forma masiva a nivel de pedido en lugar de a nivel de artículo; por ejemplo, cambiar el importe del pedido para varios pedidos.

<details>

<summary>Parámetros aceptados</summary>

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

\*Debe proporcionarse al menos una ruta de identificador, es decir, ya sea *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 desea revertir acciones impulsadas por el socio de forma masiva a nivel de pedido en lugar de a nivel de artículo; por ejemplo, revertir varios pedidos.

<details>

<summary>Parámetros aceptados</summary>

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

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

\*\*Si el original *Amount = 0*, deje *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 desea actualizar datos de acciones de forma masiva 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             | ¿Obligatorio?                  | ¿Editable?  | Nota                                                                                                                                     |
| ----------------- | ------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obligatorio condicionalmente\* | No editable | Se recomienda proporcionar este identificador cuando la ventana de desduplicación es corta.                                              |
| `Oid / OrderId`   | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se utiliza *ActionTrackerId*.                                                      |
| `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se utiliza *OrderId/Oid*.                                                          |
| `SKU`\*\*         | Obligatorio                    | No editable | Proporcione el valor SKU del artículo que desea modificar.                                                                               |
| `Importe`\*\*     | Obligatorio condicionalmente   | Editable    | Establezca el nuevo importe del artículo, es decir, precio\*cantidad. Si modifica la cantidad, este campo también requiere modificación. |
| `Cantidad`\*\*    | Opcional                       | Editable    | Establezca la nueva cantidad de artículos del pedido.                                                                                    |
| `Categoría`\*\*   | Opcional                       | Editable    | Establezca la categoría del artículo.                                                                                                    |
| `Motivo`\*\*      | Obligatorio                    | Editable    | Proporcione un código de motivo válido para la reversión.                                                                                |

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

\*\*Estos campos deben incluirse para cada artículo que modifique. 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 desea revertir datos de acciones de forma masiva 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             | ¿Obligatorio?                  | ¿Editable?  | Nota                                                                                                                                     |
| ----------------- | ------------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obligatorio condicionalmente\* | No editable | Se recomienda proporcionar este identificador cuando la ventana de desduplicación es corta.                                              |
| `Oid / OrderId`   | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se utiliza *ActionTrackerId*.                                                      |
| `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se utiliza *OrderId/Oid*.                                                          |
| `SKU`\*\*         | Obligatorio                    | No editable | Proporcione el valor SKU del artículo que desea modificar.                                                                               |
| `Importe`\*\*     | Obligatorio condicionalmente   | Editable    | Establezca el nuevo importe del artículo, es decir, precio\*cantidad. Si modifica la cantidad, este campo también requiere modificación. |
| `Cantidad`\*\*    | Opcional                       | Editable    | Establezca la nueva cantidad de artículos del pedido.                                                                                    |
| `Motivo`\*\*      | Obligatorio                    | Editable    | Proporcione un código de motivo válido para la modificación.                                                                             |

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

\*\*Estos campos deben incluirse para cada artículo que modifique. 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 (Amount=0) y otra está modificando (Amount=15).

</details>

{% hint style="info" %}
**Nota:** Si prevé tener duplicados *OrderIds* y opta por usar la combinación de *OrderId + ActionTrackerId*, impact.com aplicará su actualización al más reciente *ActionId* de forma predeterminada. Use el antiguo *ActionId* si desea aplicar la actualización al más antiguo *ActionId*.
{% endhint %}

#### Códigos de motivo

Cada vez que modifique o revierta datos de acciones, debe proporcionar un motivo. Use 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 necesita códigos de motivo personalizados, póngase en contacto con su CSM o [**contacte con soporte**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **para analizar 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>FRAUDE_DEL_CONSUMIDOR</code></td><td>Fraude del consumidor</td></tr><tr><td><code>ERROR_DEL_CONSUMIDOR</code></td><td>Error del consumidor</td></tr><tr><td><code>ARTICULO_DEVUELTO</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">codigo_de_disposicion_personalizado</a>.</p></div></td></tr><tr><td><code>ERROR_DEL_PEDIDO</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>DISPUTA_DE_ACTIVIDAD_DEL_SOCIO</code></td><td>Disputa de actividad del socio</td></tr><tr><td><code>DISPUTA_DE_ACTIVIDAD_DE_MARCA</code></td><td>Disputa de actividad de marca</td></tr><tr><td><code>INCUMPLIMIENTO_DE_TERMINOS</code></td><td>No cumple con los términos</td></tr><tr><td><code>ARTICULO_SIN_EXISTENCIAS</code></td><td>El artículo está sin existencias</td></tr><tr><td><code>ACCION_DE_PRUEBA</code></td><td>Acción de prueba</td></tr><tr><td><code>SOCIO_INACTIVO</code></td><td>Cuenta del socio desactivada</td></tr><tr><td><code>ACREDITADO_A_OTRO_SOCIO</code></td><td>Acreditado a otro socio</td></tr><tr><td><code>OTRO</code></td><td>Otro motivo</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.
