AfterShip Returns Common Scenario

This document will describe several common usage scenarios for AfterShip Returns, provided for your reference.


The first step is to import your order into AfterShip system, you can import the your order with order endpoints. Here is a sample request for creating orders, along with the payload required to use AfterShip Returns:

Once you have successfully imported the orders according to the above example, the following features of Returns can be used:

1. Accept return request in Returns Page
Customers can use their number/name + customer.emails on the Returns Page to find their order, then select return items, return reason, return resolution, shipping, and finally submit a return request.

2. Returns window - Order date
You can configure returns window based on source_created_at, and any return requests exceeding this window will be automatically blocked.

3. Blocklist - Customer
You can configure blocklist based on customer.emails to block return requests.

4. Allowlist - Order
You can configure allowlist based on name, making exceptions for specific orders so that customers can raise return requests.

5. Allowlist - Customer
You can configure allowlist based on customer.emails, making exceptions for specific customers so that they can raise return requests.

If you want to use more features of Returns, you can import order according to the following example:

Once you have successfully imported the orders according to the above example, the following features of Returns can be used:

1. Returns window - Fulfillment date
You can configure returns window based on shipments[*].source_created_at, and any return requests exceeding this window will be automatically blocked.

2. Discounted items
You can enable Do not accept discounted items, and order with items[*].discount greater than 0 will be automatically blocked.

3. Blocklist - Product type
You can configure blocklist based on items[*].product_categories to block return requests.

4. Blocklist - Product tag
You can configure blocklist based on items[*].product_tags to block return requests.

5. Allowlist - Product type
You can configure allowlist based on items[*].product_categories, making exceptions for specific product types so that customers can raise return requests.

6. Allowlist - Product tag
You can configure allowlist based on items[*].product_tags, making exceptions for specific product tags so that customers can raise return requests.

7. Replace for another variant
You can provide Replace with the same item resolution to customer, but you need to import the corresponding products according to the following example: