Zielgruppe
Diese technischen Informationen richten sich an Software-Entwickler und IT-Manager,
die einen Einsatz unserer WebServices planen. Für Rückfragen oder Unterstützung
stehen wir Ihnen gerne zur Verfügung. Nutzen Sie hierfür bitte unser
Kontaktformular.
Funktionsweise
Der TCDlg WebService bedient das Internet-Einbuchungssystem von Toll Collect voll automatisch.
Das System wird gesteuert durch wenige Aufrufe, die über SOAP Webrequests an unseren Server
über das Internet gesendet werden.
Die Einrichtung eines Kundenkontos bei SMS-Projects ist hierfür erforderlich. Je nach vertraglicher
Vereinbarung kann die Abrechnung der Maut entweder über Ihr Toll Collect Konto laufen, oder über
SMS-Projects abgewickelt werden (z.B. per Guthaben oder Kreditkartenbelastung). Die Registrierung
eines Kundenkontos kann in der
Kundenverwaltung
vorgenommen werden. Eine Freischaltung für die Nutzung des Webservice erfolgt durch unseren HelpDesk.
Unser Webservice ist über die Adresse "https://ssl.sms-maut.de/tcdlg.asmx" erreichbar. Fügen Sie
die Funktionen unter diesem Link als Web Reference in Ihrer Entwicklungsumgebung hinzu.
... zum TCDlg Webdienst ...
Dialogabfolge
Führen Sie den Dialog in der nachfolgend aufgeführten Abfolge durch. Für die Liste der benötigten
Parameter klicken Sie bitte auf der Startseite (https://ssl.sms-maut.de/tcdlg.asmx) auf den Link
für die jeweilige Funktion.
| Schritt |
Funktion |
Beschreibung |
| |
 |
Buchen eines Tickets mit frei erstellter Route |
| 1. |
OpenDlg |
Eröffnet eine Sitzung für einen neuen Dialog. |
| 2. |
SetTicket |
Allgemeine Ticket-Parameter setzen. |
| 3. |
SetFzg |
Fahrzeugdaten setzen. |
| 4. |
SetRoute |
Streckendaten setzen. |
| |
|
|
| 5. |
|
Dialog bis zur Ermittlung von Route und Preis |
| 5.1.1 |
PreAdhocRouteBooking |
Toll Collect Dialoge ausführen bis zur Ermittlung aller Werte. |
| 5.1.2 |
PostRouteBooking |
Bestätigung der Werte aus Schritt 5.1.1 |
| |
|
|
| 5. |
- alternativ - |
Dialog mit vollständiger Buchung |
| 5.2.1 |
AdhocRouteBooking |
Ausführung der Schritte 5.1.1 und 5.1.2 |
| 6. |
Close |
Ende des Dialogs. Freigabe aller zugeordneten Ressourcen. |
| |
|
Buchen eines Tickets mit Toll Collect
Standardroute |
| 1. - 3. |
|
wie vor |
| 4. |
SetValue("route", route) |
Toll Collect Standardroute setzen. |
| 5. |
|
Dialog bis zur Ermittlung von Route und
Preis |
| 5.2.1 |
PreStandardRouteBooking |
Toll Collect Dialoge mit Wahl einer Toll Collect Standardroute
bis zur Ermittlung aller Werte. |
| 5.2.2 |
PostRouteBooking |
(siehe oben) |
| |
|
|
| 5. |
- alternativ - |
Dialog mit vollständiger Buchung |
| 5.2.1 |
StandardRouteBooking |
Ausführung der Schritte 5.2.1 und 5.2.2 |
| 6. |
Close |
(siehe oben) |
| |
|
Stornieren eines Tickets |
| 1. |
OpenDlg |
(siehe oben) |
| 2. |
CancelBooking |
Toll Collect Dialoge mit Storno einer angegebenen
Buchungsnummer. |
| 3. |
Close |
(siehe oben) |
| |
|
Testen eines Toll Collect Logins |
| |
TestLogin |
Login bei Toll Collect mit TC Login-Name und -Passwort ausführen. |