Metainformationen zur Seite
Buch erstellen
 Diese Seite zum Buch hinzufügen
Buch erstellen
 Diese Seite aus Buch entfernen  

 Buch anzeigen, ändern(0 Seite/n)
 Hilfe

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

X-tanken

Schnittstellenbeschreibung

Format "X-tanken Standard" [tsout0001]

Varianten

Variante Bezeichnung Bemerkung
1 X-tanken Standard Gibt das Feld 5 der Kundenausgabe ohne Stern (Beginn des Matchcode) aus. Satzbeschreibung siehe unten.
2 X-tanken Standard mit Stern Gibt das Feld 5 der Kundenausgabe mit Stern (Beginn des Matchcode) aus. Satzbeschreibung siehe unten.
3 X-tanken Standard 1V3 Satzbeschreibung siehe hier

Felder Karten-Daten

Feld Datentyp max. Länge Format Beschreibung
1 Integer 1 0=Insert, 1=Update(ungenutzt), 2 = Delete Bearbeitungsmodus
2 Integer 2 Firma
3 Integer 12 Kartennummer
4 Integer 12 Kundennummer
5 Integer 12 Stationsnummer
6 String 12 Kfz-Kennzeichen
7 String 1 „0“=frei „1“=gesperrt Kartenstatus
8 Date 10 TT.MM.JJJJ Gültigkeitsdatum
9 String 20 Fahrername
10 String 1 „J“=abfragen „N“=nicht abfragen Abfrage der Personalnummer
11 String 1 „J“=abfragen „N“=nicht abfragen Abfrage der PIN
12 String 4 PIN
13 Integer 12 immer 0
14 Integer 12 immer 3
15 String 1 „J“=abfragen „N“=nicht abfragen Abfrage des km-Standes
16 Integer 12 km-Stand
17 Date 10 TT.MM.JJJJ Ausstelldatum der Karte
18 Date 10 TT.MM.JJJJ Datum der letzten Rechnung
19 String 15 letzte Rechnungsnummer
20 String 2 ISO 3166 alpha-2 Referenzland
21 Integer 12 Monats-Kartenlimit (Betrag)
22 Integer 12 Monats-Kartenlimit (Menge)
23 Integer 12 Tages-Kartenlimit (Betrag)
24 Integer 12 Tages-Kartenlimit (Menge)
25 String 3 Referenzwaehrung
26 Integer 6 ISO/IEC 7812-1 Ausgebernummer (IIN)
27 Integer 12 ISO/IEC 7812-1 Kartennummer
28 Integer 1 ISO/IEC 7812-1 Prüfziffer
29 String 19 ISO/IEC 7812-1 Kartenstring
30 String 79 Kartenstring Spur 1
31 String 40 Kartenstring Spur 2
32 String 107 Kartenstring Spur 3
33 Integer 12 Personalnummer
34 String 1 „J“=abfragen „N“=nicht abfragen Kfz-Kennzeichen-Abfrage
35 Integer 12 Reaktivierungszeit
36 String 30 Hinweistext 1
37 String 30 Hinweistext 2
38 String 1 „J“=Komplettausgabe „N“=Teilausgabe Komplettausgabe-Kennzeichen
39 Timestamp 22 JJJJ-MM-TT HH:MM:SS:HS Erstelldatum/-zeit
40 String 10 Login des Erstellers
41 String 255 Produktrestriktionen (konfigurierbar)
42 Time 11 HH:MM:SS:HS Ausgabezeit
43 Integer 12 Kartenlimit je Tankung (Betrag)
44 Integer 12 Kartenlimit je Tankung (Menge)
45 String 255 Stationsrestriktionen (konfigurierbar)
46 String 1 „J“=abfragen „N“=nicht abfragen Unterschrifts-Abfrage

Felder Kunden-Daten

