Downloading returns

Order returns work analogously to orders in Base and have their own, mirrored block of API methods.

​

The main method

getOrderReturns downloads returns from Base from a given date, max. 100 per call — the same pagination principle as getOrders.

​

Key response fields

​

Working with statuses and refunds

• Return statuses are read and written analogously to orders: getOrderReturnStatusList, setOrderReturnStatus / setOrderReturnStatuses.
• Return reasons (why the customer is returning the item) come from getOrderReturnReasonsList.
• setOrderReturnRefund marks a return as refunded — it does not trigger any actual payment, it only records the information in Base.

​

Tracking changes over time

Just like orders, returns have their own journal: getOrderReturnJournalList — same principle and activation requirement (Profile → API) as getJournalList.

​

Returns from marketplace channels

For selected marketplace channels, Base can automatically fetch return requests directly from the customer and create returns from them — configurable per sales channel. Once enabled, just monitor new returns as described above.