EN - english:
operate Amadeus360 POS system by interface (AOI) and execute structured commands (ASQL).
For development please look up Amadeus Order Interface AOI and ASQL for development : Gastro-MIS GmbH

 

DE - deutsch:
die Tischlogik von Amadeus360 Kasse per Schnittstelle (AOI) nutzen und mit strukturierten Befehlen (ASQL) steuern.
Für die Entwicklung lesen sie bitte Amadeus Order Interface AOI and ASQL for development : Gastro-MIS GmbH 



TOC / INHALTSVERZEICHNIS



EN: summary in english

local Amadeus Order Interface @localhost AOI is deprecated in AmadeusIII server. Following our development timeline we will switch to AmadeusIII server in Q2/2023.
Please migrate to Amadeus360 Third Party API- POS interface in time.
All ASQL commands are available, the POS interface improves stability and security.
For further questions please contact out support team.


The Amadeus Order Interface (AOI) is a webinterface to operate the Amadeus II POS system. Operations are executed using the Amadeus Structured Query Language (ASQL), defining the syntax use by the AOI. The AOI is a fully featured POS - terminal used by our own clients like ATouch 2 or Orderman 7.


basic usage and setup

To interact with the AOI a POS-terminal needs to be created in the Amadeus II backoffice. The serial number (Seriennummer) ist important. It identifies the AOI-instance throughout the whole process. To get you started, all settings should be made as shown below. 

After a reboot of the correspoding ACF, the AOI is available. 


ASQL request and response

To check the setup, open a Webbrowser like Chrome and open the following URL:

http://localhost:1410

If everything is correct, you should get the following webpage: 


To talk the AOI from your application you can set GET requests to the AOI like you address every webpage. You must always use the serial number you entered during the first step. To query the status of the POS-terminal, submit the following request:

http://localhost:1410/?sno=1234&asql=status

There are always two parameters:

  • sno: the serial number.
  • asql: the ASQL-phrase you wanna execute.

The answer from the AOI is always an xml file. The structure of this file is discussed in the following sections.



DE: Übersicht in Deutsch

Das lokale Amadeus Order interface @localhost AOI ist abgekündigt mit Amadeus III Server. Gemäß Entwicklungszeitplan wird der Wechsel in Q2/2023 sein.
Bitte migrieren sie rechtzeitig zur Amadeus360 Third Party API - POS Schnittstelle.
Alle ASQL Befehle sind verfügbar, die neue POS Schnittstelle erweitert die Stabilität und Sicherheit.
Für weitere Fragen wenden sie sich bitte an unseren Support.


Das Amadeus Order Interface (AOI) ist ein Webinterface über das alle Kassenfunktionen gesteuert werden können. Dazu nötig ist die Amadeus Structured Query Language (ASQL), welche den zu verwendenden Befehlssatz festlegt. Über das AOI können sämtliche Funktionen ausgeführt werden, welche auch an einem normalen Kassenplatz wie der ATouch 2 oder dem Orderman 7 ausgeführt werden können. Tatsächlich nutzt die ATouch 2 das AOI für alle Funktionen.

Grundlegende Funktionsweise und Einrichtung

Um auf das AOI zugreifen zu können muss zunächst über das Amadeus II Backoffice ein Kassenplatz angelegt werden. Dabei wird eine Seriennummer vergeben sowie als Art der Kasse "Webkasse" ausgewählt.

Seriennummer und Lizenz

Pro Kassenplatz/Eingabeplatz sollte eine eigenes AOI mit eigener Seriennummer angelegt werden.

Nach Neustart des zugehörigen ACFs steht das AOI zur Verfügung. 


ASQL Aufruf und Antwort

Um die Grundfunktionalität zu überprüfen, können sie einen beliebigen Webbrowser öffnen und folgende URL aufrufen:

http://localhost:1410

Ist alles richtig konfiguriert so sollten sie das folgende Bild erhalten:

Um das AOI aus einer Anwendung heraus an sprechen zu können, müssen ASQL-Befehle als GET-Parameter an die oben genannte Adresse geschickt werden. Damit muss immer die im Backoffice vergebene Seriennummer der Kasse angegeben werden. Um z.B. den Status der Kasse abzufragen wir folgende URL aufgerufen:

http://localhost:1410/?sno=1234&asql=status

Ein Request an das AOI hat immer zwei Parameter:

  • sno: Die Seriennummer des Gerätes, das genutzt werden soll.
  • asql: Der ASQL-Befehl, der ausgeführt werden soll. 

Die Antwort vom AOI ist immer eine XML-Datei. Der Aufbau der XML-Datei wird in den folgenden Abschnitten eingehend besprochen. 


Berechtigung

Für die entsprechenden Funktionen (z.B. Storno = CANCEL PLU) muss der verwendete Kellner die passenden Berechtigungen haben.