Add-In zum Importieren von Kraftstoffkäufen

User Guide

•

0 mins to read

Erfahren Sie mehr über das Add-In zum Importieren von Kraftstoffkäufen, mit dem Benutzer die von der Anwendung/dem Service des Kraftstoffanbieters extrahierten Tankvorgänge in MyGeotab importieren können. In diesem Dokument wird gezeigt, wie Sie Tankvorgänge mit drei verschiedenen Optionen importieren können: WEX, General Standard und Import Fuel Provider.

Für alle 4.x.x Add-In-Versionen

April 2024

Inhaltsverzeichnis

Einleitung

Mit dem Fuel Transaction Add-In (Add-In zum Importieren von Kraftstoffkäufen) können Benutzer Kraftstofftransaktionen, die von einem Tankkartenanbieter bereitgestellt wurden, in eine MyGeotab-Datenbank importieren.

Referenzen

Das Git-Repository der Konfigurationsdatei wird als Referenz für die Konfigurationsdatei bereitgestellt. Das Repository sollte alle erforderlichen Informationen enthalten, damit eine neue Konfigurationsdatei konfiguriert werden kann und funktioniert.

Die Fuel Transaction Entity (SDK) stellt die Backend-Objektstruktur bereit, die aufgerufen wird, um die Daten der Kraftstoffkäufe hinzuzufügen. Dies ist für alle Benutzer gedacht, die ein größeres Interesse am technischen Hintergrund dieses Dienstprogramms haben.

Add-In installieren

Um das Add-In zu installieren, rufen Sie MyGeotab auf und folgen Sie den unten stehenden Schritten:

Rufen Sie Administration > System > Systemeinstellungen auf.
Wählen Sie auf der Seite Systemeinstellungen die Registerkarte Add-Ins aus und klicken Sie dann auf Neues Add-In.
Fügen Sie im Popup-Fenster Add-In die folgende Konfiguration hinzu:

{ "url": "https://app.geotab.com/addins/geotab/addin-fuel-transaction-import/Manifest.json" }

Um auf das Add-In zuzugreifen, wählen Sie im MyGeotab-Hauptmenü die Option Motor & Wartung > Fuel Transaction Import (Import von Kraftstoffkäufen).

document Image

Beschreibung der Konfigurationsdatei

Die Konfigurationsdatei besteht aus der Spaltenzuordnung und den Konfigurationsinformationen, die zur Ausführung eines erfolgreichen Importvorgangs für Kraftstoffkäufe erforderlich sind.

Im GitHub-Konfigurationsdatei-Repository finden Sie Informationen über die Struktur der Konfigurationsdatei, deren Eigenschaften und wie diese korrekt kompiliert werden kann, um Daten zu Tankvorgängen erfolgreich in das MyGeotab-Datenbanksystem zu importieren.

Die Konfigurationsdatei muss die Spaltenzuordnung und -konfiguration enthalten, die beim Importvorgang erwartet werden soll, und beschreibt die Excel-Importdatei.

Eine Beispielkonfigurationsdatei und einige Formatierungsanweisungen finden Sie im Git-Repository, z. B. source.json.

Das data-JSON-Objekt in der Konfigurationsdatei enthält die Eigenschaftsfelder der Fuel Transaction Entity, die importiert werden sollen sowie ihre Spaltenreferenzen.

Beschreibung der Excel-Importdatei

Bei der Excel-Importdatei handelt es sich um eine Excel-Tabellenkalkulationsdatei (XLS, XLSX), die von einem Tankkartenanbieter bereitgestellt wird (oder um eine benutzerdefinierte Datei, die über einen anderen Mechanismus erstellt wurde), die die zu importierenden Transaktionsdaten enthält.

Einige Kontexte für die Excel-Importdatei umfassen:

