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. |