InnerWeb
Zum Inhalt springen

Kartenbuchungen aus der Zutrittskontrolle (KD) in die Zeiterfassung (RCP) beim Verpackungshersteller

Ein Hersteller von Wellpappverpackungen (Standort in Polen, Hauptsitz in Deutschland) wollte, dass Buchungen von Karten aus dem bestehenden Zutrittskontrollsystem in die Arbeitszeiterfassung übernommen werden. Ein Austausch der Leser stand nicht zur Debatte. Die Lösung war eine Integration nach einer Spezifikation für den Anbieter des KD-Systems, ohne Leser von InnerWeb. Wir beschreiben, wie diese Zusammenarbeit aufgebaut wurde und worauf man in einem ähnlichen Werk achten sollte.

13 Stunden
Paarungsfenster von Eingang und Ausgang
Quelle: Kartenblatt der Zelle
180 s
Schwelle zum Verwerfen von Dubletten bei Buchungen
Quelle: Kartenblatt der Zelle

Ausgangslage: Leser sind vorhanden, Daten fehlen in der Zeiterfassung

Das Werk betreibt ein funktionierendes Zutrittskontrollsystem mit Lesern an den Toren und Zugängen zur Produktion. Die Personalabteilung braucht Daten über Kommen und Gehen für die Abrechnung der Arbeitszeit, doch die Buchungen bleiben im KD-System und erreichen die Zeiterfassung nicht. Jeden Monat werden die Stunden deshalb von Hand nachgetragen.

Ein Austausch der Leser oder Controller hätte Kosten, Stillstand an den Toren und monatelange Verhandlungen mit dem Anbieter bedeutet. Das Werk entschied sich für einen Weg, bei dem die Leser bleiben und nur verändert wird, was das KD-System weiter übermittelt.

Lösung: InnerWeb nimmt Ereignisse aus dem KD-System entgegen

InnerWeb stellt keine Leser oder Zutrittskarten her und tauscht sie nicht aus. Das System empfängt die Kartenbuchungen aus dem KD-System über einen Webhook und verknüpft sie mit Qualifikationen, Freigaben, Anwesenheit und der Zeiterfassung. Dies ist das Einführungsmuster beim Verpackungshersteller: Integration der Kartenbuchungen aus dem KD-System in die Zeiterfassung nach einer Spezifikation für den KD-Anbieter.

Die Spezifikation legt fest, welche Felder jedes Ereignis enthält, in welchem Format es gesendet wird und wie oft. Der KD-Anbieter arbeitet auf seiner Seite, und das Team des Werks muss die internen Tabellen des Zutrittssystems nicht kennen.

Was in die Spezifikation für den KD-Anbieter gehört

Die Spezifikation ist kurz und konkret, weil der KD-Anbieter sie in der bestehenden Software umsetzen soll.

  • Kennung der Karte oder des Mitarbeiterkontos in einer zwischen den Systemen abgestimmten Form.
  • Kennung des Lesers, die einem im System definierten Ort entspricht.
  • Zeitpunkt des Ereignisses am Leser mit Zeitzone.
  • Durchgangsrichtung (Eingang oder Ausgang) und die vom KD-System vergebene Ereigniskennung.
  • Wiederholung beim Versand, wenn der Empfang vorübergehend ausfällt, und Authentifizierung des Webhooks mit einem Token mit begrenzter Gültigkeit, das die Integration automatisch erneuert.

Beispielhafte Parameter der Buchungspaarung in der Spezifikation

Beispielhafte Parameter der Buchungspaarung in der SpezifikationBalkendiagramm: Paarungsfenster 780 Minuten, Schwelle für Dubletten 3 Minuten.0200400600800minPaarungsfenster Eingang zuAusgangPaarungsfenster Eingang zu Ausgang: 780 min780Schwelle für DublettenSchwelle für Dubletten: 3 min3
Quelle: Kartenblatt der Zelle: Buchungspaarung (13 Stunden = 780 Min., 180 s = 3 Min.)

Worauf bei der Prüfung der Daten zu achten ist

Der Import der Konten aus dem KD-System ersetzt kein Buchungsregister: Der Verlauf von Kommen und Gehen erfordert eine eigene Ereignisspezifikation, in der das KD-System jede Buchung als eigenes Ereignis in Echtzeit sendet.

