Metainformationen zur Seite
Ü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.