A new version of the 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 -webservice endpoint- there is only one situation described below that will influence your connection. This change will not affect your use of Transsmart. Whether you link with Transsmart from a standard enterprise application (ERP / WMS) or have custom-built for the integration, the exchange of information will be processed exactly the same way after the update.
The only exception is: some enterprise applications do a hard check on the exact content of the wsdl.
If the wsdl changes without preparation for this change, it will cause an error message in the customer's system and will cause shipments to fail booking. As far as we know, the change of the wsdl is not an issue for these source systems: Exact Online, Magento2, AFAS Profit 7, NAV ShipIt 4, Microsign. For all other source systems, we recommend that you contact your system administrator to verify if a hard check on the wsdl is done and if this will have an impact on the integration.
The check can be done on our beta and/or acceptance environments 3 weeks before going to production; the new wsdl will be activated on our environments at the following times:
- beta : Monday October 16th 2023
- acceptance : Monday October 16th 2023
- production : Monday October 23rd 2023
At October 16th 2023 via the URL https://beta-connect.transsmart.com/TboxService/2_0?wsdl or https://accept-connect.transsmart.com/TboxService/2_0?wsdl you will find the new version of the wsdl.
Note: this change will also be done in the API and MyTranssmart but this is currently planned one week later, so in week 44.
Changes to the wsdl:
Two new fields will be added to the Delivery Note Line:
Field: | articleThumbnailUrl |
Content: | one URL |
Example value: | http://123.com/image1.jpg |
Field: | articleImageUrls |
Content: | array of one or more URLs |
Example value: | http://123.com/image2.jpg,http://123.com/image3.jpg |
XML example:
<deliveryNoteInfo>
<deliveryNoteLines>
<deliveryNoteLine>
<deliveryNoteId>12345</deliveryNoteId>
<lineNo>1</lineNo>
<quantity>1</quantity>
<articleThumbnailUrl>http://123.com/image1.jpg</articleThumbnailUrl>
<articleImageUrls>
<url>http://123.com/image2.jpg</url>
<url>http://123.com/image3.jpg</url>
</articleImageUrls>
</deliveryNoteLine>
</deliveryNoteLines>
</deliveryNoteInfo>
3 comments
The deployment to Beta and Accept has been postponed. The message has been updated containing new dates. Also the XML example has been updated.
Monday 16-Oct 2023, we have deployed the new wsdl to our Beta and Accept environment.
Next week, Monday 23-Oct 2023, we will deploy the new wsdl to our Production environment.
Today, Monday 23-Oct 2023, we have deployed the new wsdl to our Production environment.
Note: the 2 fields will also become available via the API and via the MyTranssmart dashboard.
The API change is planned for 31-Oct 2023.
The MyTranssmart change is planned later this year.
Once available, it will be mentioned in the release notes.