Feld Datentyp max. Länge Format Beschreibung
1 Integer 1 0=Insert, 1=Update(ungenutzt), 2 = Delete Bearbeitungsmodus
2 Integer 2 Firma
3 Integer 12 Kunde
4 String 40 Text vor Adresse
5 String 40 Name 1
6 String 40 Name 2
7 String 40 Name 3
8 String 40 Strasse
9 String 10 Hausnummer
10 String 10 PLZ
11 String 40 Ort
12 String 40 Ortsteil
13 String 2 ISO 3166 alpha-2 Land
14 String 15 Telefon
15 String 15 Faxnummer (X-oil)
16 String 1 Kreditkennzeichen (X-oil)
17 Integer 12 Kreditlimit (Betrag) (X-oil)
18 String 1 Absolute Sperre (X-oil)
19 Integer 1 0=Papier 1=E-Mail 2=Fax 3=Papier+E-Mail 4=Papier+Fax 5=Papier+E-Mail+Fax 6=E-Mail+Fax 7=nicht möglich Rechnungsversand
20 String 15 Faxnummer (Xtanken)
21 String 255 E-Mail-Adresse (X-tanken)
22 String 1 „J“=gesperrt „N“=nicht gesperrt Sperr-Kennzeichen (X-tanken)
23 Integer 12 Kreditlimit (Betrag) (X-tanken)
24 Integer 12 Rechnungskundennummer
25 String 1 „J“=mit MwSt. „N“=ohne MwSt. MwSt.-Kennzeichen (X-oil)
26 String 1 „J“=komplett „N“=Teilausgabe Komplettausgabe
27 Timestamp 22 JJJJ-MM-TT HH:MM:SS:HS Erstelldatum/-zeit
28 String 10 Login des Erstellers
29 Integer 12 Monats-Kundenlimit (Menge) (X-tanken)
30 Integer 12 Tages-Kundenlimit (Betrag) (X-tanken)
31 Integer 12 Tages-Kundenlimit (Menge) (X-tanken)
32 Integer 12 Tankungslimit (Kunde) (Betrag)
33 Integer 12 Tankungslimit (Kunde) (Menge)

Trennzeichen

Zeichen Hex Beschreibung
Feld-Trennzeichen ; 3B Semikolon
Text-Trennzeichen „ 22 doppelte Anführungszeichen
Zeilenumbruch CR + LF 0D + 0A Carriage Return + Line Feed

Dateinamen

Komplettausgabe Änderungen
Kunden-Ausgabe xpkundenwl.csv xpkundenwl_aen.csv
Karten-Ausgabe xpkartenwl.csv xpkartenwl_aen.csv
Sperrdatei wlsperr wlsperr

Die Dateien werden von X-tanken im zugehörigen Freigabe-Verzeichnis der Firma abgelegt (\\{Server}\tk-{Instanzkennung}\export\whitelist\tsout0001)

Ablauf

  1. Vor der Erstellung oder Verarbeitung ist zu prüfen ob eine wlsperr-Datei existiert. Ist dies der Fall, so ist die Prüfung so lange zu wiederholen, bis die wlsperr-Datei entfernt wurde.
  2. Als erstes wird von uns eine wlsperr-Datei erzeugt. Diese signalisiert die laufende Ausgabe und soll Kollisionen mit Fremdprogrammen verhindern.
  3. Die Whitelist wird sowohl als Komplett-Ausgabe als auch als Änderungsprotokoll erzeugt.
    1. Die Komplett-Ausgabe erzeugt jeweils eine komplett neue Datei. Bestehende Dateien werden zuvor gelöscht.
    2. Die Änderungen werden fortlaufend an die Änderungsdateien angehängt.
  4. Das Kassensystem sollte die Dateien nach deren Verarbeitung löschen. Die Löschung ist unkritisch. Eine Komplettausgabe kann jederzeit nachgeholt werden.

Änderungen

Neue Felder werden am Ende des Datensatzes angehängt. Veraltete Felder werden mit leerem Inhalt ausgegeben (Leerzeichen oder Null). Andere Änderungen ergeben eine neue Variante. Die alte Variante bleibt in der Regel bestehen.

Rechtliches

Alle Angaben ohne Gewähr.

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