> 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 por lotes Cuando modifiques o reviertas datos de acciones en bloque, comienza descargando uno de los archivos de plantilla proporcionados por impact.com y reemplazando los datos de ejemplo por los tuyos. Al agregar tus propios datos, asegúrate de seguir las directrices 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 el envío de tu archivo de modificaciones / reversiones por lotes. {% 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 que incluya descripciones de los campos, consulta [Referencias de campos de acciones y conversiones](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 quieres actualizar datos de acciones en bloque a nivel de pedido en lugar de a nivel de artículo, por ejemplo, cambiar el importe del pedido para varios pedidos.
Parámetros aceptados | 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 al usar *ActionTrackerId*. | | `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio al usar *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, se usará 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. | | `Nota` | Opcional | Editable | Campo general para fines de informes a nivel de evento. Si está vacío en la conversión original, al enviar un valor se inserta. Solo se acepta una vez por acción; envía cualquier otro cambio de campo en la misma solicitud. | | `LocationId` | Opcional | Editable | Se utiliza principalmente para alojamientos; este es el identificador único de la ubicación especificada en esta conversión. Si está vacío en la conversión original, al enviar un valor se inserta. | | `LocationName` | Opcional | Editable | Se utiliza principalmente para alojamientos; este es el nombre de la ubicación especificada en esta conversión. Si está vacío en la conversión original, al enviar un valor se inserta. | | `GiftPurchase` | Opcional | Editable | Establécelo en true para marcar el pedido como compra de regalo, o en false para desmarcarlo. Si está vacío en la conversión original, al enviar un valor se inserta. | | `Text1–Text50` | Opcional | Editable | Campos de texto generales que aceptan cadenas con cualquier dato de texto que desees enviar (Text1 a Text50). Si está vacío en la conversión original, al enviar un valor se inserta. Solo se acepta una vez por acción; envía cualquier otro cambio de campo en la misma solicitud. | | `Motivo` | Requerido | Editable | Proporciona 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*)
Archivos de plantilla * [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)
#### Reversiones a nivel de pedido Esto es para cuando quieres revertir en bloque acciones impulsadas por partners a nivel de pedido en lugar de a nivel de artículo; por ejemplo, revertir varios pedidos.
Parámetros aceptados | 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 al usar *ActionTrackerId*. | | `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio al usar *OrderId/Oid*. | | `Importe` | Requerido condicionalmente\*\* | Editable | Establécelo en **0** para revertir el pedido, a menos que el importe original = 0\*\* | | `Motivo` | Requerido | Editable | Proporciona 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 *Importe = 0*, deja *Importe* sin cambios para evitar clasificarlo erróneamente como una modificación.
Archivos de plantilla * [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)
#### Modificaciones a nivel de artículo Esto es para cuando quieres actualizar datos de acciones en bloque a nivel de artículo en lugar de a nivel de pedido, por ejemplo, cambiar el importe de varios artículos de un pedido.
Parámetros aceptados | 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 al usar *ActionTrackerId*. | | `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio al usar *OrderId/Oid*. | | `SKU`\*\* | Requerido | No editable | Proporciona el valor 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 debe modificarse. | | `Cantidad`\*\* | Opcional | Editable | Establece la nueva cantidad de artículos del pedido. | | `Categoría`\*\* | Opcional | Editable | Establece la categoría del artículo. | | `Motivo`\*\* | Requerido | Editable | Proporciona 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 modifiques. Los campos identificadores solo se incluyen una vez por pedido.
Archivos de plantilla * [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)
#### Reversiones a nivel de artículo Esto es para cuando quieres revertir datos de acciones en bloque a nivel de artículo en lugar de a nivel de pedido; por ejemplo, revertir varios artículos de un pedido.
Parámetros aceptados | 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 al usar *ActionTrackerId*. | | `ActionTrackerID` | Requerido condicionalmente\* | No editable | Proporcionar este identificador es obligatorio al usar *OrderId/Oid*. | | `SKU`\*\* | Requerido | No editable | Proporciona el valor 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 debe modificarse. | | `Cantidad`\*\* | Opcional | Editable | Establece la nueva cantidad de artículos del pedido. | | `Motivo`\*\* | Requerido | Editable | Proporciona 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 modifiques. Los campos identificadores solo se incluyen una vez por pedido.
Archivos de plantilla * [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).
{% hint style="info" %} **Nota:** Si prevés tener 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:** Proporcionar un valor no aceptado hará que la entrada no se procese y, en su lugar, se devuelva un error. Si necesitas códigos de motivo personalizados, ponte en contacto con tu CSM o [**contacta con soporte**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **para hablar sobre los códigos de disposición**. {% endhint %}
CódigoDescripción
CONS_FRAUDFraude del consumidor
CONS_ERRORError del consumidor
ITEM_RETURNEDEl artículo fue devuelto
APPROVED

La acción está aprobada

Nota: Si intentas aprobar acciones, Aprobar debe configurarse como un código de disposición personalizado.

ORDER_ERRORError del pedido
ORDER_UPDATEEl pedido fue actualizado
PUB_ACT_DISPUTEDisputa de actividad del socio
ADV_ACT_DISPUTEDisputa de actividad de la marca
NOT_COMPLIANCE_TERMSNo cumple con los términos
ITEM_OUT_OF_STOCKEl artículo está agotado
TEST_ACTIONAcción de prueba
PARTNER_NOT_ACTIVECuenta de socio desactivada
CREDITED_DIFFERENT_MPAcreditado a otro socio
OTROOtro motivo
--- # 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=&goal= ``` `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.