1. Inleiding
Hieronder staat een korte inleidende tekst over de beschikbare functies voor integratie. Uw contactpersoon stuurt u de gebruikersnaam, het wachtwoord en de customerID die u voor elk van deze integratieplatforms kunt gebruiken (MyTranssmart + API/websvc). U vindt altijd een URL voor de gebruikersacceptatieomgeving -ACCEPT- en voor productie -PROD. Beide omgevingen zijn volledig gescheiden wat betreft configuratie en beschikbare vervoerders. Neem contact op met uw toegewezen contactpersoon voor meer informatie over uw specifieke situatie.
2. MyTranssmart
Dit is de portal waar u al uw zendingen en de bijbehorende status kunt bekijken. U kunt deze portal gebruiken om te bevestigen dat u de gegevens op de juiste manier verzendt.
| Environment | URL |
| ACCEPT | https://accept-my.transsmart.com |
| PROD | https://my.transsmart.com |
3. Integratiefuncties
3.1 API
De Transsmart API kan worden gebruikt voor integratie via json of xml.
| Environment | URL |
| ACCEPT | https://accept-api.transsmart.com/v2/ |
| PROD | https://api.transsmart.com/v2/ |
De ontwikkelaarsdocumentatie is openbaar beschikbaar en altijd gesynchroniseerd met de beschikbare functionaliteiten in de betreffende omgeving. Meer specifiek: als we nieuwe functionaliteiten hebben uitgebracht in ACCEPT, wordt de bijbehorende ontwikkelaarsdocumentatie dienovereenkomstig bijgewerkt, de description van die nieuwe functionaliteit zal niet worden opgenomen in de PROD devdocs.
| Environment | URL |
| ACCEPT | https://accept-devdocs.transsmart.com/ |
| PROD | https://devdocs.transsmart.com/ |
De API ondersteunt het gebruik van de DHL- en UPS-locatiekiezers.
3.2 Webservices
Sommige systemen hebben problemen met het verbinden met een API-interface. Voor die systemen is er een webservices-endpoint beschikbaar.
| Environment | URL |
| ACCEPT | https://accept-connect.transsmart.com/TboxService/2_0 |
| PROD | https://connect.transsmart.com/TboxService/2_0 |
U kunt de webservicedefinitie ophalen door ?wsdl toe te voegen aan het einde van de basis-URL:
https://accept-connect.transsmart.com/TboxService/2_0?wsdl
https://connect.transsmart.com/TboxService/2_0?wsdl
Er is geen ondersteuning voor het integreren van locatie-selectors bij gebruik van de webservices.
4. Documentatie
De meest recente versie van alle documentatie is hier beschikbaar:
https://devdocs.transsmart.com
Deze website is voornamelijk gericht op de API-integratiefuncties, maar u vindt er een hoofdstuk dat is gewijd aan de SOAP-webservice waar u de meest recente versie van de documentatie kunt downloaden.
Om uw ontwikkeling te versnellen, hebben we een Postman-pakket gemaakt om u te helpen een idee te krijgen van hoe de API-interactie eruitziet. U kunt de nieuwste versie van het pakket hier downloaden:
https://postman.transsmart.com
PS : Er is geen ondersteuning voor het integreren van locatie-selectors bij gebruik van de webservices.
5. Hoe u uw integratie kunt testen
De gebruikersnaam / het wachtwoord dat u heeft ontvangen, is gekoppeld aan een demoaccount in de ACCOUNT-omgeving. We hebben dit account ingericht om te kunnen werken met 2 vervoerders en verschillende serviceniveaus
1. UPS, alleen in combinatie met Nederlandse verzendadressen
- EXPEDITED
- EXPRESS
- SAVER
- STANDARD
2. DHP (DHL Parcel), alleen voor verzendadressen in België of Nederland
- EUROPLUS
- EXPRESSER
U kunt de Transsmart-documentengine testen met DHP – EUROPLUS. In dat geval wordt er naast het ZPL-label dat we voor de andere serviceniveaus afdrukken, ook een CMR-document geprint.
6. Beveiliging
Het Transsmart-platform is alleen beschikbaar via https (poort 443). We gebruiken een SSL-certificaat dat wordt verstrekt door Comodo. Zorg ervoor dat uw systeem de intermediate- en root-CA-certificaten van Comodo ondersteunt.