> 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/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md).

# Referência de modificações e reversões em lote

Ao modificar ou reverter dados de ações em massa, comece baixando um dos arquivos de modelo fornecidos pela impact.com e substituindo os dados de exemplo pelos seus. Ao adicionar seus próprios dados, siga as diretrizes da tabela de referência relevante para garantir que o arquivo esteja formatado corretamente. Quando o arquivo de envio estiver pronto, você poderá continuar enviando o arquivo de modificações/reversões em lote.

{% hint style="info" %}
Este artigo de referência inclui os campos mais usados para modificações e reversões em lote. Para consultar uma referência completa e detalhada, incluindo as descrições dos campos, consulte [Referências de campos de ações e conversões](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references).
{% endhint %}

**Consulte as referências abaixo para:**

* Saber quais campos usar em uma modificação ou reversão em lote via FTP/SMTP
* Baixar arquivos de modelo com dados de exemplo de preenchimento
* Entender quais códigos de motivo usar e quando

#### Modificações no nível do pedido

Use esta opção quando quiser atualizar dados de ações em massa no nível do pedido, em vez de no nível do item. Por exemplo, para alterar o valor de vários pedidos.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                                                                                                                                                                                                   |
| ----------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obrigatório condicionalmente\* | Não editável | É recomendável fornecer esse identificador quando a janela de deduplicação for curta.                                                                                                                                                                                        |
| `Oid / OrderId`   | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *ActionTrackerId*.                                                                                                                                                                                                         |
| `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *OrderId/Oid*.                                                                                                                                                                                                             |
| `Amount`          | Opcional                       | Editável     | Defina o novo valor total do pedido.                                                                                                                                                                                                                                         |
| `currencyCode`    | Opcional                       | Editável     | Defina a moeda da receita da ação. Se não for informada, será usada a moeda da sua conta da impact.com.                                                                                                                                                                      |
| `CustomerStatus`  | Opcional                       | Editável     | Defina o status do cliente no momento da conversão, por exemplo, NEW / EXISTING.                                                                                                                                                                                             |
| `Note`            | Opcional                       | Editável     | Campo geral para fins de geração de relatórios no nível do evento. Se estiver vazio na conversão original, o envio de um valor o preencherá. Aceito apenas uma vez por ação — envie quaisquer outras alterações de campos na mesma solicitação.                              |
| `LocationId`      | Opcional                       | Editável     | Usado principalmente para hospedagens, é o identificador exclusivo do local especificado nesta conversão. Se estiver vazio na conversão original, o envio de um valor o preencherá.                                                                                          |
| `LocationName`    | Opcional                       | Editável     | Usado principalmente para hospedagens, é o nome do local especificado nesta conversão. Se estiver vazio na conversão original, o envio de um valor o preencherá.                                                                                                             |
| `GiftPurchase`    | Opcional                       | Editável     | Defina como true para marcar o pedido como uma compra de presente ou como false para remover essa marcação. Se estiver vazio na conversão original, o envio de um valor o preencherá.                                                                                        |
| `Text1–Text50`    | Opcional                       | Editável     | Campos de texto gerais que aceitam qualquer texto que você queira enviar (Text1 a Text50). Se estiverem vazios na conversão original, o envio de um valor os preencherá. Aceitos apenas uma vez por ação — envie quaisquer outras alterações de campos na mesma solicitação. |
| `Reason`          | Obrigatório                    | Editável     | Informe um código de motivo válido para a modificação.                                                                                                                                                                                                                       |

\*É necessário fornecer pelo menos um caminho de identificação, ou seja, *ActionId* **ou** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>Arquivos de modelo</summary>

* [Modelo de modificações no nível do pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [Modelo de aprovações no nível do pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### Reversões no nível do pedido

Use esta opção quando quiser reverter em massa ações iniciadas por parceiros no nível do pedido, e não no nível do item, por exemplo, reverter vários pedidos.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                     | Editável?    | Observação                                                                            |
| ----------------- | -------------------------------- | ------------ | ------------------------------------------------------------------------------------- |
| `ActionID`        | Obrigatório condicionalmente\*   | Não editável | É recomendável fornecer esse identificador quando a janela de deduplicação for curta. |
| `Oid / OrderId`   | Obrigatório condicionalmente\*   | Não editável | É obrigatório fornecer esse identificador ao usar *ActionTrackerId*.                  |
| `ActionTrackerID` | Obrigatório condicionalmente\*   | Não editável | É obrigatório fornecer esse identificador ao usar *OrderId/Oid*.                      |
| `Amount`          | Obrigatório condicionalmente\*\* | Editável     | Defina como **0** para reverter o pedido, a menos que o valor original = 0\*\*        |
| `Reason`          | Obrigatório                      | Editável     | Informe um código de motivo válido para a reversão.                                   |

\*É necessário informar pelo menos um caminho de identificador, ou seja, *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Se o *Amount = 0*, deixe *Amount* inalterado para evitar que seja classificado incorretamente como uma modificação.

</details>

<details>

<summary>Arquivos de modelo</summary>

* [Modelo para reversões no nível do pedido](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### Modificações no nível do item

Use esta opção quando quiser atualizar dados de ações em massa no nível do item, e não no nível do pedido, por exemplo, alterar o Amount de vários itens de um pedido.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                                                            |
| ----------------- | ------------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obrigatório condicionalmente\* | Não editável | É recomendável fornecer esse identificador quando a janela de deduplicação for curta.                                                 |
| `Oid / OrderId`   | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *ActionTrackerId*.                                                                  |
| `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *OrderId/Oid*.                                                                      |
| `SKU`\*\*         | Obrigatório                    | Não editável | Informe o valor de SKU do item que você deseja modificar.                                                                             |
| `Amount`\*\*      | Obrigatório condicionalmente   | Editável     | Defina o novo valor do item, ou seja, preço\*quantidade. Se você modificar a quantidade, também será necessário modificar este campo. |
| `Quantity`\*\*    | Opcional                       | Editável     | Defina a nova quantidade de itens no pedido.                                                                                          |
| `Category`\*\*    | Opcional                       | Editável     | Defina a categoria do item.                                                                                                           |
| `Reason`\*\*      | Obrigatório                    | Editável     | Informe um código de motivo válido para a reversão.                                                                                   |

