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

Ao modificar ou reverter dados de ação em lote, comece baixando um dos arquivos de modelo fornecidos pela impact.com e substituindo os dados de exemplo pelos seus próprios. Ao adicionar seus próprios dados, siga as diretrizes na tabela de referência relevante para garantir que o envio do seu arquivo esteja formatado corretamente. Assim que seu arquivo de envio estiver pronto, você poderá prosseguir com [o envio de suas modificações/reversões em lote](https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/submit-and-modify-conversion-data/submit-batch-modifications-and-reversals#submit-your-data-file-0-1) arquivo.

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

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

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

#### Modificações em nível de pedido

Isso é para quando você deseja atualizar dados de ação em lote no nível do pedido, e não no nível do item, por exemplo, alterar o valor do pedido para vários pedidos.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                                 |
| ----------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta.                         |
| `Oid / OrderId`   | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.                                       |
| `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                                           |
| `Valor`           | Opcional                       | Editável     | Defina o novo valor total do pedido.                                                                       |
| `currencyCode`    | Opcional                       | Editável     | Defina a moeda da receita da ação. Por padrão, será a moeda da sua conta impact.com, se não for fornecida. |
| `CustomerStatus`  | Opcional                       | Editável     | Defina o status do cliente no momento da conversão, por exemplo, NOVO / EXISTENTE.                         |
| `Motivo`          | Obrigatório                    | Editável     | Forneça um código de motivo válido para a modificação.                                                     |

\*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou *ActionId* **ou** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>Arquivos de modelo</summary>

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

</details>

#### Reversões em nível de pedido

Isso é para quando você deseja reverter ações iniciadas por parceiros em lote 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 | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. |
| `Oid / OrderId`   | Obrigatório condicionalmente\*   | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.               |
| `ActionTrackerID` | Obrigatório condicionalmente\*   | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                   |
| `Valor`           | Obrigatório condicionalmente\*\* | Editável     | Defina como **0** para reverter o pedido, a menos que o valor original = 0\*\*     |
| `Motivo`          | Obrigatório                      | Editável     | Forneça um código de motivo válido para a reversão.                                |

\*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*)

\*\*Se o valor original *Valor = 0*, deixe *Valor* inalterado para evitar classificá-lo incorretamente como uma modificação.

</details>

<details>

<summary>Arquivos de modelo</summary>

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

</details>

#### Modificações em nível de item

Isso é para quando você deseja atualizar dados de ação em lote no nível do item, e não no nível do pedido, por exemplo, alterar o valor para 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 | Fornecer este identificador é recomendado quando a janela de deduplicação é curta.                                                 |
| `Oid / OrderId`   | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.                                                               |
| `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                                                                   |
| `SKU`\*\*         | Obrigatório                    | Não editável | Forneça o valor de SKU do item que você deseja modificar.                                                                          |
| `Valor`\*\*       | Obrigatório condicionalmente   | Editável     | Defina o novo valor do item, ou seja, preço\*quantidade. Se você modificar a quantidade, este campo também precisa ser modificado. |
| `Quantidade`\*\*  | Opcional                       | Editável     | Defina a nova quantidade de itens no pedido.                                                                                       |
| `Categoria`\*\*   | Opcional                       | Editável     | Defina a categoria do item.                                                                                                        |
| `Motivo`\*\*      | Obrigatório                    | Editável     | Forneça um código de motivo válido para a reversão.                                                                                |

\*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou *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 de modificações em nível de item](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [Modelo de aprovações em nível de item](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### Reversões em nível de item

Isso é para quando você deseja reverter dados de ação em lote no nível do item, e não no nível do pedido, por exemplo, reverter vários itens em um pedido.

<details>

<summary>Parâmetros aceitos</summary>

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

\*Pelo menos um caminho de identificador deve ser fornecido, ou seja, ou *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 de reversões em nível de 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 está revertendo (Valor=0) e a outra está modificando (Valor=15).

</details>

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

#### Códigos de motivo

Toda vez que você modificar ou reverter dados de ação, é necessário fornecer um motivo. Use o código de motivo relevante abaixo para explicar por que a ação está sendo atualizada.

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


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.