A new version of the nShift Transsmart Webservice WSDL definition will become available and we would like to inform you about the possible impact and deployment schedule of this change.
Note: If you connect via our REST API, also known as APIv2, or the MyTranssmart dashboard, this change has no impact.
If you connect via our WSDL web service endpoint, only one scenario could impact your connection. The update will not affect how you use nShift Transsmart. Whether you integrate from a standard enterprise application (ERP/WMS) or have a custom-built solution, the exchange of information will remain unchanged.
The scenario to be aware of
Some enterprise systems perform a hard check on the exact content of the WSDL. If the WSDL changes and your system is not prepared, it will cause errors and prevent shipment bookings. Based on our knowledge, the following systems are not affected: Exact Online, Magento2, AFAS Profit 7, NAV ShipIt 4, Microsign. For all other source systems, please contact your system administrator to confirm whether a hard check on the WSDL is performed and if it could affect your integration.
The check can be done on our acceptance environments two weeks before going to production. The new WSDL will be activated on our environments at the following times:
- Beta: Tuesday, January 14th 2025
- Acceptance: Tuesday, January 14th 2025
- Production: Monday, January 27th 2025
You can find the new version of the WSDL here:
- https://beta-connect.transsmart.com/TboxService/2_0?wsdl
- https://accept-connect.transsmart.com/TboxService/2_0?wsdl
Note: This change will also be done in the API and MyTranssmart on Monday, January 27th, 2025 to Acceptance and Tuesday, January 28th, 2025 to Production and will be mentioned via the regular release notes.
Changes to the WSDL in the deliveryNoteLines section:
| Field name | Type | Example |
| Returnable |
boolean: |
<n2:returnable>true</n2:returnable> |
| Attributes |
list with strings: |
<n2:attributes> <n2:attribute> <n2:name>Colour</n2:name> <n2:value>Blue</n2:value> </n2:attribute> <n2:attribute> <n2:name>Size</n2:name> <n2:value>XXL</n2:value> </n2:attribute> </n2:attributes> |
Background
We have an integration with nShift Returns and when sending shipment data from nShift Transsmart to nShift Returns, we need the possibility to specify whether a product should be returnable or not. For instance, customized products usually cannot be returned. Additionally, we must be able to provide detailed product properties/specifications such as colour or size, to make it easier for consumers to select the correct product they wish to return in the Returns platform.