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
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