Gastro-MIS GmbH

Mit der LINA Third Party API (TPAPI) können nach gesonderter Zustimmung Personaldaten gelesen werden, um sie z.B. für den Login an anderen Systemen zu nutzen. Außerdem können Schichtteilnahmen und Dokumente im Datenstamm eingetragen werden.

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

Persönliche Zustimmung

Um persönliche Daten der Mitarbeiter abzurufen, muss der Mitarbeiter der Weitergabe der Daten gesondert zustimmen. Diese Zustimmung wird beim Registrieren eines Webhooks abgefragt: Webhooks registrieren, bearbeiten und löschen (TPAPI).

Die Zustimmung wird eingestelt bei
Benutzerdaten > meine Daten > Datenweitergabe

Hie kann sowohl die Zustimmung gegeben als auch entzogen werden.

Ausscheiden des Mitarbeiters

Der Geschäftsführer kann die Weitergabe der Daten beenden, in dem er den den Mitarbeiter auf inaktiv setzt. 

Wird ein Mitarbeiter gelöscht und in die HoF verschoben, werden die Daten weiter an der TPAPI übertragen. Auch das Ende eines Vertrags beendet nicht die Übertragung.
Nur das Entfernen des Logins an LINA TeamCloud beendet die Übertragung der Daten.

Persönliche Daten an der TPAPI

Eine Liste der Mitarbeiter, die aktuell zugestimmt haben, ist abrufbar: 

GET ... /extern/personal/getPersonalData

Die Antwort enthält ein Array mit den Daten aller Mitarbeiter, die der Weitergabe zugestimmt haben: 

[
    {
        "userUuid": "4647b780-a4ab-4ca7-a977-2e00d78a8a28",
        "userVorname": "vyhpboqL",
        "userName": "hSRHIvca",
        "userEmail": "te@gastro-mis.de",
        "bereich": "Service"
    },
    {
        "userUuid": "196b3002-a8ae-4e2c-9de5-a317ef5c893c",
        "userVorname": "Joe",
        "userName": "Test",
        "userEmail": "j@gastro-mis.de",
        "bereich": "Küche"
    }
]

Die Mitarbeiter können die Zustimmung verändern: Webhooks Personal (TPAPI) - Zustimmung

Die Zuordnung zu einem Bereich ergibt sich aus dem Nutzerrecht "Teilnehmen" in dem Abschnitt "Dienstpläne und Bereiche" in den Stammdaten des Mitarbeiters.

Beispiel aus dem Bild: Mitarbeiter Joe Test hat das "Teilnehmen"- Recht für "Küche", Leserechte für Service und Leitung Büro.
Beim Aufruf ../getPersonalData wird nur der Bereich "bereich": "Küche" ausgeben.

Mitarbeiter in mehreren Läden

Die Zustimmung zur Datenweitergabe kann immer nur im Hauptladen erfolgen. Für die geforderte Zustimmung zur Datenweitergabe muss der Mitarbeiter kurzzeitig den Hauptladen wechseln, zustimmen und kann sofort wieder zurückwechseln.

Lohnschicht eintragen

Mit der userUuid eines Mitarbeiters kann man eine Schicht für den Mitarbeiter speichern. Diese zählen als bestätigte Arbeitszeiten zur Abrechnung.

Eine einmal gespeicherte Schicht kann über die TPAPI nicht mehr bearbeitet oder gelöscht werden, sondern nur über die Oberfläche in LINA. 
Wird die gleiche Schicht mehrfach geschickt, so wird diese auch mehrfach für den Mitarbeiter gespeichert.

POST ... /extern/personal/saveShift

Als POST Body muss ein JSON-Objekt mit den Daten der Schicht übergeben werden: 

{
    "userUuid": "c6425258-a870-498d-8173-6c2341c934e",
    "datum": 1694210400,
    "von": 1694260800,
    "bis": 1694300400
    "von2": 1694260800,
    "bis2": 1694300400
    "pause": 0
}

Optionale Werte: um Teildienste abbilden zu können gibt es optionale Werte von2 und bis2. Die Pause wird ebenfalls optional als pause in Minuten angegeben. 

Dateiupload für User - Personalakte

mit der userUuid eines Mitarbeiters können für den Mitarbeiter Dateien hochgeladen werden. Die Dateigröße ist auf 1 MB beschränkt. 

POST ... /extern/personal/addUserCert