Testtool REST

Return on Demand webservice

PostNL offers the possibility of picking up return parcels at a specific location. This offers additional convenience for the consumer. By requesting the Return on Demand API call (quote), PostNL will provide available time frames for the given location. After a time frame is chosen by the consumer, you can request the Return on Demand API call (purchase) to claim the specific time frame.

• You share the available time frames with the consumer, e.g. as part of your webshop checkout where a return parcel is announced. The consumer chooses from the available timeframes.

• The consumer has to put a return label on the return parcel with a valid barcode.

• The consumer will be notified by PostNL that a parcel will be picked up at the requested address.

• The barcode will be scanned at pickup.

The following methods are defined within the Labelling WebService.

Methods	Description
Quote	First, you have to check which timeframes are available for the specified address, the Quote.
Purchase	To claim a timeframe, you post a purchase with one of the provided timeframes in the Quote response.

Interface version (REST only)	v1
Sandbox endpoint	https://api-sandbox.postnl.nl/shipment/v1/pickuporder
Sandbox swagger	https://api-sandbox.postnl.nl/shipment/v1/pickuporder/swagger.json
Production endpoint	https://api.postnl.nl/shipment/v1/pickuporder
Production swagger	https://api.postnl.nl/shipment/v1/pickuporder/swagger.json

REST:

API	Version	Release Date	Status	Schema Changes
Return on Demand	1	Okt 01, 2018	Current version	N/A

The parcel that needs to be picked up, will have to contain a label with a valid 3S barcode, that has been confirmed separately to PostNL. The pickuporder service cannot be used with Smart Returns (“Printerloos Retourneren”).