Metainformationen zur Seite
Übersicht | X-tanken | Menü | Programme | Glossar | Themen | FAQ | Update
X-tanken
Schnittstellenbeschreibung
Format "X-tanken Standard 1V3" [tsout0001]
Varianten
Variante | Bezeichnung | Bemerkung |
---|---|---|
1 | X-tanken Standard | Satzbeschreibung siehe hier |
2 | X-tanken Standard mit Stern | Satzbeschreibung siehe hier |
3 | X-tanken Standard 1V3 | Satzbeschreibung siehe unten |
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 | Double | 12,2 | Monats-Kartenlimit (Betrag) | |
22 | Double | 12,2 | Monats-Kartenlimit (Menge) | |
23 | Double | 12,2 | Tages-Kartenlimit (Betrag) | |
24 | Double | 12,2 | Tages-Kartenlimit (Menge) | |
25 | String | 3 | Referenzwaehrung | |
26 | Integer | 6 | ISO/IEC 7812-1 | Ausgebernummer (IIN) (ungenutzt) |
27 | Integer | 12 | ISO/IEC 7812-1 | Kartennummer (ungenutzt) |
28 | Integer | 1 | ISO/IEC 7812-1 | Prüfziffer (ungenutzt) |
29 | String | 19 | ISO/IEC 7812-1 | Kartenstring (ungenutzt) |
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 | Double | 12,2 | Kartenlimit je Tankung (Betrag) | |
44 | Double | 12,2 | 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 | Double | 12,2 | 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 (X-tanken) | |
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 | Double | 12,2 | Monats-Kundenlimit (Menge) (X-tanken) | |
30 | Dobble | 12,2 | Tages-Kundenlimit (Betrag) (X-tanken) | |
31 | Double | 12,2 | Tages-Kundenlimit (Menge) (X-tanken) | |
32 | Double | 12,2 | Tankungslimit (Kunde) (Betrag) | |
33 | Double | 12,2 | 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 |
Ablauf
- 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.
- Als erstes wird von uns eine wlsperr-Datei erzeugt. Diese signalisiert die laufende Ausgabe und soll Kollisionen mit Fremdprogrammen verhindern.
- Die Whitelist wird sowohl als Komplett-Ausgabe als auch als Änderungsprotokoll erzeugt.
- Die Komplett-Ausgabe erzeugt jeweils eine komplett neue Datei. Bestehende Dateien werden zuvor gelöscht.
- Die Änderungen werden fortlaufend an die Änderungsdateien angehängt.
- 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.