When you use nShift Delivery to book and print shipments, those shipments can be imported automatically into nShift Returns - so your customers can register returns without you needing to set up a separate integration.
This article explains how to enable and configure the connection between Delivery and Returns.
Get started
Make sure the following is configured in Returns Admin:
- Auto-assign markets is enabled - Returns uses this to match each incoming shipment to the correct market based on the delivery country.
- Country codes are set per market - each market needs at least one country code so Returns knows where to route the shipment.
- Article data is included in your shipments - shipments without complete article information cannot be imported into Returns and will not be available for customers to return against.
How to enable the connection
Step 1: Enable shipment import in Returns
- In Returns Admin, go to Settings → Portal integration.
- Enable Shipment import.
Step 2: Enable automatic market routing
- Go to General settings.
- Enable Automatic market routing.
- Assign country codes to market, for each market, select which country codes it should cover.
- Click Save.
Article data requirements
For a shipment to import successfully, each parcel in your Delivery shipment must include article-level data. Without this, the shipment cannot be imported into Returns and will not be available for your customers to return against.
The following fields must at a minimum be included
| Delivery field | Returns field | Required |
shipment.orderNo | Primary order ID | Yes |
shipment.senderReference | Alternative order ID | No |
parcels[].articles[].articleNo | Product ID | Yes |
parcels[].articles[].name | Product name | Yes |
parcels[].articles[].currencyCode | Currency | Yes |
parcels[].articles[].count | Quantity | Yes |
parcels[].articles[].price | Net amount | No |
shipment.receiver.email | Customer email | Yes |
shipment.receiver.phone | Customer phone | Yes |
shipment.receiver.name | Customer first / last name | Yes |
shipment.receiver.address1 | Street address | Yes |
shipment.receiver.city | City | Yes |
shipment.receiver.zipcode | Postal Code | Yes |
shipment.receiver.country | Country (ISO alpha-2) | Yes |
Example article payload
If your shipments don't already include article data, add an articles array to each parcel in your Delivery payload:
"articles": [{
"price": 19.99,
"count": 1,
"name": "Article A",
"currencyCode": "GBP",
"articleNo": "A12345"
}]
If a shipment fails to import
In most cases, shipments import automatically without any action needed. If an import fails - for example due to missing article data - the system will retry automatically up to 3 times.
Failed shipments are kept for up to 14 days. During this time, nShift can investigate the issue and re-trigger the import once it's resolved.
If you notice a shipment is missing from Returns, contact nShift Support with the order number and we'll look into it.