When you use nShift Transsmart 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 the connection between Transsmart and Returns works, and what your team needs to configure to enable it.
How it works
The integration is triggered automatically by shipment status. When a shipment in Transsmart reaches the LABL status (label printed), it is automatically pushed to Returns and registered as an outbound order.
Once the shipment is available in Returns, your customer can log in to the Returns portal, find their order, and create a return for one or more items. Returns then books the return shipment back through Transsmart.
Before you start
The following must be configured before shipments can be imported:
- Returns must be activated for your Transsmart account - contact nShift Support to enable this.
- A Returns integration user must be created - Transsmart uses a dedicated username and password to authenticate with Returns when pushing shipments.
- Article data (Delivery Notes) must be included in your Transsmart shipments - shipments without article-level data cannot be imported into Returns and will not be available for customers to return against.
- Market routing must be configured - either via cost center mapping or automatic market routing based on delivery country (see below).
Market routing
Transsmart supports two ways to route incoming shipments to the correct market in Returns:
Option 1: Cost center mapping
The Transsmart cost center value maps directly to the Returns market code. Use this if your shipments already use cost centers to distinguish between markets — simply make sure your cost center values match the market codes configured in Returns.
Option 2: Automatic market routing
If you don't use cost centers, Returns can automatically assign shipments to the correct market based on the delivery country. To use this:
- In Returns Admin, go to General settings and enable Automatic market routing.
- For each market, assign the relevant country codes so Returns knows where to route each shipment.
If both are configured, automatic market routing mapping takes precedence.
| Transsmart field | Returns field | Required |
|---|---|---|
| Shipment → order reference | Order ID | Yes |
| Shipment → receiver email | Customer email | Yes |
| Shipment → receiver name | Customer name | Yes |
| Shipment → receiver address | Street address | Yes |
| Shipment → receiver city | City | Yes |
| Shipment → receiver postal code | Postal code | Yes |
| Shipment → receiver country | Country (ISO alpha-2) | Yes |
| Cost center | Market code | No |
| Delivery Note line → product ID | Product ID | Yes |
| Delivery Note line → article name | Product name | Yes |
| Delivery Note line → quantity | Quantity | Yes |
| Delivery Note line → price | Net amount | No |
| Delivery Note line → currency | Currency | No |
Delivery Note line → articleThumbnailUrl | Thumbnail image | No |
Delivery Note line → articleImageUrls | Product images | No |
If a shipment fails to import
In most cases, shipments are pushed to Returns automatically when they reach LABL status. If a shipment does not appear in Returns, it may be due to missing article data or a cost center that doesn't match a Returns market.
nShift Support can investigate and manually re-trigger the import if needed. To do so, the shipment status in Transsmart must be reset and re-progressed — this is handled by nShift and is not something you need to do yourself.
If you notice a shipment is missing from Returns, contact nShift Support with the order reference and we'll look into it.