Gastro-MIS GmbH

INHALTSVERZEICHNIS

• Anlegen
• ElPay
• Velox
• Import/Export
• Protel
• GastroDat
• Hope
• Hotline
• IDEA
• KOST
• BOOK
• BANKETT
• CZSNEU
• FidelioSmall
• FiasStandard
• Amadeus360 Order Interface
• BillUpload

Schnittstellen verbinden das Kassensystem mit einem externen System um Daten auszutauschen. 

Aktuell verfügbare Schnittstellen Stand Version 1.6.0: 
- Amadeus Bon (BillUpload): AmadeusBon in 360

Schnittstellen anlegen

Home > Stammdatenverwaltung > Schnittstelle

Zum anlegen auf das "+" Zeichen klicken

• Nummer und Name eintragen
• Checkbox "Aktiv" setzten
• Beschreibung bei Bedarf eintragen
• Typ per Dropdown wählen
  • ELPay
  • Velox
  • Import/Export
  • Protel
  • GastroDat
  • Hope
  • Hotline
  • IDEA
  • KOST
  • BOOK
  • BANKETT
  • CZSNEU
  • FidelioSmall
  • FiasStandard
  • Amadeus 360 Order Interface
  • BillUpload
• ACF per Dropdown wählen

Abschließend auf "speichern" klicken

ElPay

Weitere Einstellung im Zahlungsprovider nötig

Velox

Finanzweg für Hotelprogramm einstellen

Import/Export

Ist als Standard installiert. Keine weitere Einstellung nötig

Protel

Finanzweg für Hotelprogramm einstellen

GastroDat

Finanzweg für Hotelprogramm einstellen

Hope

Finanzweg für Hotelprogramm einstellen

Hotline

Finanzweg für Hotelprogramm einstellen

IDEA

Keine weitere Einstellung nötig

KOST

• Kundennummer eingeben ( kann beliebig eingegeben werden )
• Pfad ( Hier wird der Pfad für den Ordner des Datenaustausch angegeben )
• Updates alle X Minuten : Zeit Einstellung des Datenaustausch
• Checkbox " Offenen Preis nicht überschreiben" bei Bedarf setzten

Hinzufügen der Kostenstellen durch klicken auf "Hinzufügen"

WICHTIGE PUNKTE:

1. Jede Warengruppe einer Kostenstelle muss mit gleicher Nummer als auch dem gleichen Namen der KOST-Datei in Form eines MEC-Codes in Amadeus II angelegt sein. Außerdem muss jeder dieser MEC-Codes einen "Default Artikel" beinhalten, der im Falle von "fehlenden Daten" seitens der von KOST zur Verfügung gestellten Import-Datei mit "Default-Werten" für den zutreffenden Artikel gesetzt werden kann. 
2. In den Stammdaten seitens KOST darf die Artikelbezeichnung kein Semikolon (Strichpunkt) enthalten! Dies würde dazu führen, dass der Import nicht durchgeführt werden kann.

Einrichten der Aufgabe für den Export der Umsatzdaten  

Folgende Einstellungen müssen lokal auf dem Kassenserver gemacht werden

Damit die Daten alle X-Minuten aus der Kasse exportiert werden, und KOST diese einlesen kann, bedarf es einer Aufgabe. Die benötigte Aufgabe findet man hier Amadeus II Kost Export.xml (eingestellter Pfand unbedingt überprüfen) und verweist cron_jobs Datei "kost_export" im Reporting Verzeichnis. Sobald der Export das erste Mal gelaufen ist, finden sich die Export-Daten im Reporting Verzeichnis unter ..\do_not_copy\file\kost.

Rabatte/Hausbons festlegen

Im File "kost_export.php" (..\AmadeusII\apache\htdocs\cron_jobs) müssen die Rabatte/Hausbons explizit auf Finanzwege festlegt werden, damit die Anzahl bei Stornos und Rabatten für den Export korrekt gesetzt werden.

