Umsatzdaten Allgemein
Um die Endpunkte der Umsatzdaten abzufragen lautet die Basis-URL wie folgt:
http://login.amadeus360.de/extern/revenue
Um auf den Endpunkt Umsatzdaten zugreifen zu können geben Sie bei der Autorisierung bitte den Scope "revenuejournal_read" an.
Endpunkte auflisten (authentifiziert)
Um die Endpunkte für die Warenwirtschaft aufzulisten, gibt es eine Indexseite.
Aufruf:
GET http://login.amadeus360.de/extern/revenue/index
Es sind keine weiteren Header oder Parameter notwendig.
Antwort-Beispiel:
[
{
"url": "http://login.amadeus360.de/extern/revenue/journal"
}
]
Verfügbare Tage
Liefert die in Amadeus360 verfügbare Tage mit Bewegungsdaten der Kasse
Aufruf:
GET http://login.amadeus360.de/extern/revenue/listdays
Beispielantwort:
[ { "businessdate": 1379628000, "zcount": 1 } ]
Kassenjournal (authentifiziert)
Abfragen
Um die Journale abzufragen muss das Geschäftsdatum übergeben werden.
Aufruf:
GET http://login.amadeus360.de/extern/revenue/journal?businessdate=14.08.2019
Antwort-Beispiel:
[ { "ID": 12345, "datum": "1565801225", "refdate": "1565733600", "art": "0,5 COLA LIGHT", "artnr": "201", "preis": "4.5", "zahl": "1", "tisch": "3", "ust": "19", "kellnernr": "6", "finanzweg": "1", "buchungsnr": "0", "tableheader_id": "544306", "am_id": "143904", "balance": "4.5", "terminal": "12", "masterkellnernr": "0", "teamnr": "0", "zcount": "1262", "parentid": "0", "site": "0", "situation": "0", "sortorder": null, "addinfo": "", "rabatt_id": "0", "pricelevel_id": "1", "operationprofile_id": "2", "cancellationreason": "0" }, { "ID": 12346, "datum": "1565801225", "refdate": "1565733600", "art": "0,5 COCA COLA", "artnr": "200", "preis": "3.5", "zahl": "1", "tisch": "3", "ust": "19", "kellnernr": "6", "finanzweg": "1", "buchungsnr": "0", "tableheader_id": "544306", "am_id": "143905", "balance": "3.5", "terminal": "12", "masterkellnernr": "0", "teamnr": "0", "zcount": "1262", "parentid": "0", "site": "0", "situation": "0", "sortorder": null, "addinfo": "", "rabatt_id": "0", "pricelevel_id": "1", "operationprofile_id": "2", "cancellationreason": "0" }, ]
Feldbeschreibung
ID | Eindeutige ID der Zeile |
datum | Buchungszeitpunkt des Datensatzes |
refdate | Geschäftstag 00:00 Uhr |
art | Name des gebuchten Artikels |
artnr | Artikelnummer des gebuchten Artikels oder 0 bei Finanzwegen. referenziert "number" beim Verkaufs |
preis | Bruttosumme des Datensatzes |
zahl | Anzahl der des Datensatzes |
tisch | Bezeichnung des Tisches |
ust | Steuersatz der Buchung |
kellnernr | ID des Kellners |
finanz | Finanzweg des Datensatzes;1 Boniert, 10 Sofortstorno; 11 Nachträglicher Storno; 20 Bar gegeben; >20 Individuelle Finanzwege |
buchungsnr | ID des Bestellvorgangs |
tableheader_id | Referenz auf die Rechnungskopfdaten |
am_id | eindeutige ID des Buchungssatzes |
balance | Redundant zu preis |
terminal | ID des Kassenplatzes |
masterkellner | ID des Kellners, der sich aufgrund von Masterkellnerrechten als der unter kellnernr angegebene Kellner ausgegeben hat. Sont 0 |
teamnr | ID des Teams, in das der Kellner zum Buchungszeitpunkt eingetragen war |
zcount | Z-Zähler des aktuellen Tages |
parentid | Referenz auf am_id bei Tendern, Stornos und Rabatten |
site | Permanente Verkaufsstelle der Buchung |
situation | Temporäre Verkaufsstelle der Buchung |
sortorder | Gangwahl des Datensatzes |
addinfo | Zusatztext oder Fax zu dieser Buchung |
rabatt_id | ID des Rabatt-Finanzweges, 0 wenn kein Rabatt |
pricelevel_id | ID des Pricelevels dieser Buchung |
operationprofile_id | ID der Betriebsstelle zum Buchungszeitpunkt |
cancellationreason | Bei Stornos eigegebener Stornogrund |
Tischjournal
Abfragen
Um die Tischournale abzufragen muss das Geschäftsdatum übergeben werden.
Aufruf:
GET http://login.amadeus360.de/extern/revenue/journaltables?businessdate=14.08.2019
Antwort-Beispiel:
{ "tableheader_id": "1914157", "table_type": "STANDARD", "table_number": "99663", "refdate": "1565733600", "documentdate": "0", "accounting_type": "BILL", "debitor_id": "0", "parent_id": "0", "debitor_text": "", "reservation_id": "0", "zcount": "1902", "number_adults": "0", "number_kids": "0", "number_infants": "0", "renum": "1294542", "vat1sum": "0", "vat2sum": "0", "vat3sum": "0", "finanzweg": "0", "zahl": "0", "kellnernr": "25", "is_archive": "1" }, { "tableheader_id": "1914158", "table_type": "STANDARD", "table_number": "2607", "refdate": "1565733600", "documentdate": "0", "accounting_type": "BILL", "debitor_id": "0", "parent_id": "0", "debitor_text": "", "reservation_id": "0", "zcount": "1902", "number_adults": "0", "number_kids": "0", "number_infants": "0", "renum": "1294654", "vat1sum": "0.287395", "vat2sum": "0", "vat3sum": "0", "finanzweg": "0", "zahl": "0", "kellnernr": "25", "is_archive": "1" }, { "tableheader_id": "1914159", "table_type": "STANDARD", "table_number": "1996", "refdate": "1565733600", "documentdate": "0", "accounting_type": "BILL", "debitor_id": "0", "parent_id": "0", "debitor_text": "", "reservation_id": "0", "zcount": "1902", "number_adults": "0", "number_kids": "0", "number_infants": "0", "renum": "1294785", "vat1sum": "0.047899", "vat2sum": "0", "vat3sum": "0", "finanzweg": "0", "zahl": "0", "kellnernr": "49", "is_archive": "1" }
Feldbeschreibungen
tableheader_id | Eindeutige ID des Tisches, Journaldaten referenzieren diese ID |
table_type | STANDARD(Tisch in der Kasse geöffnet) oder ONLINE (Tisch aus Onlinebestellung (AmaGO, Lieferando, ...) |
table_number | Tischnummer, alphanumerisch |
refdate | Zeitstempel des Geschäftstages (Businessdate) |
documentdate | Rechnungsdatum, wenn abweichend vom refdate |
accounting_type | Art des Tisches: BILL (Rechnung), CREDITNOTE (Gutschrift), CANCELEDBILL (Stornierte Rechnung), EMPTY (Leerer Tisch) |
debitor_id | ID des Debitors, der diesem Tisch zugewiesen ist |
parent_id | tableheader_id der Rechnung, die Storniert wurde. Nur bei Gutschrift gesetzt |
debitor_text | Freier Text für Rechnungskopf |
reservation_id | Reservierungs-ID |
zcount | Z-Zähler |
number_adults | Anzahl Erwachsene |
number_kids | Anzahl Kinder |
number_infants | Anzahl Kleinkinder |
renum | Rechnungsnummer |
vat1sum | Saldo auf Steuersatz 1 |
vat2sum | Saldo auf Steuersatz 2 |
vat3sum | Saldo auf Steuersatz 3 |
finanzweg | Finanzweg auf diesem Tisch, falls eindeutig |
zahl | Ungenutzt |
kellnernr | ID des Kellners, wenn eindeutig |
is_archive | Tagesabschluss, der diesen Tisch enthält ist ausgeführt. |