Die zweite Falle betrifft den Ort. Eine Buchung von einem Leser ohne zugeordneten Ort, also ohne Aktionspunkt, löst keinen Schulungsalarm aus. Die Konfiguration der Leser muss den Orten im System entsprechen, sonst kommt das Ereignis zwar an, bleibt aber ohne Wirkung.

Der dritte Punkt ist der Inhalt des Ereignisses. Die Spezifikation verlangt, dass das KD-System Zeitpunkt am Leser, Richtung (Eingang oder Ausgang) und Ereigniskennung übermittelt. Die Regeln für die Paarung von Ein- und Ausgängen sowie für das Verwerfen von Dubletten werden zusammen mit dem KD-Anbieter festgelegt, zum Beispiel ein Paarungsfenster von 13 Stunden und eine Dublette bei einem Abstand unter 180 Sekunden. Wir beschreiben sie auf einer eigenen Seite mit Umsetzungshinweisen für den Webhook der Buchungen.

Rolle der Personalabteilung und des KD-Integrators

Die Personalabteilung legt fest, was in der Zeiterfassung erscheinen soll: den Umfang der Stunden, die Rundungsregeln und die Kennzeichnung fehlender Buchungen. Der Integrator des KD-Systems liefert die Ereignisse im abgestimmten Format. InnerWeb übernimmt auf seiner Seite den Empfang, die Verknüpfung mit dem Konto und die Ansicht für berechtigte Personen.

Die Aufteilung ist klar: Leser und Karten sind Sache des KD-Anbieters, die Regeln der Erfassung sind Sache der Personalabteilung, und die Verbindung der Daten ist eine gemeinsame Aufgabe, die in der Spezifikation beschrieben ist. So verändert keine der Seiten das System der anderen.

Schlussfolgerungen für ein ähnliches Werk

Prüfen Sie zuerst, was das KD-System tatsächlich speichert: ein vollständiges Journal mit Richtung oder nur die letzte Anmeldung. Beschreiben Sie danach die Felder des Ereignisses und senden Sie die Spezifikation an den KD-Anbieter zusammen mit der Bitte um einen Umsetzungstermin. Prüfen Sie abschließend, ob jeder Leser im System einen Ort zugeordnet hat.

Diese Reihenfolge erlaubt es, die Integration ohne Austausch der Hardware zu starten. Entscheidet sich das Werk später für einen neuen Kartentyp, etwa DESFire, bleibt die Freigabelogik in InnerWeb unverändert.

Was vor dem Start der Integration zu prüfen ist

Bevor Sie die Spezifikation an den KD-Anbieter senden, prüfen Sie drei Punkte. Erstens, ob das KD-System ein vollständiges Journal der Buchungen führt oder nur die letzte Anmeldung eines Kontos. Zweitens, ob die Kennung des Kontos im KD-System mit der Kennung im Freigabesystem übereinstimmt. Drittens, ob das Netzwerkteam des Werks ausgehenden Verkehr vom Server zulässt, denn bei einer Sperre muss ein anderer Empfangsweg und die Zwischenspeicherung der Ereignisse auf Seiten des KD-Systems vereinbart werden.

Diese Liste nimmt eine Besprechung mit dem KD-Anbieter in Anspruch und verkürzt spätere Korrekturen. Sie erfordert keine Änderungen an den Lesern und keine Änderungen an der Software des KD-Systems außer dem Versand der Ereignisse nach der Spezifikation.

Videomaterial

Häufig gestellte Fragen

Müssen für die Integration die Leser des KD-Systems ausgetauscht werden?

Nein. Das Muster sieht eine Integration nach einer Spezifikation für den KD-Anbieter vor, ohne Leser von InnerWeb und ohne Austausch der vorhandenen Leser.

Was ist, wenn der Import der Konten aus dem KD-System nur die letzte Anmeldung zeigt?

Dann ist eine eigene Spezifikation der Buchungsereignisse nötig. Die letzte Anmeldung ersetzt kein Register der Kommen- und Gehen-Buchungen mit Richtung.

Warum hat eine Buchung am Leser keinen Schulungsalarm ausgelöst?

Meist hat der Leser im System keinen zugeordneten Ort, also keinen Aktionspunkt. Die Konfiguration der Leser muss den Orten entsprechen.

Möchten Sie KD und Zeiterfassung ohne Austausch der Leser verbinden?

Wir erarbeiten mit Ihnen die Spezifikation der Ereignisse für den KD-Anbieter und zeigen, wie die Buchungen in die Erfassung gelangen. Vereinbaren Sie ein Gespräch.

Sprechen wir