# Referência de Modificações & Reversões em Lote

Ao modificar ou reverter dados de ação em massa, comece baixando um dos arquivos de modelo fornecidos pela impact.com e substitua os dados de exemplo pelos seus. Ao adicionar seus próprios dados, certifique-se de seguir as diretrizes na tabela de referência relevante para garantir que o arquivo enviado esteja formatado corretamente. Depois que seu arquivo de envio estiver pronto, você pode continuar com [enviando 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.

**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 substitutos
* Entender quais códigos de motivo aplicar e quando

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

Isto é para quando você quiser atualizar dados de ação em massa no nível do pedido em vez do nível do item, por exemplo, alterar o valor do pedido (Amount) para vários pedidos.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                           |
| ----------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------- |
| `ActionID`        | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta.                   |
| `Oid / OrderId`   | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.                                 |
| `ActionTrackerID` | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                                     |
| `Amount`          | Opcional                       | Editável     | Defina o novo valor total do pedido.                                                                 |
| `currencyCode`    | Opcional                       | Editável     | Defina a moeda de receita da ação. Padrão para 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, NEW / EXISTING.                     |
| `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

Isto é para quando você quiser reverter ações conduzidas por parceiros em massa no nível do pedido em vez do nível do item, por exemplo, reverter vários pedidos.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                     | Editável?    | Observação                                                                         |
| ----------------- | -------------------------------- | ------------ | ---------------------------------------------------------------------------------- |
| `ActionID`        | Condicionalmente Obrigatório\*   | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. |
| `Oid / OrderId`   | Condicionalmente Obrigatório\*   | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.               |
| `ActionTrackerID` | Condicionalmente Obrigatório\*   | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                   |
| `Amount`          | Condicionalmente Obrigatório\*\* | Editável     | Defina como **0** para reverter 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 original *Amount = 0*, deixe *Amount* inalterado para evitar classificar 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

Isto é para quando você quiser atualizar dados de ação em massa no nível do item em vez do nível do pedido, por exemplo, alterar o Amount de vários itens em um pedido.

<details>

<summary>Parâmetros aceitos</summary>

| Campo             | Obrigatório?                   | Editável?    | Observação                                                                                                                         |
| ----------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `ActionID`        | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta.                                                 |
| `Oid / OrderId`   | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.                                                               |
| `ActionTrackerID` | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                                                                   |
| `SKU`\*\*         | Obrigatório                    | Não editável | Forneça o valor SKU do item que você deseja modificar.                                                                             |
| `Amount`\*\*      | Condicionalmente Obrigatório   | 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*)

\*\*Estes campos devem ser incluídos para cada item que você modificar. Os campos identificadores 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

Isto é para quando você quiser reverter dados de ação em massa no nível do item em vez do 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`        | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta.                                                 |
| `Oid / OrderId`   | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *ActionTrackerId*.                                                               |
| `ActionTrackerID` | Condicionalmente Obrigatório\* | Não editável | Fornecer este identificador é obrigatório ao usar *OrderId/Oid*.                                                                   |
| `SKU`\*\*         | Obrigatório                    | Não editável | Forneça o valor SKU do item que você deseja modificar.                                                                             |
| `Amount`\*\*      | Condicionalmente Obrigatório   | 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*)

\*\*Estes campos devem ser incluídos para cada item que você modificar. Os campos identificadores 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 (Amount=0) e outra está modificando (Amount=15).

</details>

{% hint style="info" %}
**Observação:** Observação: Se você prevê ter duplicatas *Oid / OrderIds* e optar por usar a combinação de *Oid / 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 %}

Para ver uma referência completa e detalhada de parâmetros incluindo descrições dos campos, consulte [Referências de Ação e Dados de Conversão da impact.com](https://integrations.impact.com/impact-brand/docs/impactcom-action-conversion-data-references).

#### Códigos de Razão

Toda vez que você modificar ou reverter dados de ação, deve 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:** Passar um valor não aceito resultará na não processamento da entrada e no retorno de um erro. Se você precisar de códigos de motivo personalizados, entre em contato com seu CSM ou **contate o suporte para discutir Códigos de Disposição**.
{% endhint %}

| Código                  | Descrição                                                                                                                                                                                                                                                      |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| CONS\_FRAUD             | Fraude do consumidor                                                                                                                                                                                                                                           |
| CONS\_ERROR             | Erro do consumidor                                                                                                                                                                                                                                             |
| ITEM\_RETURNED          | Item foi devolvido                                                                                                                                                                                                                                             |
| APPROVED                | <p>Ação aprovada</p><p><strong>Observação:</strong> Se você estiver tentando aprovar ações, <code>Aprovar</code> precisa ser configurado como um <a href="../../tracking/set-up-tracking/manage-disposition-codes">código de disposição personalizado</a>.</p> |
| ORDER\_ERROR            | Erro de pedido                                                                                                                                                                                                                                                 |
| ORDER\_UPDATE           | Pedido foi atualizado                                                                                                                                                                                                                                          |
| PUB\_ACT\_DISPUTE       | Disputa de atividade do parceiro                                                                                                                                                                                                                               |
| ADV\_ACT\_DISPUTE       | Disputa de atividade da marca                                                                                                                                                                                                                                  |
| NOT\_COMPLIANCE\_TERMS  | Não está em conformidade com os termos                                                                                                                                                                                                                         |
| ITEM\_OUT\_OF\_STOCK    | Item está fora de estoque                                                                                                                                                                                                                                      |
| TEST\_ACTION            | Ação de teste                                                                                                                                                                                                                                                  |
| PARTNER\_NOT\_ACTIVE    | Conta do parceiro desativada                                                                                                                                                                                                                                   |
| CREDITED\_DIFFERENT\_MP | Creditado para outro parceiro                                                                                                                                                                                                                                  |
| OTHER                   | Outro motivo                                                                                                                                                                                                                                                   |
