Schnittstellen-Beschreibung Umsatzmeldungen => PepMax Service

Der PepMax Service kann von der Warenwirtschaft die Umsatzmeldungen für den KV-Direkt-Ticker direkt per TCP/IP-Schnittstelle entgegennehmen.

Hier horcht der PepMax Service auf einem bestimmten TCP/IP-Port auf eingehende Verbindungen. In der Regel wird hierbei immer der Port 3700 verwendet, dieser Port kann aber im Konfliktfall auch vom Kunden mit dem Parameter 2469 umgestellt werden - der Port sollte also auch in der Warenwirtschaft einstellbar sein.

Grundsätzlich gibt es für den KV-Direkt-Ticker zwei verschiedene Arten von Meldungen:

• Belegung starten: Wenn ein Anwender eine Kaufvertrags-Erfassung beginnt (also die Erfassungs-Maske in der Warenwirtschaft öffnet), kann eine Meldung an den PepMax Service geschickt werden, damit etwa im Tableau mit Hilfe einer kleinen Ampel signalisiert wird, dass der Verkäufer derzeit „belegt“ ist (also in einem Kundengespräch ist).

• Belegung stoppen: Wird die Kaufvertrags-Erfassung beendet (also der Kaufvertrag gespeichert oder abgebrochen), so wird in der TCP/IP-Meldung auch der erfasste KV-Umsatz und die Anzahlung mitgesendet, so dass der PepMax im KV-Direkt-Ticker den aufgelaufenen Umsatz anzeigen kann.

Eine TCP/IP-Meldung besteht immer aus einem einfachen String mit tabulator-getrennten Feldern, abgeschlossen durch ein CRLF (ASCII-Code 13 + ASCII-Code 10).

Für den Start einer Belegung (also der Öffnung eines Kaufvertrags) werden die folgenden Felder benötigt:

• Satzart: Immer konstant der Wert „1“
• Zeitstempel: Datum und Uhrzeit
• Verkäufer-Nummer: Die Verkäufernummer aus der Warenwirtschaft
• Filiale: Die Filialnummer des Kaufvertrags, bei Ametras MOEVE inklusive dem Kennzeichen „N“ oder „L“
• Kennzeichen: Die Art des Kaufvertrags: 1 = Kaufvertrag, 2 = POS, 3 = Carat
• KV-Nummer: Die Kaufvertragsnummer (falls bereits bekannt)
• Bearbeitungs-Kennzeichen: N = Neuerfassung, A = Änderung

Der Zeitstempel hat immer das Format JJJJ-MM-TT-HH.MM.SS.FFFFF („F“ sind hier Millisekunden).

Falls es für den Kunden sinnvoll sein sollte, kann das Feld „Kennzeichen“ auch im weitere Werte ergänzt werden, so dass im PepMax unterschieden werden kann, wo der Kaufvertrag erfasst wurde.

Beispiel für eine Meldung:

1 + Tab + 2013-10-18-12.31.44.00000 + Tab + 017 + Tab + 01 + Tab + 1 + Tab + 123456 + Tab + N + CRLF (ASCII 13 + 10)

Der PepMax Service antwortet auf die TCP/IP-Meldung mit einem Echo (es wird also die eingegangene Meldung genauso wieder zurückgeschickt, ergänzt um eine eventuelle Fehlermeldung bestehend aus Fehlernummer und Fehlertext, ebenfalls mit Tabulator abgetrennt).

Mögliche Fehlermeldungen:

• 0 = Belegung gestartet für Mitarbeiter xyz
• 3 = Falsche Feldlänge Verkäufernummer
• 4 = Falsche Feldlänge Filialnummer
• 5 = Mitarbeiter unbekannt 
• 6 = Fehler beim Verbindungsaufbau zum SQL Server, Nachricht konnte nicht gespeichert werden

Wenn ein Kaufvertrag abgeschlossen und gespeichert wird, dann wird wie beim Belegungsstart genauso eine TCP/IP-Meldung an die gleiche Port-Nummer gesendet, bestehend aus den folgenden Feldern:

• Satzart: Immer konstant der Wert „2“
• Zeitstempel: Datum und Uhrzeit
• Verkäufer-Nummer: Die Verkäufernummer aus der Warenwirtschaft
• Filiale: Die Filialnummer des Kaufvertrags, bei Ametras MOEVE inklusive dem Kennzeichen „N“ oder „L“
• Kennzeichen: Die Art des Kaufvertrags: 1 = Kaufvertrag, 2 = POS, 3 = Carat
• KV-Nummer: Die Kaufvertragsnummer
• Bearbeitungs-Kennzeichen: N = Neuerfassung, A = Änderung
• Umsatz: VKP-Umsatz aus Kaufvertrag
• Anzahlung: Vereinbarte Anzahlung aus Kaufvertrag
• ZahlungsKZ: Zahlungskennzeichen (beispielsweise für Finanzkauf)

Die Beträge (Umsatz und Anzahlung) werden ohne Tausender-Trennpunkt und mit einem Punkt „.“ als Dezimaltrenner erwartet, beispielsweise 12345.67 für 12.345,67 €.

Wie im obigen Fall beschrieben antwortet der PepMax Service wieder mit einem Echo und einer Fehlernummer:

• 0 = XXX aktive Belegungen gestoppt
• 3 = Falsche Feldlänge Verkäufernummer
• 4 = Falsche Feldlänge Filialnummer 
• 6 = Fehler beim Verbindungsaufbau zum SQL Server, Nachricht konnte nicht gespeichert werden