> 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 Al modificar o revertir datos de acción 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 archivo enviado tenga el formato correcto. Una vez que tu archivo de envío esté listo, puedes continuar enviando tu archivo de modificaciones / reversiones por lotes. {% hint style="info" %} Este artículo de referencia incluye los campos de uso más común para modificaciones y reversiones por lotes. Para ver una referencia completa y detallada que incluya descripciones 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 * Comprender qué códigos de motivo aplicar y cuándo #### Modificaciones a nivel de pedido Esto es para cuando quieras actualizar datos de acción 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 | ¿Es obligatorio? | ¿Es 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 usa *ActionTrackerId*. | | `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*. | | `Amount` | 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. | | `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 | Usado 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 | Usado 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 una 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 de cualquier dato de texto que quieras 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` | Obligatorio | 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 socios a nivel de pedido en lugar de a nivel de artículo; por ejemplo, revertir varios pedidos.
Parámetros aceptados | Campo | ¿Es obligatorio? | ¿Es 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 usa *ActionTrackerId*. | | `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*. | | `Amount` | Obligatorio condicionalmente\*\* | Editable | Establece **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, ya sea *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Si el original *Amount = 0*, deja *Amount* 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 acción en bloque a nivel de artículo en lugar de a nivel de pedido; por ejemplo, cambiar el importe para varios artículos de un pedido.
Parámetros aceptados | Campo | ¿Es obligatorio? | ¿Es 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 usa *ActionTrackerId*. | | `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*. | | `SKU`\*\* | Obligatorio | No editable | Proporciona el valor SKU del artículo que quieres modificar. | | `Amount`\*\* | Obligatorio 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, ya sea *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Estos campos deben incluirse para cada artículo que modifiques. Los campos de identificador 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 acción 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 | ¿Es obligatorio? | ¿Es 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 usa *ActionTrackerId*. | | `ActionTrackerID` | Obligatorio condicionalmente\* | No editable | Proporcionar este identificador es obligatorio cuando se usa *OrderId/Oid*. | | `SKU`\*\* | Obligatorio | No editable | Proporciona el valor SKU del artículo que quieres modificar. | | `Amount`\*\* | Obligatorio 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, ya sea *ActionId* **o** (*OrderId/Oid* + *ActionTrackerId*) \*\*Estos campos deben incluirse para cada artículo que modifiques. Los campos de identificador 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) SKU O7427540 aparece dos veces en este ejemplo porque una línea está revirtiendo (Amount=0) y la 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 revoques datos de acción, 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 pasa 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 sobre los códigos de disposición**. {% endhint %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.