ViPOS ODBC Online SQL Interface
Allgemeines
Dieses Dokument beschreibt die Schnittstellen-Module des ODBC Online Interfaces, die für den Online und Offline Betrieb verwendet werden.
Der Inhalt dieses Dokumentes ist streng vertraulich zu behandeln, eine Weitergabe, gesamt oder auszugsweise, ist nur mit ausdrücklicher, schriftlicher Zustimmung von SynCore Systems gestattet.
Technische Voraussetzungen
Der Zugriff auf die SQL-Datenbank des ERP Systems erfolgt über ODBC. Für den Zugriff wird ein ODBC - Einträge (System DSN) mit dem Namen VP30ERP eingerichtet.
Der ViPOS Server ist das steuernde System, d.h. die Zeitpunkte und die Art der Übertragung wird vom ViPOS Server ausgelöst.
Das Schnittstellenprogramm läuft als Dienst oder geplanter Vorgang auf dem ViPOS Kassenserver und kann in Threads parallel mehrere Schnittstellengruppen abarbeiten.
Prozessgrundlagen
Grundsätzlicher Schnittstellenaufbau
Der ERP System Hersteller integriert die in einer Schnittstellenspezifikation vorgesehen Tabellen und Views in SQL-Serverdatenbank des ERP Systems und sorgt dafür, dass die Tabellen für einen gemeinsam definierten Benutzer „VIPOS“ les- und beschreibbar sind.
Namenskonvention Tabellen/Views
Die Schnittstellentabellen haben den Prefix „VP_“ und den Postfix „_T“ (bei Tabellen) bzw. „_V“ bei Views. Tabellen/Views werden immer in Großbuchstaben angegeben.
Z.B. Kundentabelle: VP_CUSTOMER_T
Da viele SQL-Datenbanken editierbare Views beherrschen, können alle Schnittstellenstrukturen als Views angelegt werden.
Sollten die Namenskonventionen nicht eingehalten werden, so bietet die Standard ODBC SQL-Schnittstelle die Möglichkeit, die Namen der Tabellen/Views und deren Felder über eine Schnittstellen-Ini Datei zu mappen. Die Feldinhalte müssen jedoch erhalten bleiben.
Primärschlüssel
Die Primärschlüssel (fett markierte Felder) müssen eingehalten werden.
Verarbeitungskennzeichen (ProcessState)
Folgende Verarbeitungskennzeichen sind für die Schnittstelle möglich:
• Q = Quellsystem erzeugt Datensatz gerade
• N = Neuer Datensatz
• R = Datensatz in Arbeit, nicht abgeschlossen
• O = Datensatz erfolgreich verarbeitet
• E = Datensatz wurde als fehlerhaft erkannt und markiert
Über einen Parameter im INI-File des Schnittstellenprogramms kann definiert werden, ob „E“/“R“ Datensätze im nächsten Schnittstellenzyklus erneut gelesen oder diese zur Fehlerbehandlung ignoriert werden.
Der Name des Verarbeitungskennzeichens in jeder Tabelle ist „ProcessState“.
Grundsätzlich werden alle Datensätze gelesen, die als Verarbeitungskennzeichen 'N' haben. Es ist daher notwendig, dass in den Tabellen das Verarbeitungskennzeichen indiziert wird.
Upload (ActionFlag)
Automatische Änderungen von Datensätzen (Update) für den Upload von Daten (Import) wird nur vom ViPOS Schnittstellenprogramm durchgeführt. Das ERP System stellt nur neue Datensätze zur Verfügung, ViPOS ändert je nach Übertragungszustand das Verarbeitungskennzeichen.
Eindeutige Eigenschaften von Datensätzen oder Objekten werden nur im ERP System gepflegt bzw. erzeugt.
Folgende Aktionskennzeichen werden für den Upload verwendet:
• U = der zu verarbeitende Datensatz muss im ViPOS Server aktualisiert werden. Ist der Datensatz über seinen Primary Key nicht zu finden, wird dieser angelegt und die Aktion „I“ durchgeführt.
• I= der zu verarbeitende Datensatz muss im ViPOS Server angelegt werden. Ist der Datensatz über seinen Primary Key bereits zu finden, wird keine weitere Aktion durchgeführt und der zu Schnittstellen-Datensatz abgewiesen.
• D = der zu verarbeitende Datensatz muss im ViPOS Server gelöscht werden.
Download
Beim Download (Export) erzeugt der ViPOS Server neue Datensätze, nach erfolgreichem Export werden keine Änderungen an Datensätzen durchgeführt noch Datensätze gelöscht (bzw. das Reorganisieren erfolgt in der SQL-Server Datenbank des ERP Systems).
Alle Nummernkreise und eindeutige Eigenschaften von Datensätzen, die für den Verkauf notwendig sind (z.B. Seriennummern von Gutscheinen, Belegnummernkreise, etc.) oder Objekten werden nur im ViPOS Server gepflegt bzw. erzeugt.
On- bzw. offline Schnittstellen
Online Schnittstellen sind Schnittstellen, die während des Verkaufsvorganges direkt im ERP System über den ODBC Eintrag auf die Daten des ERP Systems zugreifen. Wenn keine Verbindung besteht, so werden die lokal in der Kassendatenbank abgespeicherten Daten verwendet. Die Verbindung zum ERP System auf „Offline“ gesetzt und erst beim erneuten Start der Kassensoftware wieder verbunden.
Offline Schnittstellen bestehen immer nur zwischen Kassen-Server Datenbank und ERP System; diese werden verwendet, um große Mengen an Datensätzen zu in der Nacht zu übertragen (Urladung).
Kundenschnittstelle (on-/offline)
Allgemeines
In der Kundenschnittstelle werden Kunden aus dem ERP System an die Kassa übernommen. Anhand der Kundennummer wird der Kunde identifiziert und seine Stammdaten aktualisiert bzw. neu angelegt.
Für den Verkauf an neue Kunden, die noch nicht im System angelegt sind, wird vorgesehen, dass nur die Kundennummer ohne Adressdaten in der Verkaufsdatenmeldung übergeben wird.
Felder in Tabelle VP_CUSTOMER_V
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CUSCode | VC | 20 | M | Kundennummer | |
| 2 | Salutation | VC | 10 | M | Anrede | |
| 3 | Title | VC | 20 | M | Titel | |
| 4 | FirstName | VC | 20 | M | Vorname | |
| 5 | LastName | VC | 40 | M | Nachname | |
| 6 | Street | VC | 40 | M | Adresse | |
| 7 | City | VC | 40 | M | Stadt | |
| 8 | Zip | VC | 20 | M | PLZ | |
| 9 | Country | VC | 20 | M | Land | |
| 10 | Memo | VC | 255 | K | Infotextfeld | |
| 11 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 12 | ActionFlag | C | 1 | 'U' | M | U, I, D |
| 13 | ISOCC | VC | 10 | M | Iso-Country Code | |
| 14 | CGRCode | VC | 8 | M | Kundengruppen Code | |
| 15 | CrBalance | F | 15,6 | 0 | K | Kreditsaldo (offene Rechnungen) |
| 16 | CrLimit | F | 15,6 | 999.999,99 | Maximale Summe an Kredit (Rechnungssumme) |
Default Kundennummer
Die Default Kundennummern im ViPOS Kassensystem sind:
• 0815: Laufkunde
• 0816: Laufkunde mit Namen auf der Rechnung
Mitarbeiterschnittstelle (on-/offline)
Allgemeines
In der Mitarbeiterschnittstelle werden Basisdaten zu Mitarbeitern übergeben; neben den Anmeldeinformationen werden Name und Berechtigungsstufe übergeben. Die Berechtigungsstufe muss in einem Organisationsgespräch zwischen ERP System Anbieter und SynCore abgestimmt werden.
Felder in Tabelle VP_STAFF_V
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | STACode | VC | 20 | M | Mitarbeiternummer / -kürzel / -code | |
| 2 | FirstName | VC | 20 | M | Vorname | |
| 3 | LastName | VC | 40 | M | Nachname | |
| 4 | PermLevelPOS | C | 1 | '1' | M | Berechtigung Kassa |
| 5 | PermLevelAdmin | C | 1 | '0' | M | Berechtigung Verwaltung |
| 6 | Password | VC | 10 | M | Passwort | |
| 7 | CardNr | VC | 40 | '0' | M | Kartennummer des Mitarbeiters (z.B. RFID Karte) |
| 8 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 9 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Definition der Berechtigungen
Die Berechtigungen werden im Softwarestandard wie folgt definiert:
PermLevelPOS:
• 1 = nur Kassieren
• 4 = Manager/Supervisor
PermLevelAdmin:
• 0 = keine Verwaltungsberechtigung
• 1 = nur Berichte
• 2 = Administrator
Passwortverwendung
Wenn ein Passwort bei einem Mitarbeiter übertragen wird, so wird dieses auch bei der Kassier- oder Verwaltungsanmeldung abgefragt.
Artikelschnittstelle (Offline)
Allgemeines
In der Artikelschnittstelle werden folgende Informationen verarbeitet:
• Artikelstammdaten: Alle Daten, die direkt einem Artikelobjekt zuzuordnen sind (1:1)
• Preisstammdaten: Preise zu Artikelobjekten (n:1)
• EAN-Stammdaten: Scancodes zu Artikelobjekten (n:1)
• Set-Stammdaten: Sets mit eigenen Preisen und Kombinationen
• Lagerbestand: Lagerbestand pro Produkt und Lagerort
Steuercodes
Folgende Steuercodes sind im ViPOS Softwarestandard verfügbar:
• 0 = 0 % Steuer
• 1 = 10 % Steuer
• 2 = 20 % Steuer
• 3 = 13 % Steuer
• 9 = keine Steuer
Es muss nur das Feld TAXCode1 befüllt werden; weitere Steuercodes können in Absprache definiert werden, diese werden über die INI Datei der Schnittstelle zusammengeführt.
Tabelle VP_ARTICLE_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | ARTCode | VC | 20 | M | Artikelnummer, auf unterster Ebene (SKU inkl. Farbe / Größe) | |
| 2 | escription | VC | 40 | M | Artikelbezeichnung | |
| 3 | POSDesc | VC | 20 | M | Artikelbezeichnung Kassa | |
| 4 | AGRCode | VC | 8 | M | WGR-Code | |
| 5 | UNICode | VC | 4 | M | Einheiten-Code | |
| 6 | PQUCode | VC | 4 | '1' | M | Preismengen-Code |
| 7 | AccType | C | 1 | '0' | K | Konto-Art |
| 8 | AccNr | VC | 20 | K | FIBU-Kontonummer | |
| 9 | CrDb | C | 1 | '0' | K | Soll oder Haben |
| 10 | CostCent | VC | 10 | K | Kostenstelle | |
| 11 | TAXCode1 | VC | 4 | K | Steuer-Code 1 | |
| 12 | TAXCode2 | VC | 4 | K | Steuer-Code 2 | |
| 13 | SignFlag | C | 1 | 0' | M | Artikel negativ? 0..N, 1..J |
| 14 | ZeroFlag | C | 1 | '0' | M | Null-Preis? 0..N, 1..J |
| 15 | RetFlag | C | 1 | '1' | M | Retoure erlaubt? 0..N, 1..J |
| 16 | PUpdFlag | C | 1 | '0' | M | Preisübersteuerung? 0..N, 1..Erlaubt, 2..Zwang |
| 17 | RARTCode | VC | 20 | K | verknüpfter Artikel | |
| 18 | IdNrFlag | C | 1 | '0' | M | Seriennummer erforderl.? |
| 19 | BaNrFlag | C | 1 | '0' | M | Chargennummer erf.? |
| 20 | SetFlag | C | 1 | '0' | M | Set ? |
| 21 | TXTCode | VC | 4 | K | Zusatztext | |
| 22 | TupdFlag | C | 1 | '0' | M | Textübersteuerung erl.? 0..N, 1..Erlaubt, 2..Zwang |
| 23 | XFNCode | VC | 4 | K | Zusatzfunktion | |
| 24 | Attr1 | VC | 4 | K | Artikel-Merkmal 1 | |
| 25 | Attr2 | VC | 4 | K | Artikel-Merkmal 2 | |
| 26 | Attr3 | VC | 4 | K | Artikel-Merkmal 3 | |
| 27 | Attr4 | VC | 4 | K | Artikel-Merkmal 4 | |
| 28 | Attr5 | VC | 4 | K | Artikel-Merkmal 5 | |
| 29 | Attr6 | VC | 4 | K | Artikel-Merkmal 6 | |
| 30 | Attr7 | VC | 4 | K | Artikel-Merkmal 7 | |
| 31 | Attr8 | VC | 4 | K | Artikel-Merkmal 8 | |
| 32 | AddDiscFlag | C | 1 | '0' | M | Mehrfachkonditionen erl.? |
| 33 | RollbackFlag | C | 1 | '0' | K | Rückberechnung Set? |
| 34 | ARTGrpCode | VC | 10 | K | Funktionsgruppe | |
| 35 | ManDiscFlag | C | 1 | '1' | M | man. Rabatt erlaubt? |
| 36 | StoreFlag | C | 1 | '1' | M | Lagerführung aktiv? |
| 37 | STYCode | VC | 8 | K | Code des Lagertyps | |
| 38 | StockWarnFlag | C | 1 | '0' | M | Nullbestandswarnung? |
| 39 | SUPCode | VC | 20 | K | Lieferanten-Code | |
| 40 | SUPArtCode | VC | 20 | K | Artikelnummer Lieferant | |
| 41 | AutoOrderFlag | C | 1 | '0' | M | autom. Bestellung? |
| 42 | MinStock | F | 15 | 0 | M | Mindestbestand |
| 43 | OrderQuantity | F | 15 | 0 | M | Bestellmenge |
| 44 | MARCode | VC | 4 | K | Markt des Artikellagers | |
| 45 | DEPCode | VC | 4 | K | Abteilung des Artikellagers | |
| 46 | STOCode | VC | 8 | K | Code des Artikellagers | |
| 47 | ArtType | C | 1 | '0' | M | Artikelart: 0..Handelsware, 1..Vermittlungsware |
| 48 | Status | VC | 2 | K | Status des Vermittlungsart.: 0..übern., 1..geschätzt, 2..storniert, 3.. verkaufsfähig, 4..verkauft, 5.. Retourlager, 6..retourniert, 7.. ausbezahlt, 8..Schwund | |
| 49 | CUSCode | VC | 20 | K | Eigentümer bei Vermittlungsware | |
| 50 | Memo | VC | 255 | K | interne Notizen | |
| 51 | Text | VC | 255 | K | freier Zusatztext | |
| 52 | AutoDiscFlag | C | 1 | '1' | M | autom. Positionsrabatt? |
| 53 | DocDiscFlag | C | 1 | '1' | M | Belegrabatt anwendbar? |
| 54 | BkArtCode | I | 4 | 99 | K | Warencode für Bankomat-Transakt. mit Kaufbeschr. (0..99) |
| 55 | SelFlag | C | 1 | '1' | M | Verkauf erlaubt: 0..N, 1..J |
| 56 | IdNrDesc | C | 1 | '1' | M | Ser.nr. absteigend: 0..N, 1..J |
| 57 | StockARTCode | VC | 20 | K | Bestandsartikel | |
| 58 | PMECode | VC | 4 | K | Zahlungsart des TransArtikels | |
| 59 | StockPRCCode | VC | 4 | K | Preiscode falls die Lagerführung des Artikels preisgenau ist | |
| 60 | CrednoteFlag | C | 1 | '0' | M | Gutscheinartikel: 0..N, 1..J |
| 61 | CheckCrednoteFlag | C | 1 | '0' | M | Gutschein muss bereits vorhanden sein: 0..N, 1..J |
| 62 | ArticleOrderFlag | C | 1 | K | Bestellung beim Lieferanten 0 Nein, 1 Ja | |
| 63 | BonDupFlag | C | 1 | K | Bonduplikat automatisch drucken 0 Nein, 1 Ja | |
| 64 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 65 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Tabelle VP_PRICE_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | PRCCode | VC | 4 | M | Preis-Code, VK' = Verkaufspreis brutto, 'EK' = Einkaufspreis brutto | |
| 2 | ARTCode | VC | 20 | M | Artikelcode | |
| 3 | DateFrom | D | M | Gültigkeitsbeginn | ||
| 4 | Price | F | 15 | M | Preis | |
| 5 | MGRCode | VC | 18 | '*' | M | Marktgruppe |
| 6 | MGRAutoma | C | 1 | 'N' | M | Kennzeichen, ob Preis automatisch angelegt wurde; N.. Nein, J..Ja |
| 7 | CURCode | VC | 4 | M | Währungscode, bei Std. 'EUR' | |
| 8 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 9 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Tabelle VP_SCANCODE_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | SCTCode | VC | 10 | K | Scantyp, z.B. EAN13 | |
| 2 | SCACode | VC | 20 | M | Barcode Nummer | |
| 3 | ARTCode | VC | 20 | M | Zugeordnete Artikelnummer | |
| 4 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 5 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Tabelle VP_SETART_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | SARTCode | VC | 8 | M | SetCode | |
| 2 | ARTCodeSKU | VC | 20 | M | Artikelcode | |
| 3 | Quantity | F | 15 | M | Menge dieses Artikels im Set | |
| 4 | Price | F | 15 | M | Preis des Artikels im Set | |
| 5 | ValidDateTime | D | M | Gültigkeitsdatum des Sets | ||
| 6 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 7 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Tabelle VP_STOCK_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | MARCode | VC | 4 | M | Code des Marktes | |
| 2 | STOCode | VC | 4 | M | Code des Lagerortes | |
| 3 | ARTCode | VC | 20 | M | Artikelcode | |
| 4 | Quantity | F | 15 | M | Lagermenge | |
| 5 | DateLastUpd | D | M | Zeitpunkt der letzten Änderung | ||
| 6 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 7 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Artikelschnittstelle (Online)
Allgemeines
Durch die View VP_ART_V werden bei jedem Scan eines Artikels (oder bei der Auswahl) folgende Felder aus ERP Datenbank geholt und in der Kassendatenbank (falls notwendig) aktualisiert.
View VP_ART_V
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | ARTCode | VC | 20 | M | Artikelcode | |
| 2 | ArtPOSDesc | VC | 20 | M | Artikelbezeichnung (Bon) | |
| 3 | ArtDescription | VC | 40 | M | Artikelbezeichnung lang | |
| 4 | CONCode | VC | 4 | K | Code des Rabattes | |
| 5 | CondDescription | VC | 20 | K | Bezeichnung des Rabattes | |
| 6 | TAXCode | VC | 4 | M | Steuercode | |
| 7 | Price | F | 15 | M | Preis ohne Abzüge (Brutto) | |
| 8 | PriceCond | F | 15 | M | Preis inkl. Abzüge (Brutto) | |
| 9 | PriceDelta | F | 15 | M | Differenz zu Verkaufspreis ohne Abzüge | |
| 10 | POSCode | VC | 4 | M | Kassa, die den Artikel abfragt | |
| 11 | StockQuantity | F | 15 | K | Lagerbestand des Artikels | |
| 12 | STOCode | VC | 4 | K | Lagerort des Artikels |
Belegschnittelle (Offline)
Allgemeines
In der Belegschnittstelle werden folgende Informationen verarbeitet:
• Belegkopf (Document): Kopfinformationen zu allen zu Belegen (Verkauf, Transaktionen)
• Belegpositionen (DocJour): Postionen zu einem Belegkopf (n:1)
• Rabattpositionen (DocGrpCond): Rabatte zu Belegpositionen (n:1)
• Zahlungen (PayJour): Zahlungen zu Belegköpfen (n:1)
• Eigenschaften einer Belegzeile (DocJour_AdvAttr), n:1 zu Belegpositionen
• Tages- bzw. Schichtenden (DresJour)
Die Belegschnittstelle wird in sehr kurzen Intervallen (5 Minuten) auf dem ViPOS Server ausgeführt; die Daten werden im ERP System durch automatische Lagerbuchungen verarbeitet. Die Intervalle werden Projektbezogen definiert.
Tabelle VP_DOCUMENT_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CoNUMCode | VC | 4 | M | Nummernkreis des Beleges | |
| 2 | CONSNr | I | M | Belegnummer (fortlaufend) | ||
| 3 | MARCode | VC | 4 | M | Marktcode | |
| 4 | POSCode | VC | 4 | M | Kassennummer | |
| 5 | CSHCode | VC | 8 | M | Code des Kassiers | |
| 6 | ClSTACode | VC | 8 | K | Code des Verkäufers, der den Beleg geschlossen hat | |
| 7 | CUSCode | VC | 20 | K | Kundennummer | |
| 8 | ClDateTime | D | M | Datum/Uhrzeit, wann der Beleg geschlossen wurde | ||
| 9 | TotalAmount | F | M | Gesamtpreis (Brutto), inkl. aller Abzüge | ||
| 10 | TotalTax | F | 0 | M | Gesamtsteuern des Beleges | |
| 11 | TotalNetAmount | F | 0 | M | Gesamtpreis (Netto), inkl. aller Abzüge | |
| 12 | TaxBDiff | F | K | manueller Steuerbetrag bei B-Rechnung/Differenzbesteuerte USt | ||
| 13 | CURCode | VC | 4 | 'EUR' | M | Währungscode, bei Std. 'EUR' |
| 14 | InvoiceType | C | 1 | 'B' | M | B..Brutto, N..Netto |
| 15 | Type | C | 1 | K | 0..Verkaufsbeleg, 4..Transaktion | |
| 16 | ReConsNr | I | K | Nummer des Vorbeleges (bei Storno) | ||
| 17 | ReConNumCode | VC | 4 | K | Nummernkreis des Vorbeleges | |
| 18 | Zcounter | I | K | In welchem Tagesende (Zcounter + 1)? | ||
| 19 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 20 | Salutation | VC | 10 | K | Anrede Rechnungsadresse | |
| 21 | Title | VC | 20 | K | Titel Rechnungsadresse | |
| 22 | FirstName | VC | 20 | K | Vorname Rechnungsadresse | |
| 23 | LastName | VC | 40 | K | Nachname Rechnungsadresse | |
| 24 | Street | VC | 40 | K | Adresse Rechnungsadresse | |
| 25 | City | VC | 40 | K | Stadt Rechnungsadresse | |
| 26 | Zip | VC | 20 | K | PLZ Rechnungsadresse | |
| 27 | Country | VC | 20 | K | Land Rechnungsadresse | |
| 28 | ISOCC | VC | 20 | K | ISO Ländercode Rechnungsadresse |
Tabelle VP_DOCJOUR_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CoNUMCode | VC | 4 | M | Nummernkreis des Beleges | |
| 2 | CONSNr | I | M | Belegnummer (fortlaufend) | ||
| 3 | LineNr | I | M | Positionsnummer innerhalb des Beleges | ||
| 4 | ARTCode | VC | 20 | M | Artikelcode | |
| 5 | Quantity | F | 15 | M | Menge der Position | |
| 6 | Price | F | 15 | M | Preis ohne Abzüge (Brutto) | |
| 7 | PriceCond | F | 15 | M | Preis inkl. Abzüge (Brutto) | |
| 8 | TAXCode | VC | 4 | M | Steuercode | |
| 9 | AddTxt | VC | 255 | K | Zusatztext(e) der Position | |
| 10 | RetTXTCode | VC | 4 | K | Grund der Retoure | |
| 11 | IdNr | VC | 40 | K | Seriennummer | |
| 12 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 13 | STOCode | VC | 4 | M | Lagerort | |
| 14 | AccNr | VC | 20 | K | FIBU-Kontonummer |
Tabelle VP_DOCGRPCOND_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CoNUMCode | VC | 4 | M | Nummernkreis des Beleges | |
| 2 | CONSNr | I | M | Belegnummer (fortlaufend) | ||
| 3 | LineNr | I | M | Positionsnummer innerhalb des Beleges | ||
| 4 | CondNr | I | M | Rabattnummer innerhalb der Position | ||
| 5 | CONCode | VC | 8 | M | Konditionsart | |
| 6 | PriceDelta | F | 15 | M | Differenz zu Verkaufspreis ohne Abzüge | |
| 7 | ProcessState | C | 1 | 'Q' | M | eVrarbeitungskennzeichen |
Tabelle VP_PAYJOUR_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CoNUMCode | VC | 4 | M | Nummernkreis des Beleges | |
| 2 | CONSNr | I | M | Belegnummer (fortlaufend) | ||
| 3 | LineNr | I | M | Positionsnummer innerhalb des Beleges | ||
| 4 | PMECode | VC | 4 | M | Code der Zahlungsart: • BEUR = Bar Euro • BK = Bankomat • BKCR = Kreditkarte • GUT = Gutschein • GS = Gutschrift | |
| 5 | PMEDescription | VC | 20 | M | Bezeichnung der Zahlungsart oder Name des Kreditkarten Ausstellers (falls vorhanden) | |
| 6 | Amount | F | 15 | M | Betrag in Landeswährung | |
| 7 | DateTime | D | M | Datum der Zahlung | ||
| 8 | CURCOde | VC | 4 | M | Währungscode | |
| 9 | CRNCode | VC | 20 | K | Gutscheincode | |
| 10 | CashDrawerNr | I | K | Nummer der Geldlade | ||
| 11 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
Tabelle VP_DOCJOUR_AdvAttr_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CoNUMCode | VC | 4 | M | Nummernkreis des Beleges | |
| 2 | CONSNr | I | M | Belegnummer (fortlaufend) | ||
| 3 | LineNr | I | M | Positionsnummer innerhalb des Beleges | ||
| 4 | AttrName | VC | 20 | M | Attributsname | |
| 5 | AttrValue | VC | 255 | M | Attributswert | |
| 6 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
Tabelle VP_DRESJOUR_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | ResetDate | VC | 4 | M | Der Tag, für den dieser Bericht gilt. | |
| 2 | MARCode | VC | 4 | M | Code des Marktes | |
| 3 | ZCount | I | M | Eindeutige Z-Nummer für diesen Bericht | ||
| 4 | FromDateTime | D | M | Beginnzeitpunkt des Berichtes | ||
| 5 | ToDateTime | D | M | Endzeitpunkt des Berichtes | ||
| 6 | MakeDateTime | D | M | Ausführungszeitpunkt des Berichtes | ||
| 7 | MakeSTACode | VC | 8 | M | Benutzer, der den Abschluss ausgeführt hat | |
| 8 | CURCode | VC | 4 | M | Währung | |
| 9 | DEPCode | VC | 4 | M | Abteilung | |
| 10 | POSCode | VC | 4 | M | Kassennummer | |
| 11 | CasSTACode | VC | 8 | M | Kassier, der abgeschlossen wird | |
| 12 | CoNUMCode | VC | 4 | K | Nummernkreis des Beleges | |
| 13 | FromConsNr | I | K | Erster Kassenbeleg in der Schicht / dem Tag | ||
| 14 | ToConsNr | I | K | Letzter Kassenbeleg in der Schicht / dem Tag | ||
| 15 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
Gutscheine (Offline/Online)
Allgemeines
Gutscheine werden in einer eigenen View/Tabelle abgebildet, diese kann im Online oder Offline Modus angesprochen werden.
Tabelle VP_CREDNOTE_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CRNCode | VC | 20 | M | Gutscheinnummer / Seriennummer | |
| 2 | ARTCode | VC | 20 | M | Artikelcode, der hinter Gutschein liegt | |
| 3 | Status | C | 1 | M | Menge dieses Artikels im SetStatus: 0.. verfügbar, 1..verkauft, 2..eingelöst, 3..gesperrt | |
| 4 | Price | F | 15 | M | Wert des Gutscheines | |
| 5 | ValidDateTime | D | M | Gültigkeitsdatum, bis zu dem der Gutschein eingelöst werden kann | ||
| 6 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 7 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Rabatte (Offline)
Allgemeines
Rabatte werden als prozentuelle Rabatte oder Wertrabatte im Kassensystem akzeptiert; es werden folgende Rabattfelder akzeptiert (und die Kombination aus diesen):
• Kundengruppe
• Kundennummer
• Artikelgruppe
• Artikelnummer
Tabelle VP_COND_T
| Nr | Feld | Typ | Größe | Def. | Mand. | Anmerkung |
|---|---|---|---|---|---|---|
| 1 | CONCode | VC | 8 | M | Eindeutiger Konditionsschlüssel | |
| 2 | AGRCode | VC | 8 | K | Warengruppen-Code | |
| 3 | ARTCode | VC | 20 | K | Artikelcode | |
| 4 | CGRCode | VC | 8 | K | Kundengruppe des Rabattes | |
| 5 | CUSCode | VC | 20 | K | Kundennummer | |
| 6 | ValidFromDateTime | D | M | Gültigkeitsdatum, ab dem der Rabatt gilt | ||
| 7 | ValidToDateTime | D | M | Gültigkeitsdatum, bis zu dem der Rabatt gilt | ||
| 8 | Percent | F | 0.0 | K | Prozentwert ODER | |
| 9 | Price | F | 0.0 | K | Abzug in Euro | |
| 10 | ProcessState | C | 1 | 'Q' | M | Verarbeitungskennzeichen |
| 11 | ActionFlag | C | 1 | 'U' | M | U, I, D |
Kombinationen der Rabattanwendung
Rabatte können durch den Eintrag in den Feldern AGRCode, ARTCode, CGRCode und CUSCode kombiniert werden. Es muss dabei beachtet werden, dass nur ein Artikelbezogener Eintrag (Artikelgruppe ODER Artikel) und/oder ein Kunden-bezogener Eintrag (Kundengruppe ODER Kunde) verwendet wird.