> 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ção em lote, 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 na tabela de referência relevante para garantir que o envio do seu arquivo esteja formatado corretamente. Assim que o arquivo de envio estiver pronto, você pode continuar com [enviando suas modificações/reversões em lote](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#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/brand-api-reference/reference/action-and-conversion-field-references). {% endhint %} **Veja 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 em espaço reservado * Entender quais códigos de motivo aplicar e quando #### Modificações no nível do pedido Isso é para quando você quiser atualizar dados de ação em lote no nível do pedido em vez do nível do item, por exemplo, alterar o valor do pedido para vários pedidos.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | -------------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------- | | `ID da ação` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. | | `Oid / ID do pedido` | 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*. | | `Amount` | Opcional | Editável | Defina o novo valor total do pedido. | | `código da moeda` | 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 informada. | | `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, isto é, ou *ActionId* **ou** (\*OrderId/Oid \*+ *ActionTrackerId*)
Arquivos de modelo * [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)
#### Reversões no nível do pedido Isso é para quando você quiser reverter ações acionadas por parceiros em lote no nível do pedido em vez do nível do item, por exemplo, reverter vários pedidos.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | -------------------- | -------------------------------- | ------------ | ---------------------------------------------------------------------------------- | | `ID da ação` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. | | `Oid / ID do pedido` | 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*. | | `Amount` | 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, isto é, ou *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*) \*\*Se o original *Valor = 0*, deixe *Amount* inalterado para evitar que seja classificado incorretamente como uma modificação.
Arquivos de modelo * [Modelo de 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)
#### Modificações no nível do item Isso é para quando você quiser atualizar dados de ação em lote no nível do item em vez do nível do pedido, por exemplo, alterar o valor para vários itens em um pedido.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | -------------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | `ID da ação` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. | | `Oid / ID do pedido` | 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 do 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, 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, isto é, 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.
Arquivos de modelo * [Modelo de 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 de 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)
#### Reversões no nível do item Isso é para quando você quiser reverter dados de ação em lote no nível do item em vez do nível do pedido, por exemplo, reverter vários itens em um pedido.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | -------------------- | ------------------------------ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | `ID da ação` | Obrigatório condicionalmente\* | Não editável | Fornecer este identificador é recomendado quando a janela de deduplicação é curta. | | `Oid / ID do pedido` | 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 do 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, 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, isto é, 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.
Arquivos de modelo * [Modelo de 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 está revertendo (Valor=0) e a outra está modificando (Valor=15).
{% hint style="info" %} **Observação:** Se você espera ter OrderIds duplicados *IDs do pedido* e optar por usar a combinação de *OrderId + ActionTrackerId*, a impact.com aplica sua atualização ao mais recente *ActionId* por padrão. Use o antigo *ActionId* se você quiser aplicar a atualização ao mais antigo *ActionId*. {% endhint %} #### Códigos de motivo Sempre que você modificar ou reverter dados de ação, é preciso 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:** A passagem de um valor não aceito resultará no não processamento da entrada e, em vez disso, no retorno de um erro. Se você 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 Códigos de Disposição**. {% endhint %}
CódigoDescrição
CONS_FRAUDFraude do consumidor
CONS_ERRORErro do consumidor
ITEM_RETURNEDO item foi devolvido
APPROVED

A ação está aprovada

Observação: Se você estiver tentando aprovar ações, Aprovar precisa ser configurado como um código de disposição personalizado.

ORDER_ERRORErro do pedido
ORDER_UPDATEO pedido foi atualizado
PUB_ACT_DISPUTEDisputa de atividade do parceiro
ADV_ACT_DISPUTEDisputa de atividade da marca
NOT_COMPLIANCE_TERMSNão está em conformidade com os termos
ITEM_OUT_OF_STOCKO item está fora de estoque
TEST_ACTIONAção de teste
PARTNER_NOT_ACTIVEConta do parceiro desativada
CREDITED_DIFFERENT_MPCreditado para outro parceiro
OUTROOutro motivo
--- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.