\*É necessário informar pelo menos um caminho de identificador, ou seja, *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Esses campos devem ser incluídos para cada item que você modificar. Os campos de identificador são incluídos apenas uma vez por pedido.

</details>

<details>

<summary>Arquivos de modelo</summary>

* [Modelo para modificações no nível do item](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [Modelo para aprovações no nível do item](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### Reversões no nível do item

Use esta opção quando quiser reverter dados de ações em massa no nível do item, e não no nível do pedido, por exemplo, reverter vários itens de um pedido.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                                                            |
| ----------------- | ------------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obrigatório condicionalmente\* | Não editável | É recomendável fornecer esse identificador quando a janela de deduplicação for curta.                                                 |
| `Oid / OrderId`   | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *ActionTrackerId*.                                                                  |
| `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | É obrigatório fornecer esse identificador ao usar *OrderId/Oid*.                                                                      |
| `SKU`\*\*         | Obrigatório                    | Não editável | Informe o valor de SKU do item que você deseja modificar.                                                                             |
| `Amount`\*\*      | Obrigatório condicionalmente   | Editável     | Defina o novo valor do item, ou seja, preço\*quantidade. Se você modificar a quantidade, também será necessário modificar este campo. |
| `Quantity`\*\*    | Opcional                       | Editável     | Defina a nova quantidade de itens no pedido.                                                                                          |
| `Reason`\*\*      | Obrigatório                    | Editável     | Informe um código de motivo válido para a modificação.                                                                                |

\*É necessário informar pelo menos um caminho de identificador, ou seja, *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Esses campos devem ser incluídos para cada item que você modificar. Os campos de identificador são incluídos apenas uma vez por pedido.

</details>

<details>

<summary>Arquivos de modelo</summary>

* [Modelo para reversões no nível do item](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

O SKU O7427540 aparece duas vezes neste exemplo porque uma linha reverte (Amount=0) e a outra modifica (Amount=15).

</details>

{% hint style="info" %}
**Observação:** Se você prevê que haverá *OrderIds* duplicados e optar por usar a combinação de *OrderId + ActionTrackerId*, o impact.com aplicará sua atualização ao *ActionId* mais recente por padrão. Use o *ActionId* antigo se quiser aplicar a atualização ao *ActionId*.
{% endhint %}

#### Códigos de motivo

Sempre que modificar ou reverter dados de ações, você deve informar um motivo. Use o código de motivo correspondente abaixo para explicar por que a ação está sendo atualizada.

{% hint style="warning" %}
**Aviso:** O envio de um valor não aceito fará com que a entrada não seja processada e, em vez disso, retornará um erro. Se precisar de códigos de motivo personalizados, entre em contato com seu CSM ou [**entre em contato com o suporte**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **para discutir os códigos de disposição**.
{% endhint %}

<table><thead><tr><th width="239.2734375">Code</th><th>Description</th></tr></thead><tbody><tr><td><code>CONS_FRAUD</code></td><td>Consumer fraud</td></tr><tr><td><code>CONS_ERROR</code></td><td>Consumer error</td></tr><tr><td><code>ITEM_RETURNED</code></td><td>Item was returned</td></tr><tr><td><code>APPROVED</code></td><td><p>Action is approved</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note:</strong> If you’re trying to approve actions, <code>Approve</code> needs to be set up as a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p></div></td></tr><tr><td><code>ORDER_ERROR</code></td><td>Order error</td></tr><tr><td><code>ORDER_UPDATE</code></td><td>Order was updated</td></tr><tr><td><code>PUB_ACT_DISPUTE</code></td><td>Partner activity dispute</td></tr><tr><td><code>ADV_ACT_DISPUTE</code></td><td>Brand activity dispute</td></tr><tr><td><code>NOT_COMPLIANCE_TERMS</code></td><td>Not in compliance with terms</td></tr><tr><td><code>ITEM_OUT_OF_STOCK</code></td><td>Item is out of stock</td></tr><tr><td><code>TEST_ACTION</code></td><td>Test action</td></tr><tr><td><code>PARTNER_NOT_ACTIVE</code></td><td>Partner account deactivated</td></tr><tr><td><code>CREDITED_DIFFERENT_MP</code></td><td>Credited to another partner</td></tr><tr><td><code>OTHER</code></td><td>Other reason</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 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/pt-br/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=<user_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.
