Inhalt dieses Artikels:

1. Abfrage von Carriern
2. Abfrage von Kostenstellen
3. Incoterms
4. Mail-Typen
5. Pakete
6. Service Level Zeiten
7. Service Level Sonstige
8. Buchungsprofile
9. Kontoinformationen

Es gibt mehrere settings, die zu einem Konto gehören. Alle diese settings können über eine GET-Funktion abgerufen und in einer Buchungsanfrage verwendet werden. Diese settings können auch in Ihrem Quellsystem gesetzt werden, um sie für Buchungen oder andere Aktionen zu nutzen. Sie erhalten Transsmart-Codes und Beschreibungen. Diese Codes können mit Parametern in Ihrem Quellsystem verknüpft werden. Diese Parameter in Ihrem System können dann für die Erstellung einer Transsmart-Buchung verwendet werden.

1 Abfrage von Carriern

Alle Ihre konfigurierten Carrier können über eine GET-Funktion auf dem folgenden Pfad abgerufen werden:

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

Sie erhalten eine Liste aller konfigurierten Frachtführer, deren Codes, die in einer Buchung für Transsmart verwendet werden, sowie ein description des Frachtführers.

2 Kostenstellenabfrage

Transsmart verwendet Kostenstellen. Diese Kostenstellen können für verschiedene Zwecke genutzt werden, z. B. für Buchungen auf unterschiedlichen Konten, zur Umsetzung spezifischer in Transsmart definierter Geschäftsregeln oder zur Aktivierung eines anderen Absenders usw. Ihre/Ihr Transsmart-Ansprechperson kann Ihnen mehr über die Verwendung einer Kostenstelle und die nachgelagerte Logik, die ausgelöst werden kann, erklären.

Sie können die verfügbaren Kostenstellen abrufen über:

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

Sie erhalten eine Liste der verfügbaren Kostenstellen und ihrer Beschreibungen.

3 Incoterms

Incoterms sind settings, die eine Vereinbarung zwischen einem Absender und einem Empfänger darstellen. Es handelt sich um globale Vereinbarungen, die die Übergabe und Verantwortlichkeit für die Ware klar regeln. Eine Sendung wird immer mit einem Incoterm gebucht. Weitere Informationen zu Incoterms finden Sie hier: https://iccwbo.org/business-solutions/incoterms-rules/incoterms-2020/ 

Transsmart verfügt standardmäßig über eine Liste aller Incoterms 2020. Ein Kunde kann im settings festlegen, welche Incoterms für Buchungen verfügbar sind. Diese können abgerufen werden über:

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

Sie erhalten eine Liste mit einem Code und einem description. 

4 Mailtypen

Mailtypen können verwendet werden, um unterschiedliche Arten von E-Mails zu versenden, nachdem eine Sendung gebucht wurde. Ihre Transsmart-Ansprechperson kann Sie bei der Definition und Konfiguration der E-Mails unterstützen. Auf Basis der unterschiedlichen Mailtypen kann eine nachgelagerte E-Mail ausgelöst werden, die an verschiedene E-Mail-Adressen gesendet wird, welche in der Buchung hinterlegt werden können. 
Sie können die verschiedenen für Ihr Konto konfigurierten E-Mail-Typen abrufen:

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

Sie erhalten eine Liste mit einem Code und einem description.

5 Packstücke

Packstücke können für das Konto vordefiniert werden. Die vordefinierten Packstücke in Transsmart ermöglichen es Ihnen, diese mit den Pakettypen in Ihrem Quellsystem abzugleichen. Selbst wenn das Quellsystem nicht in der Lage ist, die Abmessungen der Packstücke zu verwalten, können diese aus der Transsmart-Datenbank abgerufen und in einer Buchung über folgenden Aufruf verwendet werden:

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

Sie erhalten eine Liste mit einem Code, description, Maßeinheiten und Abmessungen.

6 Service Level Times

Verschiedene Carrier haben unterschiedliche Service Level. Ein Service Level ist eine Bedingung, unter der die Zustellung einer Sendung erfolgt. Es handelt sich um eine von einem Carrier angebotene Dienstleistung, bei der sich Kunde und Carrier auf die geltenden Geschäftsbedingungen einigen. Ihre Transsmart-Ansprechperson legt in der Voruntersuchung fest, welche Service Level konfiguriert werden sollen. Sie können eine Liste aller konfigurierten Service Level abrufen über:

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

Sie erhalten eine Liste mit einem Code und einem description.

7 Service Level Others

Neben Service Levels gibt es Service-Level-Ergänzungen. Ein Beispiel ist die Zahlung an den Frachtführer bei der Zustellung der Ware. Dies wird COD (cash on delivery) genannt oder Unterschriften, die vom Empfänger geleistet werden müssen. Diese Ergänzungen werden in der Transsmart Datenbank serviceLevelOther(s) genannt und unterscheiden sich je nach Frachtführer. Ihre Transsmart Ansprechperson muss diese für Sie konfigurieren, und sobald sie konfiguriert sind, können Sie die Optionen über den folgenden Aufruf abrufen:

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

Sie erhalten eine Liste mit einem Code und einem description.

8 Booking Profiles

Booking Profiles können konfiguriert werden, um das Buchen zu erleichtern. Ein Booking Profile besteht aus einer Kombination der settings: carrier, serviceLevelTime, serviceLevelOther, incoterms, costCenter und mailType. Mit einem Profil ist es möglich, die möglichen settings basierend auf einem Code und einem description abzurufen. Diese settings können dann für die Buchung verwendet werden. Ein Booking Profile kann in Ihrem Quellsystem mit einer Versandmethode verknüpft werden. Mit diesem Code können die 6 settings, die in der Buchung verwendet werden sollen, abgerufen werden. Der Pfad für die verfügbaren Booking Profiles ist:

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

Sie erhalten eine Liste mit einem Code, description, carrier, serviceLevelTime, serviceLevelOther, incoterms, costCenter und mailType.

9 Account information

Accounts werden verwendet, um Sendungen zu buchen. Ein Account kann ein oder mehrere Subaccounts haben. Weitere Informationen finden Sie hier: https://devdocs.transsmart.com/#_accounts_hierarchy 

Der Pfad für die verfügbaren Accounts ist:

/v2/accounts/{account}/structure

Sie erhalten eine Liste mit einem accountCode, accountName, organizationCode und subAccounts.