Returns methods

From the Sendcloud panel, you can enable the following return methods through your Return portal settings:

  • Arrange a pickup
  • Return in store
  • At a drop-off point (includes ERS - Easy returns solution)
  • Labelless returns to a drop-off point

This tutorial explains the various ways you can specify a return method when you Create a return through the Return portal API, and the differences between each method.


Arrange a pickup

The pickup returns method will schedule a pickup from your customer’s address as soon as the return parcel is announced. Depending on the carrier, the pickup will then take place either on the next working day, or the following day.

There are a limited number of carriers who support this feature. For more information about pickup returns, including a list of supported carriers and pickup schedules, please see our Help Center.

To create a pickup return through the API, you need to include the delivery_option: "pickup" field in the request. You also need to include a selected_functionalities object, and include the field first_mile": "pickup.

Example request

 1{
 2    "reason": 4,
 3    "message": "",
 4    "outgoing_parcel": 19,
 5    "refund":
 6    {
 7        "refund_type":
 8        {
 9            "code": "money"
10        },
11        "message": ""
12    },
13    "delivery_option": "pickup",
14    "products":
15    [],
16    "incoming_parcel":
17    {
18        "collo_count": 1,
19        "from_address_1": "afsdgfnm",
20        "from_address_2": "",
21        "from_city": "sasfsfas",
22        "from_company_name": "",
23        "from_country": "DE",
24        "from_email": "asdasd@asdfasd.com",
25        "from_house_number": "1",
26        "from_name": "asdasd",
27        "from_postal_code": "12311",
28        "from_telephone": "+49612312312"
29    },
30    "selected_functionalities":
31    {
32        "first_mile": "pickup"
33    },
34    "selected_carrier_code": "postnl",
35    "pickup_date": "2021-09-13"
36}

Return in store

If you have enabled this method in your portal settings, you can allow your customers to drop their parcel off at a physical store location. Through this method, a return shipping label isn’t required.

To create an in-store return, specify the following field in your request: delivery_option": in_store.


Drop-off point

This method allows your customer to return their parcel by delivering it to the nearest service point (drop-off) location for the chosen carrier.

To specify a drop-off location in your request, use the service_point object structured exactly as you received it from the Outgoing parcel lookup step.

You’ll also need to include the following field: delivery_option: drop_off_point.

Example request:

 1{
 2    "outgoing_parcel": 190024389,
 3    "delivery_option": "drop_off_point",
 4    "reason": 13,
 5    "message": "Doesn't suit me.",
 6    "service_point":
 7    {
 8        "house_number": "92",
 9        "distance": 111,
10        "phone": "040-2523232",
11        "homepage": "",
12        "id": 10575592,
13        "open_tomorrow": true,
14        "email": "",
15        "latitude": "51.439163",
16        "postal_code": "5616GS",
17        "city": "Eindhoven",
18        "carrier": "postnl",
19        "code": "212138",
20        "extra_data":
21        {
22            "retail_network_id": "PNPNL-01",
23            "terminal_type": "",
24            "partner_name": "PostNL",
25            "sales_channel": ""
26        },
27        "country": "NL",
28        "street": "Strijpsestraat",
29        "name": "Rono Sport",
30        "formatted_opening_times":
31        {
32            "0":
33            [
34                "13:00 - 18:00"
35            ],
36            "1":
37            [
38                "09:30 - 18:00"
39            ],
40            "2":
41            [
42                "09:30 - 18:00"
43            ],
44            "3":
45            [
46                "09:30 - 18:00"
47            ],
48            "4":
49            [
50                "09:30 - 18:00"
51            ],
52            "5":
53            [
54                "09:30 - 17:00"
55            ],
56            "6":
57            []
58        },
59        "longitude": "5.458742",
60        "is_active": true
61    },
62    "selected_carrier_code": "dhl",
63    "incoming_parcel":
64    {
65        "collo_count": 1,
66        "from_name": "John Doe",
67        "from_company_name": "FlowerShop",
68        "from_house_number": "70",
69        "from_city": "Munich",
70        "from_postal_code": "80686",
71        "from_country": "DE",
72        "from_telephone": "+31611223344",
73        "from_email": "john@doe.com"
74    },
75    "products":
76    [
77        {
78            "product_id": "3",
79            "quantity": 2,
80            "description": "Bag",
81            "value": "13.37",
82            "return_reason": 3,
83            "return_message": "Doesn't suit me"
84        }
85    ],
86    "refund":
87    {
88        "refund_type":
89        {
90            "code": "money"
91        },
92        "message": ""
93    }
94}

Labelless returns to a drop-off point

This method works similarly to the drop-off return method, but your customer doesn’t need to physically print the return label and attach it to the box. Instead of a return label, a QR code will be generated. They can show this code on their phone when they take the parcel to a labelless drop-off point.

To create a labelless return, specify the field: delivery_option: drop_off_labelless. To specify a drop-off location in your request, you can the use the labelless_service_point object, structured exactly as you received it from the Outgoing parcel lookup step.

Not all carriers support labelless returns. See our Help Center for more information about how this return method works, and through which carriers.


Easy returns solution (ERS)

The ERS method allows customers who are based in more than 10km away from a applicable drop off-location to drop the parcel off at a branch for a national postal carrier instead. The national carrier will complete the first leg of the journey, and then hand the parcel over to the carrier you originally specified to complete the delivery.

The ERS is particularly useful for facilitating easy international returns for your customers. If your customer is based in Germany, for example, they’ll be able to drop their PostNL parcel off at a Deutsche Post service point. The names of both carriers will appear on the return label.

You can read more about the ERS and view a list of carriers who support this return method on our Help Center.

The ERS is enabled by default when the return method “At a drop off point” is enabled in your Return portal settings. To enable ERS for a return, include the field delivery option: drop_off_point in your request.

You also need to include the selected_functionalities object, with the field ers: true. In the selected_carrier_code field, include the name of the carrier you want to use to create the return label , e.g. postnl.

Example request:

 1{
 2    "reason": 4,
 3    "message": "",
 4    "outgoing_parcel": 19,
 5    "refund":
 6    {
 7        "refund_type":
 8        {
 9            "code": "money"
10        },
11        "message": ""
12    },
13    "delivery_option": "drop_off_point",
14    "products":
15    [],
16    "incoming_parcel":
17    {
18        "collo_count": 1,
19        "from_address_1": "afsdgfnm",
20        "from_address_2": "",
21        "from_city": "sasfsfas",
22        "from_company_name": "",
23        "from_country": "DE",
24        "from_email": "asdasd@asdfasd.com",
25        "from_house_number": "1",
26        "from_name": "asdasd",
27        "from_postal_code": "12311",
28        "from_telephone": "+49612312312"
29    },
30    "selected_functionalities":
31    {
32        "ers":
33        [
34            true
35        ]
36    },
37    "selected_carrier_code": "postnl"
38}
Go to top