InnerWeb
Zum Inhalt springen

Angebotsanfrage für Karten und Leser: Integrationsanforderungen der Zutrittskontrolle

Einkauf und IT fragen nach Preisen für Karten und Leser, lassen aber häufig die Integration mit der Zeiterfassung aus und zahlen später für eine Ergänzung außerhalb des Angebots. Im Folgenden die Anforderungen, die in die Angebotsanfrage gehören, damit nach dem Tausch die Erfassung der Arbeitszeit und die Berichte erhalten bleiben.

12 h
Gültigkeit des JWT-Tokens der Integration
Quelle: Spezifikation der Integration
13 h
Grenze für das Paaren von Eingang und Ausgang
Quelle: Spezifikation der Integration

Warum Integrationsanforderungen in die Anfrage gehören

Eine Angebotsanfrage für Karten und Leser beschreibt meist die Technik: Kartentyp, Protokoll des Lesers, Stückzahl. Seltener wird beschrieben, was mit der Buchung auf dem Server geschieht. Erfasst das Werk die Arbeitszeit aus den Buchungen, bedeutet das Fehlen dieser Beschreibung das Risiko, dass die Berichte nach dem Tausch nicht mehr übereinstimmen.

InnerWeb ist Softwarehersteller und liefert keine Leser. Die Software übernimmt die Buchungsereignisse aus dem Zutrittssystem und verknüpft sie mit den Arbeitstagen. Die folgenden Anforderungen dienen dazu, dass der Zutrittsanbieter diese Ereignisse ohne zusätzliche Verhandlungen übermitteln kann.

Empfehlung 1: HTTPS-POST vom Server des Zutrittssystems

Nehmen Sie die Anforderung auf, dass der Server des Zutrittssystems bei jeder Buchung eine HTTPS-POST-Meldung an die angegebene Adresse sendet. So müssen im Netz des Werks keine eingehenden Ports geöffnet werden, weil der Verkehr ausgehend ist. Der Anbieter sollte im Angebot bestätigen, dass sein Server eine solche Meldung sendet.

Die Authentifizierung der Integration erfolgt über ein technisches Konto und ein JWT-Token mit 12 Stunden Gültigkeit. Halten Sie in der Anfrage fest, dass der Anbieter die Erneuerung des Tokens sicherstellen muss.

Technische Grenzwerte der Integration der Buchungen

Technische Grenzwerte der Integration der BuchungenBalkendiagramm: Token gültig 12 Stunden, Grenze der Paarung 13 Stunden051015StundenGültigkeit des JWT-TokensGültigkeit des JWT-Tokens: 12 Stunden12Paarung Eingang und AusgangPaarung Eingang und Ausgang: 13 Stunden13
Quelle: Spezifikation der Integration der Buchungen aus dem Zutrittssystem

Empfehlung 2: Inhalt der Meldung

Die Meldung sollte die Buchungszeit vom Controller, die Kennung des Lesers, die Person, die Kartennummer im Format Objektkennung-Nummer sowie optional die Richtung und die Ereignis-ID enthalten. Die Zeit vom Controller ist wichtig, weil eine Warteschlange im Offline-Betrieb bei einer Störung der Verbindung die Übermittlung verzögert.

Die Ereignis-ID (Idempotenz) und die Zeit vom Controller schützen die Arbeitstage davor, durch ein erneutes Senden verfälscht zu werden. Nehmen Sie diesen Punkt als Anforderung in die Anfrage auf oder, falls der Anbieter ihn nicht gewährleistet, als Abweichung, die zu begründen ist.

Empfehlung 3: Richtung von Eingang und Ausgang

Fragen Sie an, ob das System die Richtung übermittelt. Ist dies nicht der Fall, verknüpft InnerWeb Eingang und Ausgang in der Software paarweise, mit einer Grenze von 13 Stunden zwischen Eingang und Ausgang. Das funktioniert zuverlässig, verlangt aber eine Beschreibung der Leser: Getrennte Leser für Eingang und Ausgang erfassen wir im Leser-Glossar.

Empfehlung 4: Kartenexport und Liste der Leser

Vor der Integration mit dem Zutrittsanbieter zu klären: ob sein Server HTTPS-POST sendet, die Liste der Leser und der Export der Karten (Objektkennung und Nummer) zur Personalnummer. Nehmen Sie dies als Anlage zum Vertrag auf: Export der Karten im CSV-Format mit Objektkennung, Nummer und Personalnummer.

Die Karten lassen sich den Personen per CSV-Import zuordnen, daher ist der Export des Anbieters der Treibstoff des gesamten Prozesses. Fehlt er, erfolgt die Zuordnung von Hand und der Zeitplan verzögert sich.

Empfehlung 5: Was das Angebot ausschließt und was beim Werk bleibt

Halten Sie in der Anfrage fest, dass die Logik des Zutrittssystems unverändert bleibt: Der Anbieter übernimmt weder die Berechnung der Arbeitstage noch Schichtpläne, Ausnahmen oder Berichte. Die gesamte Verarbeitung (Erkennung von Ein- und Ausgang, Zusammenfassung zu Arbeitstagen, Schichtpläne, Ausnahmen, Berichte) erfolgt bei InnerWeb.

Halten Sie auch die Kosten außerhalb des Softwareumfangs fest: Ein QR-Code-Leser an der Pforte liegt bei etwa 1.000 PLN netto pro Gerät und ist nicht Teil des Angebots von InnerWeb (Richtwerte aus Umsetzungen 2025–2026; Preis im Einzelfall). Der Anbieter sollte die Stückpreise für Karten und Leser getrennt ausweisen.

Empfehlung 6: Unbekannte Karten und Nachweis der Abnahme

Nehmen Sie ein Abnahmekriterium auf: Die Liste der Buchungen unbekannter Karten muss nach dem Tausch leer sein oder erklärt werden. Die Buchung einer unbekannten Karte landet in der Warteschlange „Karte zuzuordnen“, statt ein Konto aus einer unbekannten Buchung anzulegen. Damit ist sie ein fertiger Messwert.

Videomaterial

Häufig gestellte Fragen

Muss die Anfrage InnerWeb nennen?

Nein. Es genügt die Beschreibung der Anforderungen: HTTPS-POST, Inhalt der Meldung, Kartenexport. Der Zutrittsanbieter erfüllt sie unabhängig vom Namen des Empfängers.

Müssen Ports im Netz des Werks geöffnet werden?

Nein. Der Server des Zutrittssystems sendet die Meldung per HTTPS-POST, der Verkehr ist also ausgehend.

Wer berechnet die Arbeitstage?

InnerWeb auf Ebene der Software. Die Logik des Zutrittssystems bleibt unverändert.

Quellen

Nehmen Sie die Integrationsanforderungen in Ihre Anfrage auf

Wir übergeben die Spezifikation der Buchungen an den Zutrittsanbieter und prüfen, ob das Angebot den Bedarf der Zeiterfassung abdeckt. Vereinbaren Sie ein Gespräch mit InnerWeb.

Sprechen wir