In der LINA Third Party API (TPAPI) können Arbeitszeiten und Personalkosten pro Zeit gelesen 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/ ...
Voraussetzung | Konfiguration | Ergebnis |
---|---|---|
Lizenzierung LINA | Endpunkt "Personal" | monatliche Buchung |
Client Schnittstelle | mit URI | Client-ID und Access-Token |
Client-Berechtigung | Daten lesen | Leseberechtigung Client |
Scope | personal_read | |
Nutzer-Berechtigung | Anmeldung mit Benutzer | Abfrage der Daten mit den Berechtigungen des Benutzers |
Personaldaten allgemein
Um die Endpunkte der Personaldaten abzufragen lautet die Basis-URL personal wie folgt:
GET ... /extern/personal
Alle Daten können erst nach erfolgreicher Authentifizierung abgefragt werden. Antwort ist immer ein JSON-Objekt.
Die Berechnung der Effizienzen ist erst exakt, wenn die Schichtzeiten bestätigt sind.
API-Doku: https://documenter.getpostman.com/'id personal'
Personalkosten pro Stunde
Mit businessdate wird der Geschäftstag übergeben, vom Beginn bis zum Tagesabschluss (nicht Kalendertag)
Aufruf mit Datum:
GET ... /extern/personal/personalkostenprostunde?businessdate=25.11.2020
Beispiel-Antwort Tagesübersicht:
{ "eff": { "12": 1, "13": 1, "14": 1, "15": 1, "19": 1, "20": 1, "21": 1, "22": 1, "23": 1, "0": 1, "1": 1 }, "kost": { "12": 11.09, "13": 11.09, "14": 11.09, "15": 11.09, "19": 11.09, "20": 0, "21": 0, "22": 0, "23": 0, "0": 0, "1": 0 }, "kostUser": { "12": [ 11.09 ], "13": [ 11.09 ], "14": [ 11.09 ], "15": [ 11.09 ], "19": [ 11.09 ], "20": [ 0 ], "21": [ 0 ], "22": [ 0 ], "23": [ 0 ], "0": [ 0 ], "1": [ 0 ] } }
Personalkosten pro Tag und Mitarbeiter
Aufruf Tag:
GET ... /extern/personal/personalkostenprotag?businessdate=25.11.2020
Beispiel-Antwort Tag:
[ { "h_brutto": 9, "h_zuschl_25": 4, "h_zuschl_40": 1, "h_zuschl_50": 0, "brutto": 82.71, "lohnkosten": 300.66 } ]
Arbeitszeiten pro Tag und Mitarbeiter
Aufruf:
GET ... /extern/personal/acceptedworkingtimes?businessdate=25.11.2020
Beispiel-Antwort Mitarbeiter:
[ { "von": 1606474800, "bis": 1606485600, "von2": 1606500000, "bis2": 1606521600, "pause": 0, "tage": 0, "bereich": 1 } ]
Komplettdaten pro User und Tag
Aufruf:
GET ... /extern/personal/userdataperday?businessdate=25.11.2020
Beispiel-Antwort Zeiten und Kosten:
[ { "von": 1606476600, "bis": 1606485600, "von2": 1606500000, "bis2": 1606523400, "pause": 0, "tage": 0, "bereich": 1, "h_brutto": 9, "h_zuschl_25": 4, "h_zuschl_40": 1.5, "h_zuschl_50": 0, "brutto": 82.71, "lohnkosten": 111.22, "stundenkosten": { "12": 5.54, "13": 11.09, "14": 11.09, "15": 11.09, "19": 11.09, "20": 13.39, "21": 13.39, "22": 13.39, "23": 13.39, "0": 12.01, "1": 6 } } ]
Komplettdaten pro User und Tag Delta
Mit der Abfrage des Deltas können die Differenzen (maximal der letzten 3 Monate) abgefragt werden.
Aufruf Komplettdaten:
GET ... /extern/personal/userdataperdaydelta?updatedSince=25.11.2020
Beispiel-Antwort Komplettdaten:
[ { "datum": "21.06.2021", "schichten": [ { "von": 0, "bis": 0, "von2": 1624262400, "bis2": 1624293000, "pause": 30, "tage": 0, "bereich": 0, "h_brutto": 8, "h_zuschl_25": 0, "h_zuschl_40": 0, "h_zuschl_50": 0, "h_zuschl_51": 0, "brutto": 9.6, "lohnkosten": 13.47, "stundenkosten": { "10": 1.58, "11": 1.58, "12": 1.58, "13": 1.58, "14": 1.58, "15": 1.58, "16": 1.58, "17": 1.58, "18": 0.79 } } ] }, { "datum": "13.04.2020", "schichten": [] } ]
Datenfelder in den Endpunkten Personal
Für alle Antworten in den verschiedenen Endpunkten Personal gelten die folgenden Felder /Werte
Feldname | Feldtyp | Beschreibung |
---|---|---|
businessdate | string (##.##.####) | Geschäftstag (bis Tagesabschluss) |
eff | float | Effektivität (Umsatz pro Personalstunde) pro Uhrzeit |
kost | float | Personalkosten pro Stunde |
kostUser | float | Personalkosten pro Mitarbeiter und Stunde |
von | int | Unix-Timestamp Arbeitsbeginn erste Schicht |
bis | int | Unix-Timestamp Arbeitsende erste Schicht |
von2 | int | Unix-Timestamp Arbeitsbeginn zweite Schicht |
bis2 | int | Unix-Timestamp Arbeitsende zweite Schicht |
pause | int | Pause in Minuten |
tage | float | Tage bei Urlaub/Krank |
bereich | int | Bereiche, wie im Betrieb angelegt. Feste Bereiche in LINA:
Standard-Bereiche (können verändert werden):
|
h_brutto | float | Stunden gearbeitet |
h_zuschlag_25 | float | Stunden im ersten SFN-Zuschlagsbereich |
h_zuschlag_40 | float | Stunden im zweiten SFN-Zuschlagsbereich |
h_zuschlag_50 | float | Stunden im dritten SFN-Zuschlagsbereich (Sonntag) |
h_zuschlag_51 | float | Stunden im vierten SFN-Zuschlagsbereich (Feiertage) |
brutto | float | SV-Pflichtiger Bruttolohn |
lohnkosten | float | Lohnkosten AG |
stundenkosten | array | Lohnkosten pro Stunde, Format "Uhrzeit": "Kosten (float) |