View the tables below to see which fields can be used in an FTP/SMTP batch modification or reversal. Reason codes (a required value) can also be found below. Remember that all files must be submitted in .CSV or XML formats.
Note
impact.com allows a maximum of 1000 modifications per action. If you need to make further modifications thereafter, contact support.
Query Parameter | Format | Required | Description |
---|---|---|---|
| String (40) | Optional | This can update the customer's status: |
| Integer | Yes, unless | Unique identifier for the action, used to specify which action you intend to update. |
| Alphanumeric (64) | Required, if Optional, if | Value that the brand assigns to the order—typically an order ID or confirmation number. |
| Integer | Required, if Optional, if | Numeric value that impact.com assigns to the Event Type that tracked the action. |
| Decimal (8,2) | Yes | Set the new amount of the order. Set to |
| String | Yes | Reason code for the modification or reversal—refer to the reason codes table to select one that applies. |
Query Parameter | Format | Required | Description |
---|---|---|---|
| String | No | For item-level actions, the Category that the item is in. |
| Integer | Yes, unless | Unique identifier for the action, used to specify which action you intend to update. |
| Alphanumeric (64) | Required, if Optional, if | Value that the advertiser assigns to the order—typically an order ID or confirmation number. |
| Integer | Required, if Optional, if | Numeric value that impact.com assigns to the Event Type that tracked the action.impact.com |
| Decimal (8,2) | Yes | Set the new amount of the order. Set to |
| Alphanumeric (40) | Yes | For item-level actions, the SKU value assigned to an item as specified in the SKU list uploaded to impact.com. |
| Integer | Yes | For item-level actions, the modified quantity of items in the order. |
| String | Yes | Reason code for the modification or reversal—refer to the reason codes table to select one that applies. |
Code | Description |
---|---|
| Consumer fraud |
| Consumer error |
| Item returned |
| Order error |
| Order was updated |
| Partner activity dispute |
| Advertiser activity dispute |
| Not in compliance with terms |
| Item is out of stock |
| Test action |
| Partner account deactivated |
| Credited to another partner |
| Other reason |
Note
Passing a non-accepted value will result in the entry not being processed and throwing an error instead. If you need custom reason codes, reach out to your CSM (or contact support) to discuss Disposition Codes.