Übersicht | X-tanken | Menü | Programme | Glossar | Themen | FAQ | Update

X-tanken

Schnittstellenbeschreibung

Format "X-tanken Standard" [tskrti0001]

Felder

Feldname	Datentyp	max. Länge	Format	Beschreibung
Satzart	String	1	„#“, „_“ oder „>“	„#“=Kommentarzeilen; „_“=Kopfzeile; „>“=Datensätze
Kartennummer	Integer	12	Kartennummer (nicht ändern!)
gesperrt	Boolean	1	„J“ oder „N“	„J“=Karte ist gesperrt, „N“=Karte ist nicht gesperrt
PIN-Code	Integer oder String	4	Zahl mit führenden Nullen oder „“	Pin-Code
Kfz-Kennz.	String	12	Kfz-Kennzeichen (für Rechnungsdruck)
Fahrername	String	20	Fahrername oder andere Texte (für Rechnungsdruck)
Personalnr.	Integer	12	Personalnummer (für Rechnungsdruck)
Kostenstelle	String	12	Kostenstelle (für Rechnungsdruck)
Produkt-Restriktionen	Integer	12	lt. Legende	Produk-Restriktions-Codes laut Legende (nicht von allen Tanstellen unterstützt)
Stations-Restriktionen	Integer	12	lt. Legende	Stations-Restriktions-Codes laut Legende (nicht von allen Tanstellen unterstützt)
km-Abfrage	Boolean	1	„J“ oder „N“	„J“=Kilometerstand soll am Tankautomaten abgefragt werden, „N“=Kilometerstand soll nicht abgefragt werden (nicht von allen Tanstellen unterstützt)
Personalnr.-Abfrage	Boolean	1	„J“ oder „N“	„J“=Personalnummer soll am Tankautomaten abgefragt werden, „N“=Personalnummer soll nicht abgefragt werden (nicht von allen Tanstellen unterstützt)
Monatslimit Euro	Double oder String	12,2	Zahl oder „unbegrenzt“	Monatslimit in Euro (Abrechnungszeitraum Monatserster bis Monatsletzter) (nicht von allen Tanstellen unterstützt)
Monatslimit Liter	Double oder String	12,2	Zahl oder „unbegrenzt“	Monatslimit in Litern (Abrechnungszeitraum Monatserster bis Monatsletzter) (nicht von allen Tanstellen unterstützt)
Tageslimit Euro	Double oder String	12,2	Zahl oder „unbegrenzt“	Tageslimit in Euro (00:00 bis 23:59 Uhr) (nicht von allen Tankstellen unterstützt)
Tageslimit Liter	Double oder String	12,2	Zahl oder „unbegrenzt“	Tageslimit in Litern (00:00 bis 23:59 Uhr) (nicht von allen Tankstellen unterstützt)
Tankungslimit Euro	Double oder String	12,2	Zahl oder „unbegrenzt“	Tankungslimit in Euro (je Tankvorgang) (nicht von allen Tankstellen unterstützt)
Tankungslimit Liter	Double oder String	12,2	Zahl oder „unbegrenzt“	Tankungslimit in Litern (je Tankvorgang) (nicht von allen Tankstellen unterstützt)

Trennzeichen

Zeichen	Hex	Beschreibung
Feld-Trennzeichen	;	3B	Semikolon
Text-Trennzeichen	keine	keine
Zeilenumbruch	CR + LF	0D + 0A	Carriage Return + Line Feed
Dezimaltrennzeichen	,	2C	Komma
Tausendertrennzeichen	keine	keine

Besonderheiten

Satzarten

Satzart	Bemerkung
„#“	Dürfen gelöscht werden. Sie dienen dem Bearbeiter der Datei lediglich als Verarbeitungshinweis und werden von unserer Software beim Einlesen ignoriert.
„_“	Ist die Kopfzeile. Sie muss immer alle Feldnamen in der oben angegebenen Reihenfolge und Schreibweise enthalten. Verändern Sie diese Zeile nicht.
„>“	Sind die eigentlichen Datensätze dieser Schnittstelle. Änderungen an den ersten beiden Spalten (Satzart und Kartennummer) sind nicht erlaubt. Alle anderen Spalten dürfen im Rahmen der oben angegebenen Beschränkungen (Datentyp, max. Länge und Format) geändert werden.

PIN-Code

Bei Karten die bereits einen PIN-Code haben wird aus Sicherheitsgründen „“ ausgegeben. Überschreiben Sie diesen Wert mit Ihrem Wunsch-PIN wenn dieser geändert werden soll oder mit 0000 wenn der User seinen PIN beim nächsten Tankvorgang am Tankautomat eingeben soll (je nachdem, was Ihre Tankstelle unterstützt).

Limite

Geben Sie in den Limit-Feldern entweder eine Zahl ein oder das Wort „unbegrenzt“ wenn kein Limit eingestellt werden soll.

große Zahlen

Achten Sie bei großen Zahlen stets darauf, dass diese von Excel nicht in Exponential-Darstellung angezeigt werden. Sollte dies passieren, gehen Sie wie folgt vor:

markieren Sie den Tabellenbereich mit der Maus

Rufen Sie über einen Rechtsklick im Kontext-Menü den Punkt „Zellen formatieren…“ aus

Wählen Sie links „Zahl“

Bestätigen Sie die Eingabe mit OK

Dateinamen

Der Dateiname der Schnittstelle muss immer mit dem Datum beginnen, ab dem diese Einstellungen gelten sollen. Das Datum ist dabei im Format JJJJ-MM-TT anzugeben. Der Dateiname darf keine Leerzeichen, Umlaute oder Sonderzeichen (außer Minus, Unterstrich und Punkt) enthalten.

Beispiel: Gültige Dateinamen: 2022-07-28_Karten.csv, 2022-07-28.csv, 2022-07-28_Sachbezuege_Mitarbeiter.csv, 2022-07-28.Kfz-Kennzeichen.und.Farernamen.csv Ungültig wären: 07-2022_Karten.csv, 28.07.2022.csv, 2022-07-28 Sachbezuege Mitarbeiter.csv, Kfz-Kennzeichen_und_Fahrernamen.csv

Erweiterungen

Sehen Sie bei maschineller Verarbeitung der Datei vor, dass die Schnittstelle jederzeit erweitert werden kann. Neue Felder werden dann immer am Ende des Datensatzes angehängt.

Rechtliches

Alle Angaben ohne Gewähr.

Übersicht | X-tanken | Menü | Programme | Glossar | Themen | FAQ | Update