• Zu beachten gilt es, dass die entsprechenden Finanzwegnummer in den eckigen Klammern gesetzt sind (sollte die Anzahl der vorhandenen Zeilen nicht ausreichen, kann eine weitere Zeile manuell hinzugefügt werden): z.B. $art[61] = "P"; 
  Der Lattenzaun/Hash-tag (#) kommentiert überflüssige Zeilen aus, damit diese nicht raus genommen werden müssen.
  
  
• In den Gänsefüßchen muss die zutreffenden Bonierungsarten gesetzt sein (Buchstabe): 
  “V“ = Verkauf
  “P“ = Personalverbrauch
  “E“ = Eigenverbrauch
  “R“ = Repräsentation
  “S“ = Schwund.

Schnittstellenbeschreibung

Nachfolgend findet man die Schnittstellenbeschreibung.

1 Dateiaufbau für Stammdatenexport

 1.1 Allgemeines

Für den Export von Verkaufsartikeln zu Amadeus II müssen zwei Dateien im CSV-Format

zur Verfügung gestellt werden:

Stammdaten.csv

Zuordnungen.csv

 1.2 Aufbau der Stammdaten

[PluNr];[Name1];[Name2];[Name3];[Beschreibung];[Warengruppe];[Artikelcode];[WGID];

[ButtonText];[DruckerText];[Kurzbezeichnung];[Auslagenartikel];[FreierPreis];[Kontrollartikel];[TouchPrio];[Zwangsartikel];[KeinRabatt];[FreierText];[Hinweis];[Waagenartikel];[Tara]

 1.2.1 Beschreibung der Felder

Folgende Einstellungen werden vom niedrigsten Artikel innerhalb eines MEC-Codes beim Import neuer Artikel übernommen:

• Feinsparten
• Splitten immer erlaubt
• Minus Preis bei Tender erlaubt
• Artikel gesperrt, Mengenkontrolle aktiv
• Aktuell verfügbare Menge
• Benachrichtigungsmenge
• Standardmenge verwenden
• Standardmenge nach Tagesabschluss
• Bon 1-5
• MenüBon
• Schankfunktion
• provisionsfrei
• rabattfähig
• Offener Preis
• Gewichtsartikel
• Fax
• Stornogrund
• Tender anzeigen
• Druckverzögerung aktiv
• Tenderartikel MEC
• Tenderartikel
• Tenderartikel Ausschluss
• Verkettete Artikel

 1.3 Aufbau der Zuordnungen

[PLUNr];[Kostenstelle];[VerkaufsSparte];[Preis1];[Preis2];[Preis3];[Preis4];[Preis5];[Preis6];[Preis7];[Preis8];[Preis9];[Preis10];[Preis11];[Preis12];[Preis13];[Preis14];[Preis15];[Preis16];[Preis17];[Preis18];[Preis19];[Preis20];[KRA];[KDB];[KWES];[Verkauf];[Kassaartikel];[MwSt];

 1.3.1 Beschreibung der Felder

2 Dateiaufbau für Umsatzdatenimport

 2.1 Aufbau der Umsatzdaten

Die Datei besteht aus einzelnen Zeilen, wobei jede Zeile aus mehreren Spalten besteht, welche durch einen Strichpunkt getrennt sind. Hierbei ist folgender Aufbau zwingend vorgeschrieben:

Umsatzdaten.csv

[Datum];[Kassenbezeichnung];[PluNr];[Menge];[GesamtPreis];[Bonierungsart];

 und optional

[Rechnungsnummer];[KOST-Kundennr];[Einzelpreis];[Steuersatz];

 2.1.1 Beschreibung der Felder

Erweiterung Kost-Schnittstelle (ab Version 1.4.0)

• Es können jetzt mehrere Kostenstellen, Verkaufsstellen und Angebot aus Kost importiert werden. 
• Beim Export der Umsatzdaten nach Kost wird als "Name der Kasse" jetzt die Betriebsstelle übertragen
• Beim Export der Umsatzdaten nach Kost können Schwund/Eigenverbrauch/Personal und Repräsentation jetzt gesondert ausgewiesen werden. Die Nummern der dazu gehörenden Finanzwege müssen in der Datei Cron_jobs/kost_export.php eingetragen werden. Dazu die Datei mit einem Editor öffnen und in den Zeilen 38 - 41 in die eckigen Klammern die Nummer des Finanzweges schreiben. Immer nur eine Zahl pro Klammer. 

BOOK

PEM-Datei eintragen

Ladennummer eintragen

URL eintragen

BANKETT

URL eintragen

Username eintragen

Passwort eintragen

Timeout (Sek) eintragen

Update alle X Minuten  eintragen

CZSNEU

COM-Port im Dropdown auswählen

Bautrate im Dropdown auswählen

Kasse im Dropdown auswählen

Karrenzzeit eintragen

Gerätenummer eintragen 

FidelioSmall

IP Adresse des Fidelio Server eintragen

Port  der Kommunikation eintragen

Chekbox "Übertragung von nicht-Fidelio Abrechnungen"  bei Bedarf setzten. Ist diese Checkbox aktiv, so werden alle NICHT Hotelbuchungen (alles was nicht zu Fidelio transferiert wurde) mit dem Tagesabschluss nach Fidelio übergeben. 

TIP/Auslage Finanzweg als Nummer aus den Finanzwegen eintragen. Sobald ein Artikel, der mit der hier eingestellten Finanzwegnummer verknüpft ist und in einem Tisch vorkommt, wird dieser als Trinkgeld (TIP) nach Fidelio übermittelt 

Finanzweg für die Zimmerzahlungen im Dropdown Menü auswählen

Jetzt müssen die MEC-Code Gruppen noch eingetrage werden für die "Nicht Fidelo Übertragung"

Durch klicken auf "hinzufügen" kann die MEC Code Gruppe ausgewählt werden und die gemappte Nummer in Fidelio eingetragen werden

Abschließend auf "speichern" klicken

!!! WICHTIG !!!
Die Verkaufsstelle wird immer mit einer Nummer höher übermittelt. D.h. wenn die Verkaufsstelle mit der Nummer 10 angelegt ist, so wird die Nummer 11 zur Hotelsoftware übermittelt.

FiasStandard

IP Adresse des Fias-Server eintragen

Port  der Kommunikation eintragen

Chekbox "Übertragung von nicht-Fias Abrechnungen"  bei Bedarf setzten. Ist diese Checkbox aktiv, so werden alle NICHT Hotelbuchungen (alles was nicht zu Fidelio transferiert wurde) mit dem Tagesabschluss nach Fidelio übergeben. 

TIP/Auslage Finanzweg als Nummer aus den Finanzwegen eintragen. Sobald ein Artikel, der mit der hier eingestellten Finanzwegnummer verknüpft ist und in einem Tisch vorkommt, wird dieser als Trinkgeld (TIP) nach Fidelio übermittelt 

Finanzweg für die Zimmerzahlungen im Dropdown Menü auswählen

Jetzt müssen die MEC-Code Gruppen noch eingetrage werden für die "Nicht Fidelo Übertragung"

Durch klicken auf "hinzufügen" kann die MEC Code Gruppe ausgewählt werden und die gemappte Nummer in Fidelio eingetragen werden

Amadeus360 Order Interface

Kasse im Dropdown auswählen

API-Key eintragen

URL eintragen

Webrequest-URL eintragen

BillUpload

URL eintragen

Timeout ( in Millisekunden ) eintragen