Migrating to Returns v2
ℹ️ Reference the Returns v2 page for API implementation details.
This guide can be used to assist when migrating from the legacy Saks marketplace return workflow to returns v2.
Use this table to identify the new APIs that will replace your current APIs for each action.
Action | Legacy Returns API | Returns v2 API |
|---|---|---|
Retrieve Open Returns | OR11 | RT11 |
Acknowledge/Receive Return (1) | OR31 | RT25 |
Accept Return (2) | OR28 and OR31 (optional) | RT26, OR28 and OR31 (optional) |
Reject Return | OR31 | RT26 |
1 - With legacy returns, it was advised to acknowledge a return by calling API OR31 and setting the boolean attribute 'hasnewreturn' that you could utilize in subsequent calls when retrieving returns to avoid processing that return again.
With returns v2, returns now have statuses. This action is simplified by explicitly receiving the return, which changes the return status.
2 - With legacy returns, when you accepted a return, API OR28 would both mark it as accepted and approve the refund. With returns v2, this is now done using two distinct API calls.