Es wird eine Kopfzeile erwartet.
✱ HINWEIS: Die erste Zeile wird übersprungen, da es sich um eine Kopfzeile handelt.
Es muss mindestens ein Feld für die Gerätekennung vorhanden sein, das entweder ein Kfz-Kennzeichen (licencePlate), eine Fahrzeugidentifikationsnummer (vehicleIdentificationNumber) oder die Geotab-Seriennummer (serialNumber) ist. In den Feldern Kommentare und Beschreibung wird auch nach Details zur Geräteidentifikation gesucht, wenn die oben genannten Optionen das nicht tun.

✱ HINWEIS: Die maximale Anzahl von Transaktionen, die pro Importdatei importiert werden, beträgt 5000. Begrenzen Sie Ihre Importdatei daher, um diesen Schwellenwert nicht zu überschreiten und den Import erfolgreich durchzuführen.

Voraussetzungen für den Import von Kraftstoffkäufen

Es gibt einige Voraussetzungen für den Import von Tankvorgängen. Dazu zählen:

Eine korrekt strukturierte Konfigurationsdatei.
Eine Excel-Datei, die die zu importierenden Transaktionen enthält.
Bei jeder Transaktion sollte ein Gerät zumindest anhand einer Seriennummer, einer VIN (Fahrzeugidentifizierungsnummer) oder einer Kennzeichennummer identifiziert werden, damit das Gerät erfolgreich identifiziert werden kann.

✱ HINWEIS: Wenn ein Gerät keine der Identifikationsreferenzen hat, wird der Datensatz zwar importiert, aber er wird keinem Tankvorgang zugeordnet.

Kraftstoffkäufe importieren

Führen Sie die folgenden Schritte aus, um die Transaktionsdateien zu importieren (siehe folgende Abbildung).

Um die Konfigurationsdatei (JSON) auszuwählen, klicken Sie auf die Schaltfläche Choose File (Datei auswählen). (1)
Nutzen Sie die Dropdown-Liste Anbieter auswählen, um den Kraftstoffanbieter auszuwählen. (2)
Um die richtige Importdatei (XLS oder XLSX) auszuwählen, nutzen Sie die Schaltfläche Choose File (Datei auswählen). (3)
Wenn das Blatt nicht das erste in der Datei ist, ändern Sie die Blattnummer. (4)
Wählen Sie die Referenzzeitzone aus der Dropdown-Liste aus. Dies sollte standardmäßig die Zeitzone Ihres Benutzerprofils sein, die in den MyGeotab-Optionen festgelegt wurde. (5)
Klicken Sie auf die Schaltfläche Importieren, nachdem alle Eingabekriterien vollständig sind, um den Prozess zu starten. (6)
Um alle Eingabefelder zurückzusetzen, klicken Sie auf die Schaltfläche Zurücksetzen. (7)
Die Seite zeigt den Importstatus und den Fortschritt des Ladevorgangs an. Sobald dieser Vorgang abgeschlossen ist, wird im Abschnitt Importübersicht eine Zusammenfassung der importierten und übersprungenen Einträge sowie der Fehler angezeigt.

document Image

✱ HINWEIS: Die importierten Transaktionen werden nicht sofort im Bericht auf der Seite Tankvorgänge angezeigt. Im Rahmen einer Nachbearbeitung ist die manuelle Zuordnung dieser Transaktionen zu den Tankvorgängen zu einem späteren Zeitpunkt erforderlich. Im Allgemeinen werden die abgeglichenen Transaktionen aber am folgenden Tag angezeigt.

Häufig gestellte Fragen (FAQ)

F: Wie lange dauert es, bis eine Transaktion mit dem Tankvorgang abgeglichen wird?

Importierte Kraftstoffkäufe werden am Ende jedes Tages bearbeitet und sind daher nicht sofort in der Datenbank einsehbar. Es sollte mit einer Verzögerung von bis zu 24 Stunden gerechnet werden.

F: Wozu dient das Feld „Referenzzeitzone“?

