InnerWeb
Zum Inhalt springen

Kartenbuchungen aus der Zutrittskontrolle in die Zeiterfassung: Pflichtfelder des Ereignisses und Hinweise zur Umsetzung

Für die Zeiterfassung braucht es vom System der Zutrittskontrolle sieben Angaben in jedem Ereignis einer Kartenbuchung, darunter die Richtung Eingang oder Ausgang und die Kennung des Ereignisses. Dieser Text richtet sich an den Integrator des Systems der Zutrittskontrolle und beschreibt die Anforderungen der Spezifikation, die Aufteilung der Aufgaben und die Reihenfolge der Einführung.

7
Felder des Ereignisses in der Integrationsspezifikation
Quelle: Integrationsspezifikation
3
Schritte der Einführung und der Tests
Quelle: Einführungsplan von InnerWeb

Umfang der Integration und Aufteilung der Verantwortung

InnerWeb produziert und tauscht keine Lesegeräte der Zutrittskontrolle. Das System integriert sich mit der bestehenden Zutrittskontrolle des Kunden und empfängt die Ereignisse der Kartenbuchung über einen Webhook nach der Spezifikation für den Anbieter der Zutrittskontrolle. Lesegeräte, Karten und Steuerungen bleiben auf Seiten des Kunden und seines Integrators.

InnerWeb ist ein eigenständiges System, das die bestehenden Systeme des Kunden ergänzt: Zutrittskontrolle, Zeiterfassung, Personal und ERP. In dieser Integration ist das System der Zutrittskontrolle die Quelle der Ereignisse und das Zeitmodul deren Empfänger. Deshalb teilen wir die folgenden Hinweise in das, was der Integrator tut, und das, was InnerWeb tut.

Felder des Ereignisses in der Integrationsspezifikation

Die Integrationsspezifikation sieht vor, dass das System der Zutrittskontrolle Ereignisse in Echtzeit sendet, und zwar in jedem Ereignis mit sieben Angaben. InnerWeb nimmt sie über einen authentifizierten Webhook entgegen.

  • Zeit des Ereignisses: Zeitpunkt der Buchung nach der Uhr des Lesegeräts im System der Zutrittskontrolle.
  • Ort: Drehkreuz oder Lesegerät, an dem die Buchung erfolgte.
  • Angaben zur Person: eindeutige Zuordnung der Karte zu einem Mitarbeiter.
  • Firma: Arbeitgeber der Person, damit sich eigene Mitarbeiter von Fremdfirmen unterscheiden lassen.
  • Nummer der aktiven Karte im Moment der Buchung.
  • Richtung: Eingang oder Ausgang, abgeleitet aus der Konfiguration des Lesegeräts.
  • Kennung des Ereignisses: fest und eindeutig, unverändert bei erneutem Versand.

Felder des Ereignisses: Identifizierung der Buchung und Vollständigkeit für die Zeiterfassung

Felder des Ereignisses: Identifizierung der Buchung und Vollständigkeit für die ZeiterfassungBalkendiagramm: 5 Felder zur Identifizierung der Buchung und 7 Felder für die vollständige Zeiterfassung.02468FelderIdentifizierung der BuchungIdentifizierung der Buchung: 5 Felder5Vollständigkeit für dieZeiterfassungVollständigkeit für die Zeiterfassung: 7 Felder7
Quelle: Spezifikation eines Buchungsereignisses; der Unterschied sind Richtung und Kennung des Ereignisses

Richtung und Kennung des Ereignisses: warum sie Pflicht sind

Für die Zeiterfassung muss jeder Eintrag ein Eingang oder ein Ausgang sein, und die Richtung des Lesegeräts erlaubt es, die Anwesenheit zu öffnen oder zu schließen. Die Kennung des Ereignisses verhindert, dass dieselbe Buchung zweimal gezählt wird, zum Beispiel bei einem erneuten Versand nach einer Unterbrechung der Leitung.

Die Regeln für die Paarung von Ein- und Ausgängen und für das Verwerfen von Duplikaten werden in der Spezifikation mit dem Anbieter der Zutrittskontrolle festgelegt, zusammen mit dem Umfang der Arbeiten auf beiden Seiten der Integration. Wir betrachten sie nicht als fertige Funktion zum Einschalten, sondern als Teil des Einführungsprojekts.

Was der Integrator der Zutrittskontrolle tut

