REST-Schnittstellen von lunchlist®: Benutzer, Produkte, Abrechnungen und Bestellungen anbinden
Dein ERP, deine Lohnbuchhaltung oder deine Benutzerverwaltung sollen mit lunchlist® Daten austauschen, ohne dass jemand Dateien von Hand verschiebt? Dafür gibt es Webschnittstellen auf Basis von REST. Dieser Beitrag zeigt, welche Funktionen sie bieten, wie der Zugriff läuft und wie du ein Schnittstellenprojekt vorbereitest.
Was sind die REST-Schnittstellen von lunchlist®?
Es sind Webschnittstellen, über die deine Systeme Daten in lunchlist® lesen und schreiben können. Sie basieren auf REST, einem verbreiteten Standard für Webschnittstellen. Deine Systeme sprechen dabei direkt mit lunchlist®, ein manueller Export und Import ist nicht nötig.
Das spart Wege und vermeidet Zwischenschritte. Daten müssen nicht per E-Mail verschickt oder von Hand in ein anderes System übertragen werden. Ob sich das für deinen Betrieb lohnt, hängt davon ab, wie oft sich Daten ändern und welche Systeme beteiligt sind. Dein IT-Team oder dein Dienstleister kennt das Prinzip von REST in der Regel bereits.
Die Grafik oben zeigt das Prinzip: lunchlist® und deine Systeme tauschen Daten über die REST-Schnittstelle aus, der Zugang läuft über einen API-Token. Wer lieber mit Dateien arbeitet, nutzt weiterhin CSV und Abrechnungsdateien. Den Überblick über alle Anpassungsmöglichkeiten findest du im Beitrag Individuelle Anpassung.
Wie läuft der Zugriff über API-Token?
Der Zugriff auf die Schnittstellen läuft über API-Tokens. Ein Token weist dein System gegenüber lunchlist® aus. Ohne gültigen Token gibt es keinen Zugriff.
Behandle einen Token wie ein Passwort. Er gehört nur in die Systeme, die ihn wirklich brauchen. Wie Tokens ausgestellt, verwaltet und widerrufen werden, klären wir in der Abstimmung mit dir. [TEXT FEHLT: Ausgabe, Verwaltung und Widerruf von API-Tokens, von lunchlist GmbH bestätigen]
Kläre dazu vorab mit deiner IT oder deinem Dienstleister diese Fragen:
Wer auf deiner Seite verwahrt den Token und wer darf ihn anfordern?
Brauchen mehrere Systeme Zugriff (zum Beispiel ERP und Benutzerverwaltung)?
Was passiert, wenn ein Token ausgetauscht werden muss?
Welche Funktionen stehen zur Verfügung?
Es gibt sieben Funktionen für Benutzer, Produkte, Abrechnungen und Bestellungen. Sie lassen sich in drei Gruppen einteilen: Daten in lunchlist® schreiben, Daten abfragen und Bestellungen erfassen.
Funktion
Richtung
Beispiel für den Einsatz
Benutzer anlegen
schreiben
Neue Mitarbeitende aus der Benutzerverwaltung übernehmen
Benutzer aktualisieren
schreiben
Änderungen aus dem Personalstamm nachziehen
Benutzer löschen
schreiben
Ausgeschiedene Mitarbeitende entfernen
Produkte abfragen
auslesen
Produktdaten in einem anderen System nutzen
Produkte anlegen und aktualisieren
schreiben
Produkte aus einem führenden System pflegen
Abrechnungen abfragen
auslesen
Abrechnungsdaten an ERP oder Lohnbuchhaltung übergeben
Bestellungen erfassen
schreiben
Bestellungen aus einem anderen System in lunchlist® eintragen
Die Einsatzbeispiele sind Beispiele und keine Zusage für jeden Einzelfall. Was in deinem Betrieb sinnvoll ist, hängt von deinen Systemen ab.
Ein Beispiel zeigt, wie die Funktionen zusammenspielen: Eine neue Mitarbeiterin wird in deiner Benutzerverwaltung angelegt. Ein Abgleich, zum Beispiel einmal nächtlich, legt sie in lunchlist® an. Wechselt sie die Abteilung, wird der Benutzer aktualisiert. Verlässt sie das Unternehmen, wird der Benutzer gelöscht. Am Monatsende fragt dein ERP die Abrechnungen ab und verarbeitet sie weiter. Wie dein Ablauf aussieht, legst du mit deinen Systemen fest.
Was ist Standard und was wird kundenspezifisch umgesetzt?
Alle diese Schnittstellen setzen wir kundenspezifisch um. Den Umfang stimmen wir individuell mit dir ab. Welche der sieben Funktionen du brauchst, legst du also nicht allein an einer Preisliste fest. Wir klären es gemeinsam im Gespräch.
Die Umsetzung gehört zum Enterprise-Paket, dessen Preis sich nach deinen Anforderungen richtet. Anbindungen zur Abrechnung sind laut Preisseite im Standardumfang enthalten. Darüber hinausgehende individuelle Programmierungen werden individuell kalkuliert. [TEXT FEHLT: Zuordnung der einzelnen Schnittstellenfunktionen zu Standard und Enterprise, von lunchlist GmbH bestätigen]
Wann lohnt sich die Anbindung per REST statt per Datei?
Immer dann, wenn Daten regelmäßig zwischen lunchlist® und einem anderen System fließen sollen. Ändern sich die Daten nur selten, kann auch der CSV-Import reichen. Eine Schnittstelle ist grundsätzlich nicht nötig, um lunchlist® zu nutzen.
Kriterium
Datei (CSV, Excel)
REST-Schnittstelle
Ablauf
Datei wird erzeugt und im Zielsystem importiert
Systeme tauschen Daten direkt aus
Benutzer
Import per Excel oder CSV, auf Wunsch übernehmen wir den Import
Automatischer Abgleich, zum Beispiel einmal nächtlich
Abrechnung
Abrechnungsdatei im gewünschten Format, auf Wunsch automatisiert per E-Mail
Abrechnungen werden über eine Funktion abgefragt
Zugang
Anmeldung in der Administration
API-Token
Umsetzung
Standardfunktion oder Format nach deinem Wunsch
Kundenspezifisch, Umfang individuell abgestimmt
Typische Einsatzfälle der Schnittstelle sind diese:
Benutzerverwaltung: Benutzer werden automatisch angelegt, aktualisiert und gelöscht, zum Beispiel einmal nächtlich. Ausgeschiedene Mitarbeitende behalten so keinen Zugang.
ERP und Lohnbuchhaltung: Dein System fragt die Abrechnungen ab und übernimmt sie. Wie die Abrechnung selbst aufgebaut ist, steht im Beitrag Von der Strichliste zur Abrechnungsdatei.
Produkte und Bestellungen: Produkte lassen sich aus einem anderen System abfragen oder pflegen. Bestellungen aus anderen Systemen lassen sich in lunchlist® erfassen.
Wie bekommst du die Schnittstellenspezifikation?
Du fragst sie bei uns an. Es gibt eine Schnittstellenspezifikation, die wir dir bei Bedarf zur Verfügung stellen. Gib sie deiner IT oder deinem Dienstleister, damit sich vorab prüfen lässt, ob die Funktionen zu euren Systemen passen.
Schreib uns dazu über den Kontakt. Die Funktionen im Überblick findest du auch auf der Seite Funktionen.
Wie bereitest du ein Schnittstellenprojekt vor?
Je klarer die Anforderungen sind, desto schneller lässt sich der Umfang abstimmen. Kläre vor dem Gespräch diese Punkte:
Welche Systeme sind beteiligt (ERP, Lohnbuchhaltung, Benutzerverwaltung)?
Welche der sieben Funktionen brauchst du?
In welche Richtung sollen Daten fließen und wie oft (zum Beispiel einmal nächtlich)?
Wer in deiner IT oder beim Dienstleister spricht mit uns und kennt die Schnittstelle des anderen Systems?
Wer verwaltet den API-Token auf deiner Seite?
Hilfreich ist ein gemeinsamer Termin mit allen Beteiligten. Dazu gehören je nach Betrieb die Personalabteilung, die Buchhaltung, die IT und der Datenschutz. Die Einführung begleiten wir mit einem festen Ansprechpartner. Mit dir schließen wir einen Auftragsverarbeitungsvertrag (AVV) ab. Welche Datenflüsse zwischen deinen Systemen zusätzlich zu regeln sind, prüfst du im Einzelfall intern.
Hinweis: Schnittstellen übertragen Personen- und Abrechnungsdaten und berühren damit Datenschutz und Steuerrecht. Lass Umfang, Löschfristen und Zugriffe im Einzelfall intern prüfen, dieser Beitrag ist keine Rechtsberatung.
Du willst wissen, was für deine Systeme möglich ist? Im Online-Termin besprechen wir deine Anforderungen und den Umfang der Schnittstellen.