Im Feld Referenzzeitzone können Sie eine andere Zeitzone als die aktuelle lokale Zeitzone auswählen. Mit anderen Worten, Sie können Kraftstofftransaktionen für andere Zeitzonen oder für verschiedene Zeitperioden importieren, z. B. Kraftstoffkäufe, die während der Sommerzeit stattgefunden haben.

Anhang 1

Beispiel für eine Konfigurationsdatei

Sehen Sie sich dieses Beispiel für eine Konfigurationsdatei und die nachstehende Erklärung an.

Weitere Informationen finden Sie auch im Beispiel einer Excel-Importdatei, die mit dieser Konfiguration verknüpft ist.

Screenshot der Datei example.json:

document Image

Screenshot des Beispiels für eine Excel-Importdatei:

document Image

Beispielerläuterungen

Beispiel, das jede Eigenschaft und die zugehörige Einstellung/den zugehörigen Wert beschreibt.

FuelProviderExample1 Erläuterung

Eigenschaft	Einstellung/Wert	Erklärung
Name	FuelProviderExample1	Die Namenseigenschaft, die die Konfiguration identifiziert. Dies ist der Wert, den Sie im Dropdown-Menü Kraftstoffanbieter im Add-In auswählen, nachdem die Konfiguration im Feld „Vorherige“ ausgewählt wurde (Wählen Sie die Konfigurationsdatei (JSON) aus:).
unitVolumeLiters	Y	Diese Option gibt an, ob das Kraftstoffvolumen in metrischen oder imperialen Einheiten angegeben wird. Stellen Sie Y für metrisch (Liter) und N für imperial (Gallonen) ein.
unitOdoKm	Y	Diese Option gibt an, ob der Kilometerstand in metrischen oder imperialen Einheiten angegeben wird. Stellen Sie Y für metrisch (Kilometer) und N für imperial (Meilen) ein.
isCellDateType	N	Diese Option gibt an, ob die Importdateispalte, die das Datum enthält, als Datumstyp oder als allgemeiner (Text-)Wert formatiert ist. Stellen Sie Y für den Datumstyp und N für Text ein.
dateFormat	dd/MM/yyyy	Das in der Transaktionsdatei zu erwartende Datumsformat, basierend auf der Formatdefinition der Luxon-Tokentabelle.
timeFormat	empty	N/A – leer
currencyCodeMapped	empty	N/A – leer
Datenabschnitt
cardNumber	ColumnA	Die Spalte, in der sich die Nummer der Tankkarte in der Excel-Tabelle befindet.
licencePlate	ColumnG	Die Spalte, in der sich das Kennzeichen des Fahrzeugs in der Excel-Tabelle befindet.
provider	ColumnB	Die Spalte, in der sich der Anbieter in der Excel-Tabelle befindet.
cost	ColumnC	Die Spalte, in der sich die Transaktionskosten in der Excel-Tabelle befinden.
currencyCode	ColumnD	Die Spalte, in der sich der Währungscode in der Excel-Tabelle befindet.
dateTime	ColumnE	Die Spalte, in der sich das Transaktionsdatum und/oder die Transaktionszeit in der Excel-Tabelle befinden. Dies ist eine spezielle Eigenschaft namens „Array“, die durch [eckige Klammern] abgegrenzt ist, die entweder ein oder zwei Spaltenreferenzen enthalten kann. Beispielsweise stellen [„ColumnE“] oder [„ColumnE“, „ColumnZ“] das Datum und/oder die Uhrzeit dar.
volume	ColumnF	Die Spalte, in der sich das Transaktionsvolumen in der Excel-Tabelle befindet.
odometer	ColumnH	Die Spalte, in der sich der Kilometerstand des Fahrzeugs in der Excel-Tabelle befindet.

Beispiel für mehrere Kraftstoffanbieter

Weitere Informationen zur Konfiguration einer Konfigurationsdatei mit mehreren Kraftstoffanbietern finden Sie unter diesem Link.