InnerWeb
Zum Inhalt springen

Zutrittskontrolle integrieren, ohne Leser zu tauschen

Ein Werk, das ein Arbeitsschutzsystem und die Arbeitszeiterfassung an eine bestehende Zutrittskontrolle anbinden will, sollte in der Anfrage an den Anbieter konkrete Anforderungen an den Versand der Buchungen festhalten. Dazu gehören Webhook, einheitliche Stammdaten, Übertragung in Echtzeit und ein Test im Echtbetrieb. Im Folgenden die Einkaufsanforderungen mit Begründung.

0
Leser, die ausgetauscht werden müssen
7
Anforderungen für die Anfrage
Quelle: Liste auf dieser Seite

Für wen und wann

Die Liste richtet sich an Einkauf und IT eines Werks, das eine funktionierende Zutrittskontrolle besitzt und ein Modul für Arbeitsschutz und Zeiterfassung ergänzen möchte. InnerWeb ist ein Softwarehersteller: Die Leser werden weder hergestellt noch ausgetauscht, sondern die Software wird als unabhängiges Zusatzsystem neben Zutrittskontrolle, Zeiterfassung, Personalwesen und ERP an das bestehende Zutrittssystem angebunden.

Die ausführliche Spezifikation der Integration von Zutrittskontrolle und Zeiterfassung liegt als PDF-Dokument vor und wird an den externen Anbieter weitergegeben. Die folgenden Anforderungen sind eine Kurzfassung davon für die Ausschreibung.

Anforderung 1: Versand der Buchungen per HTTP-POST-Webhook

Der Anbieter des Zutrittssystems soll bei jeder Kartenbuchung einen HTTP-POST-Aufruf an InnerWeb senden. Das ist die einfachste Form der Integration, denn sie erfordert keine Änderung an Lesern oder Schranken. In der Anfrage sollte festgehalten werden, dass der Anbieter die Möglichkeit eines solchen Versands in der aktuellen Softwareversion bestätigt und nicht nur für eine künftige Version.

Begründung: InnerWeb stellt eine API und Webhooks für die Anbindung an die Systeme des Werks bereit, daher genügt auf Seiten des Zutrittssystems die Einrichtung eines einzigen Aufrufs.

Parameter für die Anfrage

Parameter für die AnfrageDiagramm: sieben Anforderungen für die Anfrage und kein Leser, der ausgetauscht werden muss.02468AnzahlAnforderungen in der AnfrageAnforderungen in der Anfrage: 7 Anzahl7Leser, die ausgetauscht werdenLeser, die ausgetauscht werden: 0 Anzahl0
Quelle: Liste der Anforderungen auf dieser Seite

Anforderung 2: Authentifizierung per Token und dessen Erneuerung

Der Aufruf benötigt einen Token aus dem Anmeldeendpunkt der API. Der Token ist zeitlich begrenzt gültig und wird durch die Integration automatisch erneuert. Der Anbieter sollte bestätigen, dass seine Software den Token automatisch erneuern und abgewiesene Meldungen wiederholen kann.

Kann die Software des Zutrittssystems eine solche Anmeldung nicht durchführen, benötigt die Integration eine Zwischenschicht. Deren Kosten und Zeitaufwand müssen im Angebot bewertet werden.

Anforderung 3: vollständige Felder und einheitliche Schreibweise

Die Meldung sollte Zeitpunkt der Buchung, Buchungsort, Vor- und Nachname, Firmenname und die Nummer der aktiven Karte enthalten, optional Kürzel, Telefon, E-Mail und Sprache. Pflicht sind Vor- und Nachname sowie der Firmenname.

In der Anfrage sollte festgehalten werden, dass der Firmenname aus einer einzigen Stammdatenliste stammt. Eine Buchung einer dem System unbekannten Person legt Konto und Firma aus den Meldungsdaten an, und unterschiedliche Schreibweisen erzeugen Dubletten.

Anforderung 4: Übertragung in Echtzeit

Anforderung an den Anbieter: Das Zutrittssystem sendet jedes Ereignis in Echtzeit, mit dem am Leser erfassten Zeitpunkt, der Richtung (Eingang oder Ausgang) und der Ereigniskennung. Nach einem Leitungsausfall wird die Warteschlange nachträglicher Ereignisse innerhalb einer festgelegten Zeit geleert, und die Ereignisse behalten ihren ursprünglichen Zeitpunkt. Als Parameter für die Abnahme sollte die zulässige Verzögerung in Minuten festgehalten werden.

Anforderung 5: Robustheit bei Ereignisserien

In einem Werk mit vielen Zeitarbeitsfirmen kann der Kartenverkehr an einem Werktag 2.000 Buchungen überschreiten. Der Anbieter sollte dokumentieren, dass sein Versand Ereignisserien zu Schichtbeginn bewältigt und Meldungen nicht unnötig wiederholt. Dank der Ereigniskennung erzeugt eine Wiederholung keinen Doppeleintrag; die genauen Regeln für das Verwerfen von Dubletten werden mit dem Anbieter in der Spezifikation festgelegt.

Anforderung 6: Liste der Buchungsorte und Abnahmetest

Der Anbieter übermittelt die vollständige Liste der Bezeichnungen der Buchungsorte (Leser). Ereignisse von einem Ort ohne Vorlage in InnerWeb landen im Protokoll und lösen keinen Schulungsalarm aus, daher ist eine vollständige Liste Voraussetzung für eine wirksame Kontrolle.

Der Abnahmetest sollte die Buchung einer bekannten Person, einer dem System unbekannten Person und einer Person aus einer Fremdfirma an jedem Ort der Liste umfassen.

Anforderung 7: Einschränkungen im Vertrag festhalten

Der Webhook allein ohne Zuordnung zu Eingängen ergibt keine Zeiterfassung: Eine Buchung in der Kontohistorie ist noch kein Eintrag im Eingangsregister. Der Vertrag sollte deshalb den Umfang trennen: Was der Anbieter des Zutrittssystems leistet (Versand der Ereignisse mit Zeitpunkt, Richtung und Kennung) und was in InnerWeb eingerichtet wird (Vorlagen, in der Spezifikation festgelegte Paarungsregeln, das bei Bedarf vom Administrator aktivierte Modul mRCP).

Videomaterial

Häufig gestellte Fragen

Liefert InnerWeb Leser für die Integration mit der Zutrittskontrolle?

Nein. InnerWeb ist ein Softwarehersteller und integriert sich mit den Lesern, die das Werk bereits besitzt.

Liefert der Webhook allein die Arbeitszeiterfassung?

Nein. Dafür ist die Zuordnung der Buchungen zu Eingängen nötig und die Aktivierung des Moduls mRCP durch den Administrator.

Wer liefert die Spezifikation der Integration?

InnerWeb übergibt dem Anbieter der Zutrittskontrolle das Spezifikationsdokument für die Anbindung der Kartenbuchungen an die Zeiterfassung.

Bereiten Sie die Anfrage an den Zutrittsanbieter vor?

Kontaktieren Sie InnerWeb. Wir stellen Ihnen die Spezifikation der Integration zur Verfügung und helfen bei der Formulierung der Anforderungen.

Sprechen wir