Er konfiguriert die Richtung, die sich aus der Einstellung des Lesegeräts ergibt, etwa ein Lesegerät für den Eingang und eines für den Ausgang am selben Drehkreuz, und vergibt an die Ereignisse feste, eindeutige Kennungen, die bei erneutem Versand unverändert bleiben.

Was in der Spezifikation festgelegt wird

Auf Seiten von InnerWeb wird festgelegt, wie Richtung und Kennung übernommen werden, wie Duplikate verworfen werden und wie das Ereignis auf Eingang oder Ausgang in der Zeiterfassung abgebildet wird. Umfang und Zeitplan planen wir mit dem Kunden und dem Anbieter der Zutrittskontrolle.

Authentifizierung und Kontinuität des Versands

Der Webhook ist mit einem Token mit begrenzter Gültigkeit authentifiziert, das die Integration automatisch erneuert. Der Integrator behandelt eine ablehnende Antwort so, dass keine Ereignisse verloren gehen. Wir empfehlen eine Warteschlange auf Seiten des Systems der Zutrittskontrolle mit erneutem Versand in der ursprünglichen Reihenfolge und mit der ursprünglichen Zeit der Buchung am Lesegerät.

Bei einer Unterbrechung der Leitung von einer Stunde werden die Ereignisse mit der Zeit der Buchung gesendet und nicht mit der Zeit des Versands. Die Zeiterfassung zählt Minuten, daher ist die Zeit des Ereignisses am Lesegerät die Grundlage des Eintrags.

Reihenfolge der Einführung und der Tests

Wir empfehlen drei Schritte, jeder mit eigenem Abnahmekriterium.

  • Schritt 1: Probeversand der Ereignisse von einem Drehkreuz, Prüfung der Vollständigkeit der sieben Felder.
  • Schritt 2: Test des Duplikats und Test der Unterbrechung der Leitung, mit Richtung und Kennung in jedem Ereignis.
  • Schritt 3: Einschalten für die Testgruppe im Pilot des Zeitmoduls und Abgleich mit den Einträgen aus den QR-Scans.

Was das Werk von einem vollständigen Ereignis hat

Ein Werk mit einem System der Zutrittskontrolle hat zwei Quellen der Anwesenheit: Karten und QR-Scans. Vollständige Buchungsereignisse können die Zeiterfassung speisen, und InnerWeb verbindet sie mit Qualifikationen, Berechtigungen und Anwesenheit. Der Arbeitgeber führt die Zeiterfassung des Mitarbeiters als Grundlage für die Festsetzung des Entgelts und anderer Leistungen (Arbeitsgesetzbuch (Kodeks pracy), Art. 149 § 1). Eine einzige, konsistente Quelle des Eintrags verringert deshalb das manuelle Abgleichen.

Fragen Sie den Integrator vor dem Start nach drei Dingen: ob Ein- und Ausgangslesegeräte in der Konfiguration der Steuerungen unterschieden werden, ob das System der Zutrittskontrolle den Ereignissen dauerhafte Kennungen vergibt und wie lange es nicht zugestellte Ereignisse in der Warteschlange auf seiner Seite aufbewahrt. Halten Sie die Antworten im Protokoll vor der Einführung fest, denn davon hängt der Umfang der Arbeiten auf beiden Seiten der Integration ab.

Videomaterial

Häufig gestellte Fragen

Liefert InnerWeb Kartenlesegeräte?

Nein. InnerWeb integriert sich mit der bestehenden Zutrittskontrolle des Kunden, die Lesegeräte bleiben beim Kunden und seinem Integrator.

Welche Felder muss ein Ereignis der Buchung haben?

Die Zeit des Ereignisses am Lesegerät, den Ort, die Angaben zur Person, die Firma, die Nummer der aktiven Karte, die Richtung Eingang oder Ausgang und die Kennung des Ereignisses. Die Regeln für die Paarung und für das Verwerfen von Duplikaten werden in der Spezifikation mit dem Anbieter der Zutrittskontrolle festgelegt.

Wie wird der Webhook authentifiziert?

Das Token hat eine begrenzte Gültigkeit und wird von der Integration automatisch erneuert. Ereignisse warten in der Warteschlange des Systems der Zutrittskontrolle, wenn der Versand fehlschlägt.

Quellen

Geben Sie die Spezifikation an Ihren Integrator der Zutrittskontrolle weiter

Wir stellen für Ihren Integrator eine Beschreibung des Ereignisses und den Einführungsplan der Integration zusammen. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir