8.4 Datenpool Schnittstelle

Aus Wiki-Onlinehandbuch für ShopMaster
Zur Navigation springen Zur Suche springen

BESCHREIBUNG einer warenwirtschaftunabhängigen Datenschnittstelle für den Aufbau eines Datenpools

Die zu liefernden Daten bestehen aus 2 Dateien.

Eine Datei mit beliebigem Namen *.DSC, in der die Struktur Ihrer Daten-Datei beschrieben ist und der Datendatei selbst (die Namensgebung der Datei ist nicht vorgeschrieben, allerdings gelten für beide Dateien die DOS Dateinamenbeschränkungen. Der Name max. 8 Zeichen lang ohne Sonderzeichen und Leerzeichen. Die evtl. Erweiterung der Daten Datei max. 3 Zeichen ohne Sonderzeichen und Leerzeichen).

Aufbau der Beschreibungsdatei INFO.DSC: · Die Datei ist eine reine ASCII-Datei ohne irgendwelche Steuerzeichen oder Formatierungen. · Die Datei enthält pro Zeile einen Eintrag. · Die Zeilen werden getrennt durch CRLF (Hex 0D 0A). · Die Zeilen beginnen in der ersten Spalte mit den Schlüsselwörtern. · Die Groß- und Kleinschreibung muss beachtet werden. Den Schlüsselwörtern folgt mindestens ein Leerzeichen (Hex 20) und dann der jeweilige Eintrag. · Die Maximallängen beziehen sich auf die derzeitige Weiterverarbeitung, d.h. Ihre Felder können länger sein und werden dann entsprechend gewandelt bzw. gekürzt.

Angaben zum Lieferanten:

Schlüsselwörter Pflichtfeld Beschreibung
nSL ja/nein wenn es eine feste Satzlänge gibt (Variante 1), ist dieses Feld Pflicht. Es enthält die Länge eines Datensatzes ohne Satztrennzeichen.
nTZ ja bei fester Feldlänge kein Eintrag, bei variabler Feldlänge den ASCII-Wert des Feld-Trennzeichens. Dieses Zeichen MUSS so gewählt werden, daß es in KEINEM Fall als Inhalt in einem der Felder vorkommt.
nDEL nein wird nur bei variabler Feldlänge benötigt, wenn die einzelnen Felder noch ein separates Anfangs- und Endezeichen haben. ASCII-Wert dieses Feldeinschlußzeichens.
cALBZ ja Artikelbezeichnung (maximal 70 Zeichen) davon werden 32 Zeichen auf Preisetiketten, 36 auf Kassenbons und 45 Zeichen auf Rechnungen verwendet
cBNR ja Artikelbestellnummer (maximal 13 Zeichen)
nHEK ja Einkaufspreis NETTO (maximal 11 Zeichen 8,2)
nEVK ja empf. Verkaufspreis BRUTTO (maximal 11 Zeichen 8,2)
nBKZ nein Bewegungskennzeichen (1 Zeichen) - 0 bedeutet keine Änderung - 1 bedeutet Änderung - 2 bedeutet Neuanlage - 3 bedeutet Löschung
nMWST nein Mehrwertsteuersatz (maximal 5 Zeichen 2,2)
cAKBZ nein Artikelkurzbezeichnung (maximal 20 Zeichen)
nCCG nein CCG Warengruppe (maximal 4 Zeichen)
nCCG ( ja) wenn Teilnahme an statistischer Auswertung gewünscht.
cEAN nein EAN Nummer ( 13 Ziffern)
cHST nein Name des Herstellers (maximal 15 Zeichen)
cHKL nein Herkunftsland (maximal 15 Zeichen)
nVPE nein Verpackungseinheit (maximal 4 Zeichen)
cME nein Mengeneinheit (maximal 5 Zeichen)
lSNR nein Seriennummerartikel ( 1 Zeichen J oder N)
nRBM1 nein Rabattmenge1 (maximal 4 Zeichen)
nRBS1 nein Rabattsatz1 in % (maximal 5 Zeichen 2,2)
nRBM2 nein Rabattmenge2 (maximal 4 Zeichen)
nRBS2 nein Rabattsatz2 in % (maximal 5 Zeichen 2,2)
nRBM3 nein Rabattmenge3 (maximal 4 Zeichen)
nRBS3 nein Rabattsatz3 in % (maximal 5 Zeichen 2,2)
nRBM4 nein Rabattmenge4 (maximal 4 Zeichen)
nRBS4 nein Rabattsatz4 in % (maximal 5 Zeichen 2,2)
nRBM5 nein Rabattmenge5 (maximal 4 Zeichen)
nRBS5 nein Rabattsatz5 in % (maximal 5 Zeichen 2,2)
lAMA nein Auftragsmengenaddition ( 1 Zeichen J oder N)
cHKF nein Händlerklassifikation (maximal 3 Zeichen)

Hier nun einige Beispiele zum Aufbau der Beschreibungsdatei INFO.DSC und der Datendatei:

Variante 1:

Datensätze mit fester Feldlänge ohne (Feld-)Trennzeichen (Satztrennzeichen CRLF Hex 0D OA) Hinter dem Schlüsselwort und mindestens einem Leerzeichen folgt die Position und - getrennt durch ein Komma - die Länge des Feldes. Begonnen wird mit 1 in der ersten Spalte von links.

Datenpool infodsc.png

2 Beispieldatensätze (als Dezimalzeichen in numerischen Feldern kann wahlweise ',' oder '.' verwendet werden.) aus TEST.ASC:

Datenpool testasc.png

Variante 2:

Datensätze mit variabler Feldlänge und Feld-Trennzeichen (Satztrennzeichen CRLF Hex 0D OA)Hinter dem Schlüsselwort und mindestens einem Leerzeichen folgt die Feldnummer des Feldes. Begonnen wird mit 1 vor dem 1. Trennzeichen

Beispiel mit Trennzeichen '@'(ASCII-Wert 64)

Datenpool trennzeichen ascii.png

2 Beispieldatensätze (beachten Sie, daß als Dezimalzeichen in nummerischen Feldern wahlweise ',' oder '.' vorkommen kann, solange weder Punkt noch Komma als Feldtrennzeichen verwendet wird.)

Datenpool trennzeichen ascii datentxt.png

Variante 3:

Datensätze mit variabler Feldlänge, Feld-Trennzeichen und Feldeinschluß-Zeichen (Satztrennzeichen CRLF Hex 0D OA) Hinter dem Schlüsselwort und mindestens einem Leerzeichen folgt die Feldnummer des Feldes. Begonnen wird mit 1 vor dem 1. Trennzeichen.

Beispiel mit Trennzeichen ',' (ASCII-Wert 44) und Feldeinschlußzeichen '"' (ASCII-Wert 34):

Datenpool trennzeichen feldtr ascii .png

2 Beispieldatensätze ( beachten Sie, daß bei einem Komma als Feldtrennzeichen in numerischen Feldern als Dezimalzeichen NUR '.' erlaubt ist ).

Datenpool trennzeichen feldtr prinfodat.png