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. 


API-Doku: https://documenter.getpostman.com/view/12285766/TzkyML8s#4d7de93a-5bfb-4af5-8d59-c806e81c1b0b


Im Amadeus360 - Betrieb muss das Modul "Endpunkt Bewegungsdaten Umsatz" gebucht sein. 

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

IDEindeutige ID der Zeile
datumBuchungszeitpunkt des Datensatzes
refdateGeschäftstag 00:00 Uhr
artName des gebuchten Artikels
artnrArtikelnummer des gebuchten Artikels oder 0 bei Finanzwegen. referenziert "number" beim Verkaufs
preisBruttosumme des Datensatzes
zahlAnzahl des Datensatzes
tischBezeichnung des Tisches
ustSteuersatz der Buchung
kellnernrID des Kellners
finanzFinanzweg des Datensatzes;1 Boniert, 10 Sofortstorno; 11 Nachträglicher Storno; 20 Bar gegeben; >20 Individuelle Finanzwege
buchungsnrID des Bestellvorgangs
tableheader_idReferenz auf die Rechnungskopfdaten
am_ideindeutige ID des Buchungssatzes
balanceRedundant zu preis
terminalID des Kassenplatzes
masterkellnerID des Kellners, der sich aufgrund von Masterkellnerrechten als der unter Kellnernummer angegebene Kellner ausgegeben hat. Sonst 0
teamnrID des Teams, in das der Kellner zum Buchungszeitpunkt eingetragen war
zcountZ-Zähler des aktuellen Tages
parentidReferenz auf am_id bei Tendern, Stornos und Rabatten
sitePermanente Verkaufsstelle der Buchung
situationTemporäre Verkaufsstelle der Buchung
sortorderGangwahl des Datensatzes
addinfoZusatztext oder Fax zu dieser Buchung
rabatt_idID des Rabatt-Finanzweges, 0 wenn kein Rabatt
pricelevel_idID des Pricelevels dieser Buchung
operationprofile_idID der Betriebsstelle zum Buchungszeitpunkt
cancellationreasonBei Stornos eingegebener Stornogrund



Tischjournal


Abfragen

Um die Tischjournale 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_idEindeutige ID des Tisches, Journaldaten referenzieren diese ID
table_typeSTANDARD(Tisch in der Kasse geöffnet) oder ONLINE (Tisch aus Onlinebestellung (AmaGo, Lieferando, ...)
table_numberTischnummer, alphanumerisch
refdateZeitstempel des Geschäftstages (Businessdate)
documentdateRechnungsdatum, wenn abweichend vom refdate
accounting_typeArt des Tisches: BILL (Rechnung), CREDITNOTE (Gutschrift), CANCELEDBILL (Stornierte Rechnung), EMPTY (Leerer Tisch)
debitor_idID des Debitors, der diesem Tisch zugewiesen ist
parent_idtableheader_id der Rechnung, die Storniert wurde. Nur bei Gutschrift gesetzt
debitor_textFreier Text für Rechnungskopf
reservation_idReservierungs-ID
zcountZ-Zähler
number_adultsAnzahl Erwachsene
number_kidsAnzahl Kinder
number_infantsAnzahl Kleinkinder
renumRechnungsnummer
vat1sumSaldo auf Steuersatz 1
vat2sumSaldo auf Steuersatz 2
vat3sumSaldo auf Steuersatz 3
finanzwegFinanzweg auf diesem Tisch, falls eindeutig
zahlUngenutzt
kellnernrID des Kellners, wenn eindeutig
is_archiveTagesabschluss, der diesen Tisch enthält ist ausgeführt.


Umsatz-Forecast


Abfragen

Amadeus360 berechnet den täglichen Umsatz-Forecast. 


Aufruf:

GET http://login.amadeus360.de/extern/revenue/getforecastperday?from=01.08.2021&to=31.08.202

Antwort-Beispiel:

[
    {
        "datum": 1627768800,
        "forecast": 3709.71
    },
    {
        "datum": 1627855200,
        "forecast": 3094.5
    },
    {
        "datum": 1627941600,
        "forecast": 3470.81
    }
]