> 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 massa, 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, certifique-se de seguir 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ê poderá retomar o envio do seu arquivo de modificações/reversões em lote. {% 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 de 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:** * Saiba quais campos usar em uma modificação ou reversão em lote via FTP/SMTP * Baixe arquivos de modelo com dados de exemplo de placeholder * Entenda 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 para vários pedidos.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | ----------------- | ------------------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ActionID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é recomendado quando a janela de desduplicação é curta. | | `Oid / OrderId` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é obrigatório ao usar *ActionTrackerId*. | | `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse 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 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. | | `Observação` | Opcional | Editável | Campo geral para fins de relatório em nível de evento. Se estiver vazio na conversão original, o envio de um valor o insere. Aceito apenas uma vez por ação — envie quaisquer outras alterações de campo na mesma solicitação. | | `LocationId` | Opcional | Editável | Usado principalmente para hospedagens, este é o identificador exclusivo do local especificado nesta conversão. Se estiver vazio na conversão original, o envio de um valor o insere. | | `LocationName` | Opcional | Editável | Usado principalmente para hospedagens, este é o nome do local especificado nesta conversão. Se estiver vazio na conversão original, o envio de um valor o insere. | | `GiftPurchase` | Opcional | Editável | Defina como true para marcar o pedido como uma compra para presente, ou false para desmarcá-lo. Se estiver vazio na conversão original, o envio de um valor o insere. | | `Text1–Text50` | Opcional | Editável | Campos gerais de texto que aceitam strings de quaisquer dados de texto que você queira enviar (Text1 a Text50). Se estiver vazio na conversão original, o envio de um valor o insere. Aceito apenas uma vez por ação — envie quaisquer outras alterações de campo na mesma solicitação. | | `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*)
Arquivos de modelo * [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)
#### Reversões em nível de pedido Isto é para quando você quiser reverter ações impulsionadas por parceiros em massa 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 | | ----------------- | -------------------------------- | ------------ | ----------------------------------------------------------------------------------- | | `ActionID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é recomendado quando a janela de desduplicação é curta. | | `Oid / OrderId` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é obrigatório ao usar *ActionTrackerId*. | | `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse 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, ou seja, ou *ActionId* **ou** (*OrderId/Oid* + *ActionTrackerId*) \*\*Se o original *Amount = 0*, deixe *Amount* inalterado para evitar que seja classificado incorretamente como uma modificação.
Arquivos de modelo * [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)
#### 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 valor para vários itens em um pedido.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | ----------------- | ------------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------ | | `ActionID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é recomendado quando a janela de desduplicação é curta. | | `Oid / OrderId` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é obrigatório ao usar *ActionTrackerId*. | | `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse 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 precisará 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.
Arquivos de modelo * [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)
#### 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.
Parâmetros aceitos | Campo | Obrigatório? | Editável? | Observação | | ----------------- | ------------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------ | | `ActionID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é recomendado quando a janela de desduplicação é curta. | | `Oid / OrderId` | Obrigatório condicionalmente\* | Não editável | Fornecer esse identificador é obrigatório ao usar *ActionTrackerId*. | | `ActionTrackerID` | Obrigatório condicionalmente\* | Não editável | Fornecer esse 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 precisará 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.
Arquivos de modelo * [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 a outra está modificando (Amount=15).
{% 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 Sempre 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:** Enviar um valor não aceito fará com que a entrada não seja processada e, em vez disso, retorne 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 os Códigos de Disposição**. {% endhint %}
CodeDescription
CONS_FRAUDConsumer fraud
CONS_ERRORConsumer error
ITEM_RETURNEDItem was returned
APPROVED

Action is approved

Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.

ORDER_ERROROrder error
ORDER_UPDATEOrder was updated
PUB_ACT_DISPUTEPartner activity dispute
ADV_ACT_DISPUTEBrand activity dispute
NOT_COMPLIANCE_TERMSNot in compliance with terms
ITEM_OUT_OF_STOCKItem is out of stock
TEST_ACTIONTest action
PARTNER_NOT_ACTIVEPartner account deactivated
CREDITED_DIFFERENT_MPCredited to another partner
OTHEROther reason
--- # 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=&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.