Telematics Portal & App
Ihre Daten stets im Blick
Durch eine übersichtliche Darstellung der Fahrzeugdaten im KRONE-Telematics-Portal behalten Sie als Disponent stets den Überblick. Sie haben die Möglichkeit, sich neben dem Fahrzeugstandort diverse Daten aus dem EBS-System und der TPMS-Sensorik anzeigen zu lassen. Zudem können Sie eigenständig Alarme verwalten und Geozonen einrichten. So werden Sie beispielsweise direkt informiert, wenn Ihr Fahrzeug den vorher definierten Zielort erreicht. Auch diverse Reportingfunktionen stehen im KRONE-Telematics-Portal zur Verfügung – selbstverständlich nicht nur online, sondern als Exportdatei in Ihr gewünschtes Dateiformat.
Datenschnittstelle API
Allgemeine Informationen
Der Externe Push dient der Datenausleitung von Telematikdaten aus dem KRONE System, um diese in anderen Systemen und Kontexten verfügbar machen zu können.
Unter Externe Freigaben kann eine Freigabe angelegt werden. Bei dieser können Zeitraum, Push Package (die zu teilenden Felder), Provider und zu teilende Fahrzeuge definiert werden.
Um einen Provider anlegen zu können, wird der Endpunkt (URI) benötigt, an den die Daten gepusht werden sollen, sowie ggf. die Authentifizierungsdaten die benötigt werden, um sich gegenüber dem System des Providers zu authentifizieren.
Ablauf und Logik
Der Service sendet einen HTTP-Post-Request, wie er im /ok Endpunkt in der externalpush.json beschrieben wird, an die angegebene URI, die beim Anlegen des Providers hinterlegt wurde. Dabei findet kein SSL-Handshake für jedes gesendete Paket statt. Als Authentifizierung wird das Passwort SHA-256 gehashed zusammen mit dem Usernamen mit base64 encodiert.
Pakete, die nicht zugestellt werden können, werden vom Service in einer Backup-Queue abgelegt, um sie zu einem späteren Zeitpunkt erneut zu pushen. Sollte es 3 Tage keinen erfolgreichen Sendeversuch eines Datensatzes des Sharings geben, wird der Status des gesamten Sharings von “RUNNING“ auf “ERROR“ geändert und so das Sharing deaktiviert.
Um einen reibungslosen Ablauf zu gewährleisten, müssen die Responses des Kundensystems der im Rahmen der technischen Dokumentation (Swagger-Dokumentation) als Format definierten Response entsprechen, da die Responses nur dann für das KRONE-System interpretierbar sind.
Eine nicht interpretierbare Response oder keine Response wird systemseitig als Fehler bei der Datenannahme gewertet. Die Datenpakete werden dann in eine Backup-Queue verschoben und bei nächster Möglichkeit nachgesendet. Sollte dies nach 3 Tagen immer noch misslingen, wird der Push auf "STOPPED" gesetzt. Sobald ein Push den Status STOPPED hat, egal ob durch ausbleibenden Sendeerfolg oder durch ein manuelles Stoppen durch den Kunden selbst, oder in seinem Auftrag, werden die Daten nicht mehr gesammelt und können folglich ebenfalls nicht mehr nachgesendet werden.
Sonstiges (Developer/Provider)
Der nachfolgenden technischen Dokumentation kann entnommen werden, wie die Daten aufgebaut sind, die an den Kunden gesendet werden (RequestBody).
Das data Objekt im RequestBody enthält eine Kunden-ID (externalCustomerIdentification), die als Identifier für das Sharing fungiert und genutzt werden kann, um das Sharing eindeutig zu identifizieren. Zudem gibt es im RequestBody 2 Freifelder (specificFields), die mit kundenspezifischen IDs oder anderen relevanten Informationen befüllt werden können. Diese frei definierbaren Felder können allerdings nur auf globaler Ebene, also für alle Fahrzeuge, definiert werden. Eine Definition auf Fahrzeugebene ist nicht vorgesehen. Darüber hinaus beinhaltet das data Objekt die Fahrzeugdaten (boxdata).
Die Verarbeitung der Daten und das Analysieren der spezifischen Datenpakete liegt in der Verantwortung des Empfängers. Die Datensätze werden bei uns im Voraus aufbereitet, so dass keine leeren Felder enthalten sind. Die Datensätze können aber, neben einigen Pflichtfeldern, voneinander abweichen, da Parameter ohne Ausprägung nicht gepusht werden.
OpenApi Spec/Swagger
Die angegebenen Daten im Boxdata Schema in der OpenAPI Spec enthalten nur ein kleines Beispiel der Boxdata-Felder, da die mitgeschickten Boxdaten Felder in der Praxis stark variieren werden. Es wird niemals dazu kommen, dass alle möglichen Felder befüllt und geschickt werden. Das Beispiel soll dazu dienen den Aufbau und die Strukturierung des Datenmodells zu verstehen.
Datenerweiterung und führender Identifier in mykrone.blue
Mit der neuen Plattform mykrone.blue werden die Fahrzeugdaten um zusätzliche Felder erweitert. Diese Felder ergänzen den bisherigen Datensatz aus dem KRONE Telematics Portal.
Neue Felder im Objekt vehicle
- VH_ILU_CODE: ILU-Code des Fahrzeugs (Intermodal Loading Unit)
- VH_LICENSE_PLATE: amtliches Kennzeichen
- VH_EQN: Equipment-Nummer
- VH_VIN: Fahrzeug-Identifikationsnummer (VIN)
- VH_FLEET_NUMBER: Flottenbezeichnung
Führender Identifier: VIN
KRONE empfiehlt, VH_VIN als führenden Identifier zu verwenden. Die VIN eignet sich zur eindeutigen Zuordnung von Fahrzeugen, zur Deduplizierung von Datensätzen und zur Verknüpfung über Systeme hinweg. Die übrigen Kennungen ergänzen die VIN als Attribute, sollten aber nicht als alleiniger Schlüssel dienen, da Kennzeichen und Flottenbezeichnungen sich ändern können.
Verfügbarkeit
Die erweiterten Felder werden nur übermittelt, wenn der Kunde mykrone.blue nutzt. Kunden, die weiterhin das KRONE Telematics Portal verwenden, erhalten diese Felder nicht.
Hinweise für die Verarbeitung
- Felder, die nicht übermittelt werden, sind nicht leer, sondern fehlen im Datensatz. Die Verarbeitung sollte optionale Felder berücksichtigen.
- Werte sollten als Zeichenketten verarbeitet werden. Leerzeichen in VH_ILU_CODE und VH_LICENSE_PLATE sollten vor Vergleichen normalisiert werden.
- Unbekannte Felder sollten ignoriert werden, damit künftige Erweiterungen die Verarbeitung nicht unterbrechen.
Bei Fragen zur Datenstruktur oder zur Umstellung von einem Portal auf das andere wenden Sie sich bitte an Ihren KRONE-Ansprechpartner.
Auch unterwegs immer auf dem neusten Stand
Das Leben eines Disponenten spielt sich nicht nur am Schreibtisch ab. Daher existiert für mobile Endgeräte die KRONE-Telematics-App, welche sowohl im Apple-App-Store als auch im Google-Play-Store zum Download bereit steht. Hier sind die wichtigsten Fahrzeuginformationen jederzeit abrufbar - damit auch am Wochenende kein Problem unerkannt bleibt!
