1 Themenübersicht
Das Framework „Multikanal-Vertrieb“ ermöglicht das Erfassen und Bearbeiten von Vertriebskanälen für den Vertrieb von Artikeln über externe Systeme. In einem Vertriebskanal wird die Konfiguration für die Verbindung mit einem ex-ternen System wie beispielsweise einem Webshop festgelegt. Die Verbindung zu einem externen System wird durch einen Anpassungsstück, einen Adapter, hergestellt. Ein solcher Adapter ist für das jeweilige externe System konfiguriert, um die Daten korrekt zu konvertieren und zu übertragen.
Der Adapter „POS“ ist das Verbindungsstück von Comarch ERP Enterprise zu einem Comarch Retail POS Terminal. Der Adapter synchronisiert alle notwendigen Stammdaten und Belege zwischen dem ERP-System und der Kassenlösung Comarch Retail POS.
Diese Dokumentation gibt eine Einführung in den Adapter „POS“ und beschreibt die grundlegenden Prozesse. Genaue Beschreibungen zu den einzelnen Anwendungen entnehmen Sie bitte der jeweiligen Anwendungsdokumentation.
2 Begriffsbestimmung
Vertriebskanal
Weg, auf dem ein Artikel zum Verkauf angeboten wird. Ein Vertriebskanal kann zum Beispiel eine Filiale definieren, in welcher ein oder mehrere Kassen (Terminals) arbeiten.
Terminal
In Comarch ERP Enterprise entspricht ein Terminal einer Comarch Retail POS Installation. Das Terminal ist immer einem Vertriebskanal zugewiesen.
Comarch Retail POS
Comarch Retail POS ist eine Kassensoftware von Comarch. Sie wird i.d.R. auf einem Rechner in der Filiale installiert, hat eine eigene lokale Datenbank und kommuniziert über einen Webservice mit Comarch ERP Enterprise.
Update Agent
Der Update Agent von Comarch Retail POS, ermöglicht die Installation und Versionsverwaltung für die Kassensoftware.
Lizenz-Manager
Der Lizenzmanager von Comarch Retail POS verwaltet die Lizenzen für die Kassensoftware.
3 Prozesse
Im Folgenden wird die Anbindung eines Comarch Retail POS beschrieben. Diese Anbindung erfolgt durch den Adapter „Comarch Retail POS“. Eine allgemeine Einführung zu Vertriebskanälen finden Sie in der Dokumentation „Einführung: Multikanal-Vertrieb“.
Im ersten Teil werden die zusätzlichen Einstellungsmöglichkeiten bei der Erfassung und Bearbeitung von Vertriebskanälen zu Comarch Retail POS beschrieben. Der zweite Teil beschreibt die Datenübertragungen von und zum POS-Terminal.
3.1 Einstellungen
Der Adapter „Comarch Retail POS“ erweitert das Framework Multikanal-Vertrieb, um die Verbindung zum POS-Terminals zu ermöglichen. Die zusätzlichen Möglichkeiten zur Einstellung der Verbindung werden im folgenden Abschnitt beschrieben.
3.1.1 Erweiterung: Vertriebskanäle/Comarch Retail POS
Das Erfassen eines Vertriebskanals wird in der Dokumentation Vertriebskanäle beschrieben. Neben den dort beschriebenen allgemeinen Einstellungen müssen im Karteireiter „Comarch Retail POS“ weitere Einstellungen für den Adapter „Comarch Retail POS“ vorgenommen werden. Tragen Sie hier die Filiale ein, die zu diesem Vertriebskanal zugeordnet werden soll.
3.1.2 Comarch Retail POS Nummernkreise
In der Anwendung „Comarch Retail POS Nummernkreise“ ordnen Sie einer Dokumentart eines Vertriebskanals einen Nummernkreis in Comarch ERP Enterprise zu. Der Nummernkreis muss vom Typ „Comarch Retail POS“ sein. Für jedes Dokument, welches an der Kasse verwendet werden soll, muss ein Nummernkreis festgelegt werden. Daraus werden die Numeratoren für die Kassendokumente generiert.
3.1.3 Comarch Retail POS Terminals
Die einzelnen Kassen werden in der Anwendung „Comarch Retail POS Terminals“ konfiguriert. Dabei ist jede Kasse genau einem Vertriebskanal zugeordnet.
Es werden die Einstellungen für die Kasse definiert, zum Beispiel für Kassenschublade, Umsatzsteuer-Summen-Berechnung oder Schichten. Des Weiteren wird festgelegt, welche Zahlungsarten an der Kasse zur Verfügung stehen sollen und welche Benutzergruppen sich auf dem Terminal anmelden können.
3.1.4 Comarch Retail POS Berechtigungen
In der Anwendung „Comarch Retail POS Berechtigungen“ werden die Berechtigungen für die jeweilige Berechtigungsrolle angegeben. Eine Berechtigungsrolle wird wie gewohnt, den Benutzergruppen zugeordnet.
Die Berechtigungen umfassen u.a. den Zugriff auf Preislisten, die Vergabe von (manuellen) Rabatten und die Änderungen von Kundendaten an der Kasse.
Wichtig ist die Konfiguration der Berechtigungen für die einzelnen Objekte am Terminal. So kann beispielsweise ohne Berechtigungen für Kassenbelege an der Kasse kein Kassenbeleg ausgestellt werden.
3.1.5 Comarch Retail POS Ausdrucke
Für die einzelnen Dokumente, die an der Kasse erstellt werden, werden die Ausdrucke in Comarch ERP Enterprise über die Anwendung „Comarch Retail POS Ausdrucke“ zugeordnet. Damit kann global ein Ausdruck pro Dokument für alle Filialen oder einzelne Vertriebskanäle definiert werden.
Über die Hintergrundanwendung „POS Ausdrucke installieren“ können vorkonfigurierte Standard-Ausdrucke im KStore abgelegt werden. Layout und Inhalt kann danach individuell angepasst und auf die einzelnen Filialen verteilt werden.
3.1.6 Comarch Retail POS Attribute
Sollen neben den Varianten-Artikelmerkmalen auch weitere Felder oder Artikelmerkmale zur Kasse übertragen werden, kann dies in der Anwendung „Comarch Retail POS Attribute“ erfolgen. Einem Feld bzw. Merkmal in Comarch ERP Enterprise wird ein Attribut der Kasse zugeordnet.
Die Übertragung von weiteren Feldern ist auch für Kunden möglich.
3.1.7 Comarch Retail POS Konten-Zuordnungen
In der Anwendung „Comarch Retail POS Konten-Zuordnungen“ werden die Konten für die Buchungen nach Comarch Financials Enterprise konfiguriert. Wird CFE nicht verwendet, haben diese Einstellungen keine Auswirkung.
Konfiguriert werden die Kassenkonten, abhängig von Zahlungsart und Währung für jede Kasse.
Die Konten für Handelsdokumente werden für die Buchungen der Kassenbelege und deren Korrekturen verwendet.
Für die Buchungen der Transaktionen und Kassensitzungs-Transaktionen werden ebenfalls Konten hinterlegt.
Die Konfiguration von Anzahlungskonten wird auch in dieser Anwendung vorgenommen.
Des Weiteren muss für jede zu buchende Dokumentart der Kasse eine CFE-Belegart zugeordnet werden.
3.1.8 Comarch Retail POS Konfiguration Optionaler Dimensionen
In der Anwendung „Comarch Retail POS Konfiguration Optionaler Dimensionen“ werden optionale Dimensionen für die Buchungen nach Comarch Financials Enterprise konfiguriert. Wird CFE nicht verwendet, haben diese Einstellungen keine Auswirkung.
3.1.9 Comarch Retail POS Datenexport für Betriebsprüfung konfigurieren
In der Anwendung „Comarch Retail POS Datenexport für Betriebsprüfung konfigurieren“ werden die Export-Filter für den Datenexport gemäß GoBD festgelegt. Es können vorkonfigurierte Filter über die Hintergrundanwendung installiert werden. Wird CFE nicht verwendet, haben diese Einstellungen keine Auswirkung.
3.1.10 Erweiterung: Artikel
In der Anwendung „Artikel“ kann im Basis-Artikel unter der Ansicht „Comarch Retail POS“ im Reiter „Comarch Retail POS“ festgelegt werden, ob der Artikel ein Waage-Artikel ist.
3.1.11 Erweiterung: Partner
In der Anwendung „Partner“ können im Basis-Partner unter der Ansicht „Comarch Retail POS“ im Reiter „Comarch Retail POS“ Firmendaten wie beispielsweise Branche oder Handelsregisternummer hinterlegt werden. Auf diese Daten kann dann u.a. in den Ausdrucken an der Kasse zugegriffen werden.
3.1.12 Erweiterung: Währungen
In der Anwendung „Währungen“ können unter der Ansicht „Comarch Retail POS“ Stückelungen für jede Währung eingetragen werden. Diese Werte dienen dann an der Kasse zur Zählung der unterschiedlichen Banknoten und Münzen.
3.1.13 Erweiterung: Zahlungsarten
In der Anwendung „Zahlungsarten“ unter der Ansicht „Comarch Retail POS“ wird der Typ der Zahlungsmethode an der Kasse angegeben. Die bestimmt, wie die einzelnen Zahlungsarten an der Kasse behandelt werden, zum Beispiel ob ein EC-Terminal angesprochen wird oder Gutscheine eingelöst werden können.
3.1.14 Erweiterung: Lagerorte
In der Anwendung „Lagerorte“ unter der Ansicht „Comarch Retail POS“ wird festgelegt, ob der Lagerort für Handelsdokumente verwendet wird und ob es sich um ein Konsignationslager oder Warehouse Management System handelt.
3.1.15 Erweiterung: Nummernkreise
In der Anwendung „Nummernkreise“ unter der Ansicht „Comarch Retail POS“ kann ein Präfix angegeben werden, der am Comarch Retail POS für unbestätigte Dokumente verwendet werden soll.
3.1.16 POS Meine Zugangsdaten ändern…
Über die Hintergrundanwendung „POS Meine Zugangsdaten ändern…“ kann ein Benutzer sein Passwort oder PIN für die Anmeldung an der Kasse ändern. Danach muss die Hintergrundanwendung ” POS Kassenberechtigungen exportieren“ ausgeführt werden.
3.1.17 POS Zugangsdaten für Benutzer ändern…
Über die Hintergrundanwendung „POS Zugangsdaten für Benutzer ändern…“ kann für einen angegebenen Benutzer das Passwort oder die PIN für die Anmeldung an der Kasse geändert werden. Dies wird vor allem für die initiale Passwortvergabe genutzt. Danach muss die Hintergrundanwendung ” POS Kassenberechtigungen exportieren“ ausgeführt werden.
3.1.18 POS Ausdrucke installieren
Mit dem Adapter „Comarch Retail POS“ werden einige Basis-Ausdrucke bereitgestellt. Diese können über die Hintergrundanwendung „POS Ausdrucke installieren“ im KStore abgelegt werden.
Achtung: Bereits installierte und evtl. angepasste Ausdrucke können dabei überschreiben werden!
Ausgeliefert werden Basis-Ausdrucke für:
- Kassenbeleg
- Kassenbelegs-Korrektur
- Rechnung
- Rechnungs-Korrektur
- Tagesbericht
- Kasseneinzahlung
- Kassenauszahlung
- Reklamation
- Kassenbeleg Umtausch
- Rechnung Umtausch
- Vertriebsauftrag
- Vertriebsangebot
- Tagesübersicht
- Tagesabschluss
- Warenausgang
- Lagerbewegungsprotokoll
3.2 Datenübertragung und -verarbeitung
Für die Übertragung von Stammdaten und Belegen werden mehrere Anwendungen durch das Framework „Multikanal-Vertrieb“ bereitgestellt. Die Bedienung der Anwendungen, z. B. wie Sie eine regelmäßige Datenübertragung einstellen, wird in den jeweiligen Dokumentationen beschrieben.
Im Folgenden wird beschrieben wie sich die einzelnen Hintergrundanwendungen von den entsprechenden allgemeinen Hintergrundanwendungen des Frameworks „Multikanal-Vertrieb“ unterscheiden und welche Daten zwischen Comarch ERP Enterprise und Comarch Retail POS ausgetauscht werden.
3.2.1 POS Metadaten exportieren
Über die Hintergrundanwendung „POS Metadaten exportieren“ werden grundlegende Konfigurations- und Stammdaten für die Kassen generiert:
- Länder und Regionen
- Lager und Abholpunkte
- Währungen mit Umrechnungskursen und Stückelungen
- Zahlungsarten und deren Verfügbarkeit an den Kassen
- Einheiten
- Umsatzsteuersätze
- Dokumentarten und deren Numeratoren (Nummernkreise)
- Preistypen und –listen (Preis- oder Rabattwerte)
- Artikelmerkmale, Klassifikationen
- Konfiguration der Artikel- und Kundenattribute
- Filial- und Firmendaten
- Handelsperioden
- Ausdrucke
- Konfiguration der Terminals
Nach Änderungen im Vertriebskanal, in der Konfiguration der Terminals und den oben genannten Stammdaten, werden diese Änderungen erst für die Kassen bereitgestellt, wenn die Hintergrundanwendung „POS Metadaten exportieren“ ausgeführt wurde.
3.2.2 POS Kassenberechtigungen exportieren
Die Hintergrundanwendung „POS Kassenberechtigungen exportieren” generiert die Berechtigungsdaten für die Kassen. Dies betrifft:
- Benutzer und Benutzergruppen
- Berechtigungen auf den Kassen-Dokumentarten
- Passwörter und PIN für die Kassen-Logins
- sowie alle weiteren Einstellungen aus der Anwendung „Comarch Retail POS Berechtigungen“
Nach Änderungen in den Berechtigungen oder Benutzer(-gruppen)-Zuordnungen muss diese Hintergrundanwendung ausgeführt werden, um diese Aktualisierungen den Kassen bereitzustellen.
3.2.3 Artikel exportieren
Die Hintergrundanwendung „Artikel exportieren“ generiert POS-Daten für alle Artikel auf der Sortimentslistung des Vertriebskanals. Diese Daten können dann jederzeit von den Kassen abgerufen werden.
3.2.4 Artikel importieren
Die Hintergrundanwendung „Artikel importieren“ hat beim Adapter „Comarch Retail POS“ keine Auswirkung.
3.2.5 Artikelmerkmals-Klassifikationen exportieren
Die Hintergrundanwendung „Artikelmerkmals-Klassifikationen exportieren“ hat beim Adapter „Comarch Retail POS“ keine Auswirkung.
3.2.6 Artikelverfügbarkeit exportieren
Die Hintergrundanwendung „Artikelverfügbarkeit exportieren“ generiert die von der Anwendung „Cockpit: Vertriebskanal-Artikelverfügbarkeit“ bereitgestellten Lagermengen für alle Filialen. Um die Artikelverfügbarkeiten zu übertragen, muss die Bestandsführung in der Anwendung „Vertriebskanäle“ eingestellt sein. Weitere Informationen über die Bestandsführung lesen Sie in der Dokumentation zur Vertriebskanal-Bestandsführung.
Ein Verkauf an der Kasse ist auch ohne Artikelmengen an der Kasse möglich.
3.2.7 Artikelkategorien importieren
Die Hintergrundanwendung „Artikelkategorien importieren“ übernimmt keine Daten vom Comarch Retail POS und überträgt keine Daten zu Comarch Retail POS.
3.2.8 Artikelkategorien exportieren
Die Hintergrundanwendung „Artikelkategorien exportieren“ generiert keine Daten für Comarch Retail POS.
3.2.9 Kunden importieren
Die Hintergrundanwendung „Kunden importieren“ hat keine Funktion im Adapter Comarch Retail POS. Die Kunden werden importiert innerhalb der Hintergrundanwendung „Vertriebsaufträge importieren“.
3.2.10 Kunden exportieren
Die Hintergrundanwendung „Kunden exportieren“ generiert Kunden- und Adressdaten für Comarch Retail POS. Diese Daten können dann von den Kassen abgerufen werden.
3.2.11 Vertriebsaufträge importieren
Die Hintergrundanwendung „Vertriebsaufträge importieren” übernimmt alle Daten von POS aus der Warteschlange und importiert diese nach Comarch ERP Enterprise.
Importiert werden
- Kunden
- Handelsdokumente (Kassenbelege und Rechnungen sowie deren Korrekturen, Vertriebsaufträge sowie -angebote und Anzahlungen)
- Transaktionen (Kassenein- und -auszahlungen)
- Lagerdokumente
- Reklamationen
- und Kassensitzungen.
Eine Verarbeitung dieser Daten schließt sich wie folgt an:
- Kundendaten in CEE aktualisieren
- Materialbuchungen für Kassenbelege und deren Korrekturen
- Generierung einer Ausgangsrechnung für jede Kassenrechnung, die nicht nachträglich für einen Kassenbeleg ausstellt wurde.
- Generierung einer Ausgangsrechnung (Gutschrift) für jede Kassenrechnungs-Korrektur, die nicht nachträglich für einen Kassenbeleg ausstellt wurde.
- Generierung eines Vertriebsauftrages für jeden Auftrag.
- Generierung eines Vertriebsangebotes (nur B2B) für jedes Angebot.
- Generierung einer Kundenrücksendung für Reklamationen.
3.2.12 Vertriebsauftragsänderungen exportieren
Die Hintergrundanwendung „Vertriebsauftragsänderungen exportieren” übermittelt den Status der Reklamationen, die an der Kasse aufgenommen und in CEE weiter verarbeitet wurden. Des Weiteren werden Vertriebsaufträge aus anderen Vertriebskanälen (auch ERP selbst) mit Selbstabholung oder Versandlager eines POS-Vertriebskanals an die entsprechenden Kassen gesendet.
3.2.13 Vertriebspreislisten exportieren
Die Hintergrundanwendung „Vertriebspreislisten exportieren“ übermittelt die Artikelpreise und Rabatte an die Kasse. Es werden nicht alle Arten von Preiseinträgen und Rabatteinträgen vom Comarch Retail POS unterstützt.
Im zweiten Schritt überträgt die Hintergrundanwendung „Vertriebspreislisten exportieren“ die Vertriebspreislistung, die Sie in der Anwendung „Vertriebskanäle“ in Feld „Vertriebspreis-Listung“ angegeben haben.
- Der Standardpreis wird aus dem aktuell gültigen Artikelpreis in der Vertriebseinheit und der Währung des Vertriebskanals berechnet. Es können Artikelpreise oder Artikelpreis-Klassifikationen zur Preisbestimmung verwendet werden.
- Staffelpreise werden unterstützt.
- Kundenspezifische Preise werden auf Basis der Referenz zu einem Kunden oder einer Kundenpreis-Klassifikationen berechnet.
- Die Mehrwertsteuer wird anhand der Mehrwertsteuer-Klassifikation und der Ausgangssteuer-Klassifikation der Filiale berechnet. Die Auswahl des richtigen Steuer-Schlüssels erfolgt durch die Zuordnungen in der Anwendung „Steuer-Zuordnungen“.
Folgende Rabatte werden zur Kasse übertragen:
- Preis- und prozentuale Rabatte bezogen auf Artikel und Artikelpreis-Klassifikationen.
- Preis- und prozentuale Rabatte für Kunden und in Bezug auf Kundenpreis-Klassifikationen.
Die Benutzer an der Kasse können auch manuelle Rabatte vergeben. Der maximal zulässige manuelle Rabatt wird in der Anwendung „Comarch Retail POS Berechtigungen“ konfiguriert und über die Hintergrundanwendung „POS Kassenberechtigungen exportieren“ exportiert.
3.2.14 POS Lagerdokumente aktualisieren
Die Hintergrundanwendung „POS Lagerdokumente aktualisieren“ generiert die Lagerdokumente für die Kassen. Sollen über einen Verteilauftrag Waren an ein Filiallager gesendet werden, werden zu den dazugehörigen Wareneingänge Lagerdokumente erstellt. Diese können dann von der Kasse abgerufen werden, um dann später den tatsächlichen Wareneingang in der Filiale zu protokollieren.
3.2.15 POS Kassenabrechnungen in CFE buchen
Wenn im System Comarch Financials Enterprise zur Verfügung steht, können die Handelsdokumente nach CFE verbucht werden. Auf Basis der Konten-Zuordnungen in der Anwendung „Comarch Retail POS Konten-Zuordnungen“ werden die Kassenbelege und deren Korrekturen auf die Konten in CFE gebucht.
3.2.16 POS GoBD Export Filter installieren
Für den Export von Kassendaten gemäß GoBD werden vorkonfigurierte Export-Filter ausgeliefert. Über diese Hintergrundanwendung können diese importiert werden.
3.2.17 POS Daten gemäß GoBD exportieren
Der Export von Kassendaten gemäß GoBD erfolgt über diese Hintergrundanwendung.
3.3 Cockpits
Für den Adapter „Comarch Retail POS“ stehen zahlreiche Cockpits zur Datenanalyse zur Verfügung. Damit können die einzelnen Vorgänge an den Kassen in CEE eingesehen werden.
3.3.1 Cockpit: POS-Handelsdokumente
Das Cockpit “Cockpit: POS-Handelsdokumente“ zeigt an der Kasse ausgestellten und nach Comarch ERP Enterprise importierten Handelsdokumente:
- Kassenbelege
- Kassenbelegskorrekturen
- Rechnungen
- Rechnungskorrekturen
- Anzahlungsrechnungen
- Anzahlungsrechnungskorrekturen
3.3.2 Cockpit: POS-Handelsdokumente/Positionen
Das Cockpit “Cockpit: POS-Handelsdokumente/Positionen“ zeigt alle Positionen der an der Kasse ausgestellten und nach Comarch ERP Enterprise importierten Handelsdokumente.
3.3.3 Cockpit: POS-Handelsdokumente/Zahlungen
Das Cockpit “Cockpit: POS-Handelsdokumente/Zahlungen“ zeigt alle Zahlungen zu den an der Kasse ausgestellten und nach Comarch ERP Enterprise importierten Handelsdokumente.
3.3.4 Cockpit: POS-Aufträge und Angebote
Das Cockpit “Cockpit: POS-Aufträge und Angebote“ zeigt an der Kasse ausgestellten und nach Comarch ERP Enterprise importierten Handelsdokumente:
- Vertriebsaufträge
- Vertriebsangebote
3.3.5 Cockpit: POS-Aufträge und Angebote/Positionen
Das Cockpit “Cockpit: POS-Aufträge und Angebote/Positionen“ zeigt alle Positionen der an der Kasse ausgestellten und nach Comarch ERP Enterprise importierten Vertriebsaufträge und -angebote.
3.3.6 Cockpit: POS-Kassenein- und -auszahlungen
Das Cockpit “Cockpit: POS-Kassenein- und -auszahlungen“ zeigt alle Kassenein- und -auszahlungen die an der Kasse ausgestellt und nach Comarch ERP Enterprise importiert wurden.
3.3.7 Cockpit: POS-Reklamationen
Das Cockpit “Cockpit: POS-Reklamationen“ zeigt alle Reklamationen die an der Kasse ausgestellt und nach Comarch ERP Enterprise importiert wurden. Wurde eine Kundenrücksendung generiert, ist diese im Cockpit referenziert.
3.3.8 Cockpit: POS-Lagerdokumente
Das Cockpit “Cockpit: POS-Lagerdokumente“ zeigt alle Lagerdokumente die in Comarch ERP Enterprise oder an der Kasse ausgestellt und nach Comarch ERP Enterprise importiert wurden. Der ursprüngliche Verteilauftrag und Wareneingang sind referenziert.
3.3.9 Cockpit: POS-Lagerdokumente/Positionen
Das Cockpit “Cockpit: POS-Lagerdokumente/Positionen“ zeigt alle Positionen der Lagerdokumente. Die Lagerdokumente umfassen sowohl die in Comarch ERP Enterprise als auch die an der Kasse erstellten und synchronisierten.
3.3.10 Cockpit: POS-Kassensitzungen
Das Cockpit “Cockpit: POS-Kassensitzungen“ zeigt alle synchronisierten Kassensitzungen von Comarch Retail POS.
3.3.11 Cockpit: POS-Kassensitzungen/Positionen
Das Cockpit “Cockpit: POS-Kassensitzungen/Positionen“ zeigt alle synchronisierten Elemente aus Kassensitzungen von Comarch Retail POS, beispielsweise Kasseneinzahlung bei Tagesöffnung, Kassenauszahlung bei Tagesabschluss, Kassensaldi und evtl. Differenzen.
3.3.12 Cockpit: POS-Importverlauf
Das Cockpit “Cockpit: POS-Importverlauf“ zeigt alle von Retail POS importierte Datensätze. Fehlerhaft importierte Datensätze können ausgewählt und erneut in die Import-Warteschlange eingereiht werden.
4 Konfiguration
Bei der Installation der Kassensoftware von Comarch Retail POS folgen Sie der Installationsanleitung von Comarch Retail POS. Im Folgenden werden auf die Besonderheiten bei Konfiguration in Zusammenhang mit Comarch ERP Enterprise eingegangen.
4.1 Webservice
Der Datenaustausch zwischen Comarch ERP Enterprise und der Kasse von Comarch Retail POS erfolgt über einen Webservice, der von CEE bereitgestellt und von POS aufgerufen wird.
In der Konfigurationsdatei von POS, der POS2.exe.config, werden die Webservice-Adresse sowie die zu verwendende OLTP-Datenbank von CEE eingetragen. Im folgend angegebenen Beispiel sind die rot markiert Element entsprechend zu ersetzen.
<client>
<endpoint adress=”https://app540dv.cisag.com/services/rest/com.sem.ext.app.pos.sync.rest.POSService/?oltp=APP540DV05″
behaviorConfiguration=”webHttpBehavior”
binding=”webHttpBinding”
bindingConfiguration=”webHttp”
contract=”Comarch.B2.DataService.Contracts.IDataService”
name=”DataServiceREST”>
<identity>
<dns value=”app540dv.cisag.com” />
</identity>
</endpoint>
</client>
Achtung: In Comarch Retail POS sollte die Konfiguration des Webservices nicht über den in POS zur Verfügung stehenden Dialog erfolgen. Dieser berücksichtigt u.a. nicht die OLTP für CEE. Daher wird aktuell die manuelle Konfiguration in der POS2.exe.config empfohlen.
4.2 Zertifikat
Die Synchronisation zwischen Comarch ERP Enterprise und der Kasse von Comarch Retail POS erfolgt über ein CEE-Benutzer-Zertifikat, welches auch für die Anmeldung an Comarch ERP Enterprise genutzt werden kann. Dieses Zertifikat muss auf dem Rechner der Kasse in eigenen Zertifikat-Store für den aktuellen Nutzer installiert sein.
Das Zertifikat muss in der Konfigurationsdatei von POS, der POS2.exe.config angegeben werden. In dem angegeben Beispiel muss “MUST01″ mit dem tatsächlichen Zertifikat ersetzt werden.
<behaviors>
<endpointBehaviors>
<behavior name=”webHttpBehavior”>
<webHttp/>
<clientCredentials>
<clientCertificate findValue=”MUST01″
storeLocation=”CurrentUser”
storeName=”My”
x509FindType=”FindBySubjectName”/>
</clientCredentials>
</behavior>
</endpointBehaviors>
</behaviors>
Es muss sichergestellt sein, dass es an der Kasse in diesem Zertifikat-Store nur ein Zertifikat mit diesem Namen gibt.
Der Benutzer in Comarch ERP Enterprise für den dieses Zertifikat ausgestellt wurde, muss die Erlaubnis für SOAP-Zugriff haben. Diese Einstellung wird im Systemcockpit unter „System“ è „Benutzer-Zuordnungen“ gemacht.
4.3 Beispiel Webservice-Konfiguration
Das folgende Beispiel eine komplette Konfiguration des Webservices. Rot markierte Inhalt sollten angepasst werden.
<system.serviceModel>
<client>
<endpoint address = “https://app540dv.cisag.com/services/rest/com.sem.ext.app.pos.sync.rest.POSService/?oltp=APP540DV05″
behaviorConfiguration=”webHttpBehavior”
binding=”webHttpBinding”
bindingConfiguration=”webHttp”
contract=”Comarch.B2.DataService.Contracts.IDataService”
name=”DataServiceREST”>
<identity>
<dns value=”app540dv.cisag.com” />
</identity>
</endpoint>
</client>
<behaviors>
<endpointBehaviors>
<behavior name=”webHttpBehavior”>
<webHttp/>
<clientCredentials>
<clientCertificate findValue=”MUST01″
storeLocation=”CurrentUser”
storeName=”My”
x509FindType=”FindBySubjectName”/>
</clientCredentials>
</behavior>
</endpointBehaviors>
</behaviors>
<bindings>
<webHttpBinding>
<binding name=”webHttp” allowCookies=”true”
maxBufferSize=”2147483647″
maxBufferPoolSize=”2147483647″
maxReceivedMessageSize=”2147483647″ >
<readerQuotas maxDepth=”2147483647″
maxStringContentLength=”2147483647″
maxArrayLength=”2147483647″
maxBytesPerRead=”2147483647″
maxNameTableCharCount=”2147483647″ />
<security mode=”Transport”>
<transport clientCredentialType=”Certificate” />
</security>
</binding>
</webHttpBinding>
</bindings>
</system.serviceModel>
<system.net>
<settings>
<servicePointManager expect100Continue=”false” />
</settings>
</system.net>
</configuration>
4.4 POS-Datenbank
Die Kassensoftware Comarch Retail POS arbeitet auf einer eigenen lokalen Datenbank. Die Verbindungsparameter zu dieser Datenbank werden ebenfalls in der POS2.exe.config hinterlegt.
<connectionStrings>
<add name=”POSDBContext”
connectionString=”Data Source=PCMUSTERMANN\SQLEXPRESS;
Initial Catalog=POSDBKasse1;
Integrated Security=True;
MultipleActiveResultSets=True”
providerName=”System.Data.SqlClient” />
</connectionStrings>
Die rot markierten Felder müssen ersetzt werden mit den tatsächlichen Daten, wobei Data Source dem Datenbank-Server (mit der POS-Datenbank) und Initial Catalog dem Namen der POS-Datenbank entspricht. Integrated Security wird auf true gesetzt, wenn der Login mit dem integrierten Windows-Benutzer erfolgen soll.
4.5 Kassenidentifikation
In der POS2.exe.config wird eingetragen, um welche Kasse es sich handelt. Dabei entspricht der PosCode in der POS2.exe.config dem Code des in Comarch ERP Enterprise konfigurierten Terminals.
Die Einstellung erfolgt im Abschnitt appSettings:
<appSettings>
…
<add key=”PosCode” value=”K1″ />
…
</appSettings>
4.6 Weitere Einstellungen
Folgende ausgewählte weitere Einstellungen in den appSettings der POS2.exe.config sind zu beachten und ggf. anzupassen.
Feld/Funktion | Erläuterung |
LotPicturesDirectory | Verzeichnis, in dem die Artikelbilder gespeichert werden sollen
<add key=”LotPicturesDirectory” value=”D:\POS2.0\ProductsPictures” /> |
PrintoutsDirectory | Verzeichnis, in dem die Ausdrucke gespeichert werden sollen
<add key=”PrintoutsDirectory” value=”D:\POS2.0\Printouts” /> |
LayoutsDirectory | Verzeichnis, in dem die (angepassten) Layouts der Kassen-Benutzeroberfläche gespeichert werden sollen
<add key=”LayoutsDirectory” value=”D:\POS2.0\Layouts” /> |
PDFPrintoutsDirectory | Verzeichnis, in dem Dateianhänge, z.B. Rechnungs-PDFs, lokal gespeichert werden.
<add key=”PDFPrintoutsDirectory” value=”D:\POS2.0\PDFs” /> |
LoggingDirectoryPath | Verzeichnis, in dem die Log-Dateien der Kasse gespeichert werden sollen
<add key=”LoggingDirectoryPath” value=”D:\POS2.0\Logs” /> |
SaveSwapFiles | Ist dieser Werte auf TRUE gesetzt, werden alle synchronisierten XML-Dateien auf dem Kassen-Rechner im LoggingDirectoryPath gespeichert. Zu Testzwecken wird empfohlen, dies zu aktivieren.
<add key=”SaveSwapFiles” value=”true” /> |
5 Customizing
Für die Adapter „Comarch Retail POS“ ist in der Anwendung „Customizing“ die folgende Einstellung in der Funktion „Comarch Retail POS“ relevant.
Feld/Funktion | Erläuterung |
Aktiv | Damit die Adapter „Comarch Retail POS“ genutzt werden kann, muss diese Funktion für den Mandanten aktiviert sein. |
Comarch Retail POS Lizenzserver | Url des Comarch Retail POS Lizenzservers, z.B. http://127.0.0.1/LicenseCalculator/service |
Comarch Retail POS Lizensschlüssel | Lizenzschlüssel für Comarch Retail POS |
Finanzbuchhaltung verwenden | Gibt an, ob Comarch Financials Enterprise zur Finanzbuchhaltung verwendet wird. Damit werden bei der Konfiguration evtl. zusätzliche Validierungen durchgeführt. |
Nummernkreis Sammelbuchungen | Gibt an, welcher Nummernkreis für die Generierung der Belegnummer bei Sammelbuchungen verwendet werden soll. |
Verzeichnis für importierte Dateianhänge | In diesem KStore-Verzeichnis werden Datei-Anhänge von den Kassen zwischengespeichert. |
Verzeichnis für GoBD-Export | Geben Sie ein Verzeichnis im KStore an, das für Export der Kassendaten gemäß GoBD genutzt werden soll. |