When modifying or reversing action data in bulk, start by downloading one of impact.com’s provided template files and replacing the example data with your own. When adding your own data, be sure to follow the guidelines in the relevant reference table to ensure your file submission is formatted correctly. Once your submission file is ready, you can resume with submitting your batch modifications / reversals file.
See the references below to:
Learn which fields to use in an FTP/SMTP batch modification or reversal
Download template files with placeholder example data
Understand which reason codes to apply and when
This is for when you want to update action data in bulk at the order level rather than an item level, e.g., change the order Amount for multiple orders.
Field | Required? | Editable? | Note |
|---|---|---|---|
| Conditionally Required* | Non-editable | Providing this identifier is recommended when the deduplication window is short. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using ActionTrackerId. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using OrderId/Oid. |
| Optional | Editable | Set the new total amount for the order. |
| Optional | Editable | Set the revenue currency of the action. Defaults to your impact.com account currency if not provided. |
| Optional | Editable | Set the customer’s status at the time of conversion, e.g., NEW / EXISTING. |
| Required | Editable | Provide a valid reason code for the modification. |
*At least one identifier path must be provided, i.e., either ActionId or (OrderId/Oid + ActionTrackerId)
![[Download report] vNext](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-d86efd15651b5054fddb008ce5d1a1d6.svg)
This is for when you want to reverse partner-driven actions in bulk at the order level rather than an item level, e.g., reverse multiple orders.
Field | Required? | Editable? | Note |
|---|---|---|---|
| Conditionally Required* | Non-editable | Providing this identifier is recommended when the deduplication window is short. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using ActionTrackerId. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using OrderId/Oid. |
| Conditionally Required** | Editable | Set to 0 to reverse order, unless original amount = 0** |
| Required | Editable | Provide a valid reason code for the reversal. |
*At least one identifier path must be provided, i.e., either ActionId or (OrderId/Oid + ActionTrackerId)
**If original Amount = 0, leave Amount unchanged to avoid misclassifying as a modification.
This is for when you want to update action data in bulk at the item level rather than an order level, e.g., change the Amount for multiple items in an order.
Field | Required? | Editable? | Note |
|---|---|---|---|
| Conditionally Required* | Non-editable | Providing this identifier is recommended when the deduplication window is short. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using ActionTrackerId. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using OrderId/Oid. |
| Required | Non-editable | Provide the SKU value of the item you want to modify. |
| Conditionally Required | Editable | Set the new item amount, i.e., price*quantity. If you modify the quantity, this field requires modification too. |
| Optional | Editable | Set the new quantity of items in the order. |
| Optional | Editable | Set the category of the item. |
| Required | Editable | Provide a valid reason code for the modification. |
*At least one identifier path must be provided, i.e., either ActionId or (OrderId/Oid + ActionTrackerId)
**These fields must be included for each item you modify. The identifier fields are only included once per order.
This is for when you want to reverse action data in bulk at the item level rather than an order level, e.g., reverse multiple items in an order.
Field | Required? | Editable? | Note |
|---|---|---|---|
| Conditionally Required* | Non-editable | Providing this identifier is recommended when the deduplication window is short. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using ActionTrackerId. |
| Conditionally Required* | Non-editable | Providing this identifier is required when using OrderId/Oid. |
| Required | Non-editable | Provide the SKU value of the item you want to modify. |
| Conditionally Required | Editable | Set the new item amount, i.e., price*quantity. If you modify the quantity, this field requires modification too. |
| Optional | Editable | Set the new quantity of items in the order. |
| Required | Editable | Provide a valid reason code for the modification. |
*At least one identifier path must be provided, i.e., either ActionId or (OrderId/Oid + ActionTrackerId)
**These fields must be included for each item you modify. The identifier fields are only included once per order.
Note: Note: If you anticipate having duplicate Oid / OrderIds and opt to use the combination of Oid / OrderId + ActionTrackerId, impact.com applies your update to the newest ActionId by default. Use the old ActionId if you want to apply the update to the older ActionId.
To see a full, detailed parameter reference including field descriptions, refer to impact.com Action & Conversion Data References.
Every time you modify or reverse action data, you must provide a reason. Use the relevant reason code below to explain why the action is being updated.
Warning: Passing a non-accepted value will result in the entry not being processed and returning an error instead. If you need custom reason codes, reach out to your CSM or contact support to discuss Disposition Codes.
Code | Description |
|---|---|
CONS_FRAUD | Consumer fraud |
CONS_ERROR | Consumer error |
ITEM_RETURNED | Item was returned |
APPROVED | Action is approved |
ORDER_ERROR | Order error |
ORDER_UPDATE | Order was updated |
PUB_ACT_DISPUTE | Partner activity dispute |
ADV_ACT_DISPUTE | Brand activity dispute |
NOT_COMPLIANCE_TERMS | Not in compliance with terms |
ITEM_OUT_OF_STOCK | Item is out of stock |
TEST_ACTION | Test action |
PARTNER_NOT_ACTIVE | Partner account deactivated |
CREDITED_DIFFERENT_MP | Credited to another partner |
OTHER | Other reason |