# 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 %}