Inhoud in dit artikel:

1. Ophalen van carriers
2. Ophalen van kostenplaatsen
3. Incoterms
4. Mail types
5. Packages
6. Service Level Times
7. Service Level Others
8. Booking Profiles
9. Accountinformatie

Er zijn verschillende settings gekoppeld aan een account. Al deze settings kunnen worden opgehaald via een GET-functie en gebruikt worden in een booking request. Deze settings kunnen ook worden ingesteld in je bronsysteem om te worden gebruikt voor boekingen of andere acties. Je haalt Transsmart-codes en beschrijvingen op. Deze codes kunnen worden gekoppeld aan parameters in je bronsysteem. Deze parameters in je systeem kunnen vervolgens worden gebruikt voor het genereren van een Transsmart-boeking.

1 Ophalen van carriers

Al je geconfigureerde carriers kunnen worden opgehaald via een GET-functie naar het volgende pad:

/v2/accounts/{account}/listsettings/carriers

Je ontvangt een lijst van alle geconfigureerde vervoerders, hun codes die worden gebruikt in een boeking voor Transsmart en een description van de vervoerder.

2 Ophalen kostenplaatsen

Transsmart maakt gebruik van kostenplaatsen. Deze kostenplaatsen kunnen voor verschillende doeleinden worden gebruikt, zoals boeken op verschillende accounts, het toepassen van specifieke business rules die zijn ingesteld in Transsmart of het activeren van een andere afzender, enzovoort. Je contactpersoon bij Transsmart kan meer uitleg geven over het gebruik van een kostenplaats en de bijbehorende logica die kan worden geactiveerd.

Je kunt de beschikbare kostenplaatsen ophalen via:

/v2/accounts/{account}/listsettings/costCenters

Je ontvangt een lijst met beschikbare kostenplaatsen en hun omschrijvingen.

3 Incoterms

Incoterms zijn settings die een overeenkomst vormen tussen een afzender en een ontvanger. Dit zijn wereldwijde afspraken die de overdracht en verantwoordelijkheid voor de goederen verduidelijken. Een zending wordt altijd geboekt met een incoterm. Meer informatie over incoterms is hier te vinden: https://iccwbo.org/business-solutions/incoterms-rules/incoterms-2020/ 

Transsmart heeft standaard een lijst met alle 2020-incoterms. Een klant kan in de settings bepalen welke incoterms beschikbaar zijn voor boeking. Deze kunnen worden opgehaald via:

/v2/accounts/{account}/listsettings/incoterms

Je ontvangt een lijst met een code en een description. 

4 Mail types

Mail types kunnen worden gebruikt om verschillende soorten e-mails te versturen nadat een zending is geboekt. Uw Transsmart contactpersoon kan u helpen met de definitie en de configuratie van de e-mails. Op basis van de verschillende mail types kan een opvolgende e-mail worden getriggerd om te worden verzonden naar de verschillende e-mailadressen die in de boeking kunnen worden ingesteld. 
U kunt de verschillende e-mail types die voor uw account zijn geconfigureerd, opvragen:

/v2/accounts/{account}/listsettings/mailTypes

U ontvangt een lijst met een code en een description.

5 Packages

Packages kunnen vooraf op het account worden gedefinieerd. De vooraf gedefinieerde packages in Transsmart stellen u in staat deze te koppelen aan de package types in uw bronsysteem. Zelfs als het bronsysteem niet in staat is de afmetingen van de packages te beheren, kunnen deze worden opgehaald uit de Transsmart database en gebruikt worden in een boeking via de call:

/v2/accounts/{account}/listsettings/packages

U ontvangt een lijst met een code, description, unit of measures en measurements.

6 Service Level Times

Verschillende carriers hebben verschillende service levels. Een service level is een voorwaarde waaronder de aflevering van een zending plaatsvindt. Het is een dienst die door een carrier wordt aangeboden waarbij de klant en de carrier overeenstemming bereiken over de voorwaarden die van toepassing zijn. Uw Transsmart contactpersoon zal in het vooronderzoek bepalen welke service levels moeten worden geconfigureerd. U kunt een lijst met alle geconfigureerde service levels ophalen via:

/v2/accounts/{account}/listsettings/serviceLevelTimes

U ontvangt een lijst met een code en een description.

7 Service Level Others

Naast servicelevels zijn er servicelevel-toevoegingen. Een voorbeeld hiervan is de betaling aan de vervoerder bij aflevering van de goederen. Dit wordt COD (cash on delivery) genoemd, of handtekeningen die door de geadresseerde moeten worden gezet. Deze toevoegingen worden serviceLevelOther(s) genoemd in de Transsmart-database en verschillen per vervoerder. Je Transsmart-contactpersoon moet deze voor je configureren en zodra ze zijn geconfigureerd kun je de opties ophalen via onderstaande call:

/v2/accounts/{account}/listsettings/serviceLevelOthers

Je ontvangt een lijst met een code en een description.

8 Boekingsprofielen

Boekingsprofielen kunnen worden geconfigureerd om het boeken eenvoudiger te maken. Een boekingsprofiel bestaat uit een combinatie van de settings: carrier, serviceLevelTime, serviceLevelOther, incoterms, costCenter en mailType. Met een profiel is het mogelijk de mogelijke settings op te halen op basis van een code en een description. Deze settings kunnen vervolgens worden gebruikt voor de boeking. Een boekingsprofiel kan worden gekoppeld aan een verzendmethode in je bronsysteem. Met deze code kunnen de 6 settings die in de boeking moeten worden gebruikt, worden opgehaald. Het pad voor de beschikbare boekingsprofielen is:

/v2/accounts/{account}/listsettings/bookingProfiles

Je ontvangt een lijst met een code, description, carrier, serviceLevelTime, serviceLevelOther, incoterms, costCenter en mailType.

9 Accountinformatie

Accounts worden gebruikt om zendingen op te boeken. Een account kan een of meer subaccounts hebben. Meer informatie is hier te vinden: https://devdocs.transsmart.com/#_accounts_hierarchy 

Het pad voor de beschikbare accounts is:

/v2/accounts/{account}/structure

U ontvangt een lijst met een accountCode, accountName, organizationCode en subAccounts