Endpunkte BWA und SuSa : Gastro-MIS GmbH

Bei den betriebswirtschaftlichen Daten können BWA (betriebswirtschaftliche Auswertung) und SuSa (Summen- und Saldenliste) in der TPAPI gelesen werden.

Nach der Freigabe für den Zugriff und Anmeldung werden diese konfigurierten Daten zurück übermittelt oder beim Schreiben der Erfolg der Änderung gemeldet.

Der Aufruf für die LINA Data API ist geändert, die alte URL amadeus360 ist noch erreichbar. Bitte auf die neue URL umstellen.

https://api.lina.de/ ...

Voraussetzung	Konfiguration	Ergebnis
Lizenzierung LINA	Endpunkt "BWA"	monatliche Buchung
Client-Schnittstelle	mit URI	Client-ID und Access-Token
Client-Berechtigung	Daten lesen/schreiben	Lese-/Schreibberechtigung Client
Scope	bwa_read
Nutzerberechtigung	Anmeldung mit Benutzer	Abfrage der Daten mit den Berechtigungen des Benutzers

BWA und SuSa abrufen

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

GET ... /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 ... /extern/bwa/index

Antwort-Beispiel Endpunkte:

[
    {        "url": "https://api.lina.de/extern/bwa/bwa"
    }
]

BWA für einen Monat abrufen

Aufruf und Parameter BWA:

GET ... /extern/bwa/bwa?month=12&year=2018&schema=0

Parameter	Feldtyp	Beschreibung
month	int	Monat von 1 bis 12
year	int	Jahr
schema	int	Das 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,
        ...
    }
}

Feldname	Feldtyp	Beschreibung
month	int	Monat 1-12
year	int	Jahr
schema	int	BWA-Schema ID
label	array[int,string]	Array der Bezeichnungen der BWA-Zeilen. Indizes sind die IDs der BWA-Zeilen im BWA-Schema
werte	array[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:

GET ... /extern/bwa/schemas

Beispiel-Antwort Schemas und Felder:

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

Feldname	Feldtyp	Beschreibung
schemaid	int	ID des Schemas
schemaname	string	Name des Schemas
bwa_layaout	int	zugehöriges BWA - Layout
skr	int	Datev Sachkontenrahmen

SuSa pro Monat abrufen

Aufruf und Parameter SuSa:

GET ... /extern/bwa/susa?month=12&year=2018

Parameter	Feldtyp	Beschreibung
month	int	Monat von 1 bis 12
year	int	Jahr

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
    }
]

Feldname	Feldtyp	Beschreibung
ID	int	Interne ID des Datensatzes
konto	int	Konto
bezeichnung	string	Kontobezeichnung
datum	int	Timestamp des Datensatzes, immer der 1. des Monats, 00:00 Uhr
soll	float	Summe Sollbuchungen des Kontos
haben	float	Summe Habenbuchungen des Kontos
saldo	float	Saldo des Kontos
stand	int	Timestamp der letzten Aktualisierung
eb_soll	float	EB-Wert Sollbuchungen des Kontos
eb_haben	float	EB-Wert Habenbuchungen des Kontos

Endpunkte BWA und SuSa Drucken