In der Amadeus360 Third Party API (TP API) werden an den verschiedenen Endpunkten Daten gelesen/geschrieben.
Bei den betriebswirtschaftlichen Daten können BWA (betriebswirtschaftliche Auswertung) und SuSa (Summen und Saldenliste) gelesen werden.

Nach der Freigabe für den Zugriff (Lizensierung, Anlegen des Client, Berechtigung) und erfolgreiche Anmeldung werden diese konfigurierten Daten zurück übermittelt oder beim Schreiben der Erfolg der Änderung gemeldet.


VoraussetzungKonfigurationErgebnis
Lizensierung Amadeus360Endpunkt "BWA"monatliche Buchung
Client Schnittstellemit URIClient-ID und Access-Token
Client-BerechtigungDaten lesen/schreibenLese- /Schreibberechtigung Client
Scopebwa_read
Nutzer-BerechtigungAnmeldung mit BenutzerAbfrage der Daten mit den Berechtigungen des Benutzers



INHALTSVERZEICHNIS



BWA und SuSa abrufen

Um die Endpunkte der Personaldaten abzufragen lautet die Basis-URL bwa wie folgt:

https://login.amadeus360.de/extern/bwa


Alle Daten können erst nach erfolgreicher Authentifizierung abgefragt werden. Antwort ist immer ein JSON-Objekt.

API-Doku: https://documenter.getpostman.com/'id bwa'

Endpunkte auflisten (authentifiziert)

Um die Endpunkte für die BWAs aufzulisten, gibt es eine Indexseite. Es sind keine weiteren Header oder Parameter notwendig.

Aufruf Index:

GET https://login.amadeus360.de/extern/bwa/index

Antwort-Beispiel Endpunkte:

[
    {        "url": "https://login.amadeus360.de/extern/bwa/bwa"
    }
]

BWA für einen Monat abrufen

Aufruf und Parameter BWA:

https://login.amadeus360.de/extern/bwa/bwa?month=12&year=2018&schema=0


ParameterFeldtypBeschreibung
monthintMonat von 1-12
yearintJahr
schemaintDas gewünschte BWA-Schema, default = 0.


Antwort-Beispiel BWA und Felder: 

{
    "month": 12,
    "year": 2018,
    "schema": 0,
    "label": {
        "1": "Erlöse Bar",
        "2": "Erlöse Küche",
        "3": "sonstige Erlöse",
        "4": "Gesamtleistung",
        "5": "Wareneinsatz/Mat.-Verbrauch",
        "6": "WE Bar",
        "7": "WE Bar in % zum Barumsatz",
        "8": "Bestand Getränke (nur Info)",
        "9": "WE Küche",
        "10": "WE Küche in % zum Küchenums.",
        "11": "Bestand Küche (nur Info)",
        "12": "Rohertrag",
        "13": "Sonstige betriebliche Erlöse",
        "14": "Betrieblicher Rohertrag",
        "15": "Kostenarten",
        "16": "Personalkosten o. Gf",
        "17": "Geschäftsführer",
        "18": "Freiwillige soz. Aufwendungen",
        "19": "Beiträge BGN etc.",
        "20": "Persokosten gesamt",
        "21": "Barbedarf",
        "22": "Küchenbedarf",
        "23": "Geschirr/Gläser",
        "24": "Servietten",
        "25": "Kerzen/Trinkhalme",
        "26": "Verbrauchskosten",
        "27": "Mietkosten",
        ...
    },
    "werte": {
        "1": 15365.93,
        "2": 44353.14,
        "3": 630.25,
        "4": 60349.32,
        "5": 0,
        "6": 3907.04,
        "7": 0,
        "8": 0,
        "9": 13159.58,
        "10": 0,
        "11": 0,
        "12": 0,
        "13": 0,
        "14": 0,
        "15": 0,
        "16": 20185.32,
        "17": 3000,
        "18": 0,
        "19": 0,
        "20": 23185.32,
        "21": 0,
        "22": 191.6,
        "23": 0,
        "24": 109.39,
        "25": 30.8,
        "26": 331.79,
        "27": 3138.99,
        ...
    }
}


FeldnameFeldtypBeschreibung
monthintMonat 1-12
yearintJahr
schemaintBWA-Schema id
labelarray[int,string]Array der Bezeichnungen der BWA-Zeilen. Indizes sind die IDs der BWA-Zeilen im BWA-Schema
wertearray[int,float]Werte in € für die BWA-Zeilen. Die Indizes referenzieren die BWA-Zeilen aus dem "label" - Array. 

BWA-Schemas abrufen

Aufruf und Parameter Schema:

https://login.amadeus360.de/extern/bwa/schemas

Beispiel-Antwort Schemas und Felder: 

[
    {
        "schemaid": 0,
        "schemaname": "Gastro-MIS Standard",
        "bwa_layout": 0,
        "skr": 3
    }
]


FeldnameFeldtypBeschreibung
schemaidintID des Schemas
schemanamestringName des Schemas
bwa_layaoutintzugehöriges BWA - Layout
skrintDatev Sachkontenrahmen


SuSas pro Monat abrufen

Aufruf und Parameter SuSa:

https://login.amadeus360.de/extern/bwa/susa?month=12&year=2018
ParameterFeldtypBeschreibung
monthintMonat von 1-12
yearintJahr


Antwort-Beispiel SuSa und Felder:

[
    {
        "ID": 66891,
        "konto": 1500,
        "bezeichnung": "Konzessionen",
        "datum": 1543618800,
        "soll": 0,
        "haben": 111.17,
        "saldo": 17777,
        "stand": 1551283123,
        "eb_soll": 19111,
        "eb_haben": 1222.83
    }
]


FeldnameFeldtypBeschreibung
IDintInterne ID des Datensatzes
kontointKonto
bezeichnungstringKontobezeichnung
datumintTimestamp des Datensatzes, immer der 1. des Monats, 00:00 Uhr
sollfloatSumme Sollbuchungen des Kontos
habenfloatSumme Habenbuchungen des Kontos
saldofloadSaldo des Kontos
standintTimestamp der letzten Aktualisierung
eb_sollfloatEB-Wert Sollbuchungen des Kontos
eb_habenfloatEB-Wert Habenbuchungen des Kontos