1. Johdanto
Alla on lyhyt johdantoteksti käytettävissä olevista integraatio-ominaisuuksista. Yhteyshenkilösi lähettää sinulle käyttäjätunnuksen, salasanan ja customerID-tunnuksen käytettäväksi kutakin näistä integraatioalustoista varten (MyTranssmart + API/websvc). Löydät aina URL-osoitteen käyttäjähyväksyntäympäristöön -ACCEPT- ja tuotantoon -PROD. Molemmat ympäristöt ovat täysin erillisiä määritysten ja käytettävissä olevien kuljetusliikkeiden osalta. Ota yhteyttä nimettyyn yhteyshenkilöösi saadaksesi lisätietoja omasta tilanteestasi.
2. MyTranssmart
Tämä on portaali, jossa voit tarkastella kaikkia lähetyksiäsi ja niiden tilaa. Voit käyttää tätä portaalia vahvistaaksesi, että lähetät tiedot oikealla tavalla.
| Environment | URL |
| ACCEPT | https://accept-my.transsmart.com |
| PROD | https://my.transsmart.com |
3. Integraatio-ominaisuudet
3.1 API
Transsmart API:ta voidaan käyttää integraatioon json- tai xml-rajapinnan kautta.
| Environment | URL |
| ACCEPT | https://accept-api.transsmart.com/v2/ |
| PROD | https://api.transsmart.com/v2/ |
Kehittäjädokumentaatio on julkisesti saatavilla ja aina synkronissa kunkin ympäristön käytettävissä olevien ominaisuuksien kanssa. Tarkemmin: jos olemme julkaisseet uusia ominaisuuksia ympäristössä ACCEPT, vastaava kehittäjädokumentaatio päivitetään vastaavasti, mutta kyseisen uuden ominaisuuden description ei sisällytetä ympäristön PROD devdocs‑dokumentaatioon.
| Environment | URL |
| ACCEPT | https://accept-devdocs.transsmart.com/ |
| PROD | https://devdocs.transsmart.com/ |
API tukee DHL- ja UPS-sijaintivalitsimien käyttöä.
3.2 Webservices
Joillakin järjestelmillä on ongelmia muodostaa yhteyttä API-rajapintaan. Näille järjestelmille on saatavilla webservices-päätepiste.
| Environment | URL |
| ACCEPT | https://accept-connect.transsmart.com/TboxService/2_0 |
| PROD | https://connect.transsmart.com/TboxService/2_0 |
Voit hakea webservice-määrityksen lisäämällä ?wsdl perus-URL-osoitteen loppuun:
https://accept-connect.transsmart.com/TboxService/2_0?wsdl
https://connect.transsmart.com/TboxService/2_0?wsdl
Webservicejä käytettäessä ei ole tukea sijainnin valitsimien integroimiselle.
4. Dokumentaatio
Kaikista dokumenteista uusin versio on saatavilla täältä:
https://devdocs.transsmart.com
Tämä verkkosivusto on ensisijaisesti omistettu API-integraatio-ominaisuuksille, mutta löydät sieltä luvun, joka on omistettu SOAP webservice -palvelulle, josta voit ladata dokumentaation uusimman version.
Kehityksesi nopean aloittamisen tueksi olemme luoneet Postman-paketin, jonka avulla saat käsityksen siitä, miltä API-vuorovaikutus näyttää. Voit ladata paketin viimeisimmän version täältä:
https://postman.transsmart.com
PS: Web-palveluja käytettäessä ei ole tukea noutopistevalitsimien integroinnille.
5. Kuinka testata integrointisi
Saamasi käyttäjätunnus/salasana on yhdistetty demotiliin ACCOUNT-ympäristössä. Olemme määrittäneet tämän tilin toimimaan kahden kuljetusliikkeen ja erilaisten palvelutasojen kanssa.
1. UPS, vain yhdessä hollantilaisten toimitusosoitteiden kanssa
- EXPEDITED
- EXPRESS
- SAVER
- STANDARD
2. DHP (DHL Parcel), vain toimitusosoitteille Belgiassa tai Alankomaissa
- EUROPLUS
- EXPRESSER
Voit testata Transsmart-asiakirjamoottoria käyttämällä DHP – EUROPLUS -palvelua. Siinä tapauksessa tulostetaan myös CMR-asiakirja ZPL-osoitekortin lisäksi, jonka tulostamme muita palvelutasoja varten.
6. Tietoturva
Transsmart-alusta on käytettävissä vain https-yhteyden (portti 443) kautta. Käytämme Comodon myöntämää SSL-varmennetta. Varmista, että järjestelmäsi tukee Comodon intermediate- ja root CA -varmenteita.