1. Introduction
Below is a short introductory text on the available features for integration. Your contact person will send you the user name, password and customerID to use for each of these integration platforms (MyTranssmart + API/websvc). You will always find a URL for the user acceptance environment -ACCEPT- and for production -PROD. Both environments are completely separate in terms of configuration and available carriers. Please speak to your assigned contact person for more information about your specific situation. In case of technical questions you can always write an email to it@transsmart.com.
2. MyTranssmart
This is the portal where you can view all your shipments and their respective status. You can use this portal to get confirmation that you are sending the data in the right way.
Environment | URL |
ACCEPT | https://accept-my.transsmart.com |
PROD | https://my.transsmart.com |
3. Integration features
3.1 API
The Transsmart API can be used for integration via json or xml.
Environment | URL |
ACCEPT | https://accept-api.transsmart.com/v2/ |
PROD | https://api.transsmart.com/v2/ |
The developer documentation is publicly available and always in-sync with the available features in the respective environment. More specifically: if we have released new features in ACCEPT, the corresponding developer documentation will be updated accordingly, the description of that new feature will not be included in the PROD devdocs.
Environment | URL |
ACCEPT | https://accept-devdocs.transsmart.com/ |
PROD | https://devdocs.transsmart.com/ |
The API support the usage of the DHL and UPS location selectors.
3.2 Webservices
Some systems have issues connecting to an API interface. For those systems there is a webservices endpoint available.
Environment | URL |
ACCEPT | https://accept-connect.transsmart.com/TboxService/2_0 |
PROD | https://connect.transsmart.com/TboxService/2_0 |
You can retrieve the webservice definition by adding ?wsdl at the end of the base url:
https://accept-connect.transsmart.com/TboxService/2_0?wsdl
https://connect.transsmart.com/TboxService/2_0?wsdl
There is no support for integrating location selectors when using the webservices.
4. Documentation
The most recent version of all documentation is available here:
https://devdocs.transsmart.com
This website is primarily dedicated to the API integration features, but you will find a chapter dedicated to the SOAP webservice where you can download the most recent version of the documentation.
To kick-start your development, we have created a Postman package to help you get a feel of what the API interaction looks like. You can download the latest version of the package here:
https://postman.transsmart.com
PS : There is no support for integrating location selectors when using the webservices.
5. How to test your integration
The user name / password you received is linked to a demo account in the ACCOUNT environment. We have set up this account to support working with 2 carriers and different service levels
1. UPS, only in combination with Dutch shipping addresses
- EXPEDITED
- EXPRESS
- SAVER
- STANDARD
2. DHP (DHL Parcel), only for shipping addresses in Belgium or The Netherlands
- EUROPLUS
- EXPRESSER
You can test the Transsmart document engine by using DHP – EUROPLUS. In that case a CMR document is also printed, in addition to the ZPL label that we print for the other service levels.
6. Security
The Transsmart platform is only available via https (port 443). We use a SSL certificate provided by Comodo. Make sure your system supports the intermediate and root CA certificates from Comodo.