Gastro-MIS GmbH

In Amadeus II wurde die KOST Schnittstelle eingebunden. Die Schnittstelle dient dazu, die bereitgestellten Stammdaten von KOST nach AmaII zu importieren und die Umsatzdaten aus AmaII zu exportieren, damit KOST diese Daten einlesen kann. 

Diese Schnittstelle ist geeignet für LINA POS Server L2 bis Version 1.6.4

Backoffice Einstellung

Im Backoffice muss eine neue Schnittstelle als Typ "KOST" eingestellt werden.

Darin ist Nachfolgendes einzustellen:

• Kundennummer (kann beliebig gewählt werden)
• Pfad (wo die Importdateien zu finden sind)
• Update Intervall (nach welchem Intervall automatisch aktualisiert werden soll)
• Kostenstellen (entnimmt man den Export-Daten von KOST) inkl. zugehöriger Verkaufsstellen und Angebot.
• Durch Aktivieren der Checkbox "Offener Preis nicht überschreiben" in der KOST-Schnittstelle, wird die Checkbox eines "offenen Preis Artikels" nicht mehr deaktiviert, sondern bleibt aktiv.  

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

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 Storno und Rabatten für den Export korrekt gesetzt werden.

• Zu beachten gilt es, dass die entsprechende 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/Hashtag (#) kommentiert überflüssige Zeilen aus, damit diese nicht herausgenommen 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.

Dateiaufbau für Stammdatenexport

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

Aufbau der Stammdaten

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

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

Beschreibung der Felder

Template für Artikel

Die KOST-Warenwirtschaft hat nicht alle Informationen für die Kasse verfügbar. Daher werden folgende Einstellungen 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

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];

Beschreibung der Felder

Dateiaufbau für Umsatzdatenimport

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];

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.