Integration: Samsara
Über die Samsara-Schnittstelle integrieren Sie die IoT-Plattform Samsara für Fuhrpark und Fahrzeugtelematik in eTASK. Fahrzeugdaten und Fahrtdaten werden automatisiert über die Samsara REST-API importiert.
Voraussetzungen
- Administratorrechte im eTASK-Portal
- eTASK.Konnektor Samsara Fahrtenbuch muss lizenziert sein
- Samsara-Konto mit API-Zugang
- Samsara API-Token für die Authentifizierung
Schritt 1: Samsara-Konfiguration aufrufen
Pfad zum Ausgangspunkt: Systemsteuerung → Portal-Optionen → Schnittstellen → Schnittstellenkonfiguration → Samsara
Hier finden Sie die Konfiguration der Samsara-Schnittstelle mit den Mapping-Tabellen für den Datenimport.
Schritt 2: Fahrzeug-Mapping konfigurieren
Es werden hier die passenden Datenfelder der Fahrzeuge aus eTASK mit den Feldern in SAMSARA zugeordnet, um eine Datensynchronisation zu ermöglichen.
| Feld | Beschreibung |
|---|---|
| Kfz Fahrzeug Code | Kfz Fahrzeug Code. |
| Kfz Fahrzeug json | JSON-Daten des Fahrzeugs aus Samsara (Payload). |
Schritt 3: Fahrten-Mapping konfigurieren
Es werden hier die passenden Felder der Fahrten aus Samsara mit den Datenfeldern in eTASK zugeordnet.
| Feld | Beschreibung |
|---|---|
| Vehicle ID | Vehicle ID. |
| Name des Fahrzeugs | Name des Fahrzeugs. |
| Datum Fahrtbeginn | Datum Fahrtbeginn. |
| Datum Fahrtende | Datum Fahrtende. |
| Standort bei Start | Standort bei Start der Fahrt. |
| Standort bei Fahrtende | Standort bei Fahrtende. |
| Fahrziel des Trips | Das Fahrziel des Trips. |
| Startkoordinaten Latitude | Startkoordinaten Latitude. |
| Startkoordinaten Longitude | Startkoordinaten Longitude. |
| Endkoordinaten Latitude | Endkoordinaten Latitude. |
| Endkoordinaten Longitude | Endkoordinaten Longitude. |
| Kilometerstand beim Start | Kilometerstand beim Start. |
| Kilometerstand zum Ende | Kilometerstand zum Ende. |
| Kilometerstand bei Fahrtende | Kilometerstand bei Fahrtende. |
| Erfassungsdatum Kilometerstand | Erfassungsdatum Kilometerstand. |
| gefahrene Kilometer | gefahrene Kilometer. |
| Kraftstoffverbrauch/Trip | Kraftstoffverbrauch für diesen Trip. |
Schritt 4: Timer-Job einrichten
Pfad zum Ausgangspunkt: Systemsteuerung → Portal-Optionen → Timer-Jobs → Job-Verwaltung
Der Samsara-Import wird über einen Timer-Job gesteuert. In der Job-Verwaltung konfigurieren Sie den zugehörigen Job:
- Bezeichnung (Pflichtfeld): Name des Jobs.
- Job-Typ (Pflichtfeld): Wählen Sie den passenden Typ für den Samsara-Import.
- aktiv: Aktiviert den automatischen Import.
Im Bereich Zeitsteuerung legen Sie fest, wann und wie oft der Import ausgeführt wird:
- Erste Auslösung (Pflichtfeld): Startzeitpunkt.
- Intervall [Minuten] (Pflichtfeld): Häufigkeit der Ausführung.
- Früheste tägliche Auslösung (Pflichtfeld): Frühester Zeitpunkt am Tag.
- Letzte tägliche Auslösung (Pflichtfeld): Spätester Zeitpunkt am Tag.
Um einen Import sofort auszulösen, aktivieren Sie die Checkbox Beim nächsten Timer-Tick ausführen.
Systemparameter
Pfad zum Ausgangspunkt: Systemsteuerung → Portal-Optionen → Konfigurationsparameter
Die folgenden Systemparameter steuern die Verbindung zur Samsara-Plattform und müssen konfiguriert sein, damit der Datenimport funktioniert.
| Parameter | Beschreibung | Standardwert |
|---|---|---|
| SAMSARAAPIURL | URL des Samsara-API, über die (bei entsprechender Lizenz) Fahrzeugtelemetriedaten an eTASK übertragen werden können. | (leer) |
| SAMSARATOKEN | Zugriffstoken für den Samsara GPS-Flotten-Tracker, das für den Zugriff auf Fahrzeugtelemetriedaten benötigt wird. Dieses Token erhalten Sie aus Ihrem Samsara-Konto. | (leer) |
Zusammenfassung
| Konfigurationsschritt | Pfad |
|---|---|
| Samsara-Konfiguration | Systemsteuerung → Portal-Optionen → Schnittstellen → Schnittstellenkonfiguration → Samsara |
| Timer-Job einrichten | Systemsteuerung → Portal-Optionen → Timer-Jobs → Job-Verwaltung |
| Systemparameter | Systemsteuerung → Portal-Optionen → Konfigurationsparameter |