Benutzer-Werkzeuge

Webseiten-Werkzeuge


schnittstellen:1321

Schnittstelle 1321 – Zalaris Zeitereignisse

Programm 1321 übernimmt Kommen- und Gehen-Buchungen aus SAP-HCM nach PEP4. SAP liefert für jede ausgewählte Person alle gültigen Ereignisse des betreffenden Tages. PEP gleicht diesen Tagesstand mit den vorhandenen Buchungen ab. Dazu gehören auch Buchungen, die über WebZerf korrigiert und von PEP an SAP ausgegeben wurden.

Geltungsstand 18.11.2026 für den Desktop mit Datenbankupdate 922. Der Rückweg zu SAP ist 3522 – Zeitereignisse als XML exportieren. WebZerf verwendet 3520 – WebZerf. Alle Personen, IDs und Lieferungen in den Beispielen sind fiktiv.

Welche Daten liefert SAP?

1321 liest aus dem eingestellten PFAD Dateien nach dem Muster YYYYMMDD_HHMMSS_SAP_PEP4_TEVEN.csv. Der Zeitstempel im Namen bezeichnet den Erstellungsstand der Datei. Der Buchungstag steht in der jeweiligen Zeile. Die Datei enthält durch Semikolon getrennte Werte ohne Kopfzeile. Ein Beispiel für Person 1234 am 16. November 2026:

00001234;20261116;081000;P10;07;;;
00001234;20261116;170000;P20;07;;;
Position und SAP-Feld Bedeutung für PEP
1 · TEVEN-PERNR Positive Personalnummer mit bis zu acht Ziffern. Führende Nullen sind zulässig. Die Nummer muss in Personen.PersonID existieren.
2 · TEVEN-LDATE Logisches Datum im Format yyyyMMdd. Bestimmt den Personentag des Abgleichs.
3 · TEVEN-LTIME Logische Uhrzeit im Format HHmmss. PEP vergleicht auf die Sekunde.
4 · TEVEN-SATZA P10 ergibt K für Kommen, P20 ergibt G für Gehen. Eine unbekannte Ereignisart ist ein Dateifehler.
5 · TEVEN-TERID Externe Terminal-ID. Bei einer neuen Buchung übernimmt PEP einen gefüllten Wert einschließlich führender Nullen als Kommentar, z. B. SAP-Terminal: 07. Das Feld darf leer sein.
Ab 6 · TEVEN-ABWGR, DALLF, ORIGF Die nachfolgenden Angaben werden übersprungen. Sie beeinflussen weder den Abgleich noch die Tageszuordnung.

Nach dem SAP-Liefervertrag enthält die Datei nur gültige Zeitereignisse (TEVEN-STOKZ leer). Auch bei einer Delta-Lieferung übermittelt SAP für einen ausgewählten Personentag den vollständigen Bestand. Ein Tag mit nur einer gelieferten Zeile gilt daher als vollständig. Fehlt ein Personentag ganz in der Datei, liegt für diesen Tag keine Aussage über den SAP-Bestand vor.

Wie entscheidet der Tagesabgleich?

  1. PEP vergleicht den Zeitstempel aus dem Dateinamen mit dem letzten verarbeiteten Lieferstand für genau diese Person und diesen Tag. Nur ein neuerer Stand ersetzt den Tagesstand. Andere Personen oder Tage derselben Datei können trotzdem neu sein.
  2. Eine Buchung wird über Person, Datum, Uhrzeit auf die Sekunde und Kommen/Gehen erkannt. Terminal und Kommentar können abweichen. Gleiche Zeilen innerhalb des gelieferten Tages werden zusammengefasst. Bei einem aktiven Treffer bleiben die PEP-ID, die WebZerf-Zuordnung und das ursprüngliche Terminal erhalten.
  3. Bei exakter Übereinstimmung hat eine aktive Buchung Vorrang. Danach prüft PEP eine wegen Fristablaufs gelöschte Buchung und anschließend ein ausdrücklich storniertes Ereignis. Nur eine durch Fristablauf gelöschte Buchung kann dadurch wieder aktiv werden. Eine bereits als in SAP entfallen abgeschlossene ID (Status 4) ist vom Abgleich ausgeschlossen.
  4. Hat sich die Buchungszeit oder Buchungsart unter derselben PEP-ID geändert, vergleicht der Import jede SAP-Zeile mit den tatsächlich vorhandenen Buchungen. Liefert SAP für dieselbe Sekunde Kommen und Gehen, können beide Ereignisse vorhanden sein.
  5. Fehlt eine Zuordnung, legt PEP das gelieferte Ereignis an. Fehlt umgekehrt eine zuvor bestätigte, seither unveränderte Buchung im neueren Stand ihres Tages, erhält sie Status 4 und das Löschkennzeichen. Eine lokale Buchung oder ein unbestätigter Altversand bleibt bei dieser Prüfung erhalten. Für einen aktuellen, noch unbestätigten Versand gilt die Fristregel.

Das CSV enthält keine eindeutige externe Ereignis-ID. Liefert SAP neben einer lokalen Korrektur auch die frühere Buchungszeit, kann eine zusätzliche Buchung entstehen. Ein fachlicher Konflikt wird bei der Zeitberechnung sichtbar.

SAP-Status und Wirksamkeit

Der SAP-Status bezieht sich auf die Buchungsfassung in der Schnittstellentabelle. Ohne passenden Vergleichsstand gilt die lokale Fassung als Status 0. Für die Zeitberechnung zählt zusätzlich das Löschkennzeichen der Buchung. Auch ein von SAP bestätigtes Ereignis kann durch ein ausdrückliches Web-Storno unwirksam sein.

Wert Bezeichnung für die Anzeige Bedeutung und nächster Übergang
0 Lokal Die lokale Fassung hat keine laufende Frist. Ein passender SAP-Eingang bestätigt sie mit 2. Bei einer exportfähigen Buchung setzt die Ausgabe den Wert auf 1.
1 An SAP gesendet PEP hat die XML-Datei bereitgestellt. Eine passende Rücklieferung bestätigt die Fassung mit 2. Nach mindestens 48 Stunden kann sie beim nächsten Import auf 3 wechseln.
2 Von SAP bestätigt SAP hat diese Fassung geliefert. Fehlt sie im nächsten neueren Stand ihres Tages und blieb sie unverändert, setzt PEP Status 4. Eine Wiederholung hebt ein ausdrückliches Web-Storno nicht auf.
3 Frist abgelaufen PEP hat die noch unbestätigte Fassung wegen Fristablaufs als gelöscht markiert. Eine verspätete passende SAP-Lieferung kann dieselbe PEP-ID wieder aktivieren und auf 2 setzen.
4 In SAP entfallen Die bestätigte Fassung ist aus dem gelieferten Tagesbestand verschwunden. Die ID bleibt gelöscht. Liefert SAP später wieder ein eigenständiges gleiches Ereignis, kann PEP dafür eine neue ID anlegen.
5 Altversand Die Migration hat eine historische Auswahl für SAP übernommen. Eine unveränderte Buchung wird weder erneut ausgegeben noch nach 48 Stunden gelöscht. Eine passende SAP-Zeile setzt sie auf 2. Eine spätere Änderung von Zeit oder Kennung ist als neue Fassung exportierbar.

Wann laufen die 48 Stunden ab? Bei jedem erfolgreichen Datenimport einer SAP-Datei verarbeitet PEP zuerst deren gültige Tagesstände. Anschließend prüft PEP für alle Personen und Tage die aktiven, weiterhin unveränderten Buchungen im Status 1. Maßgeblich sind die tatsächliche UTC-Zeit des SQL-Servers und SapGesendetUtc. Eine Wiederholung des Exports derselben Fassung verlängert die Frist nicht. Eine bestätigende Zeile in einem neuen Tagesstand derselben Datei kommt noch rechtzeitig, selbst wenn die 48 Stunden beim Einlesen bereits erreicht sind.

Auch eine gültige leere Datei oder eine Datei mit ausschließlich schon verarbeiteten Tagesständen stößt die Fristprüfung an. Ohne eingegangene Datei führt Programm 1321 keine Fristprüfung aus. Eine bestätigte Buchung (2) unterliegt dieser Frist nicht. Löscht SAP das letzte Ereignis eines Tages und liefert danach gar keine Zeile mehr für diesen Personentag, kann PEP die Löschung aus diesem Dateiformat nicht erkennen.

Beispiele für den Datenlauf

WebZerf korrigiert 08:10 auf 08:00

Schritt Lieferung oder Aktion Ergebnis in PEP
1 SAP liefert 08:10 Kommen. PEP übergibt die Zeit an WebZerf. PEP-ID 4711 ist aktiv, SapSync=2.
2 WebZerf korrigiert die ursprüngliche Stempelbuchung erstmals auf 08:00. Bei einem Genehmigungsverfahren wird die Änderung mit der Genehmigung wirksam. Das Original 4711 bleibt mit geloescht=1 erhalten. Für 08:00 gibt es die neue aktive PEP-ID 4712.
3 SAP liefert vor Verarbeitung der Korrektur den Tag erneut, diesmal mit 08:10 Kommen und neu 17:00 Gehen. PEP erkennt 08:10 am stornierten Original. 17:00 wird übernommen. Für den Arbeitsbeginn zählt weiterhin allein 08:00.
4 PEP gibt 08:00 an SAP aus. SAP ergänzt die Zeit und liefert den Tag mit 08:00, 08:10 und 17:00 zurück. 4712 wechselt bei Ausgabe auf 1 und bei Bestätigung auf 2. Es entsteht keine zweite 08:00. 4711 bleibt gelöscht, auch wenn SAP weiterhin 08:10 meldet.
5 SAP löscht 08:00 und liefert im neueren Tagesstand weiterhin 08:10 und 17:00. Die bestätigte 4712 fehlt, bekommt Status 4 und geloescht=1. Auch 4711 bleibt storniert. 17:00 ist weiterhin aktiv. Eine nun fehlende Kommen-Buchung betrifft die Berechnung dieses Tages.

Wird eine bereits manuell angelegte WebZerf-Buchung nochmals bearbeitet, kann die Korrektur dieselbe ID behalten. War 08:00 schon ausgegeben und ist die aktuelle Zeit inzwischen 07:55, gibt PEP 07:55 als geänderte Fassung aus. Liefert SAP beide Zeiten, werden beide als eigenständige Buchungen berücksichtigt.

Eine andere Person löst den Fristablauf aus

Am Montag um 09:00 UTC gibt PEP die Buchung von Anna aus, um 11:00 UTC die von Ben. Am Mittwoch um 10:00 UTC kommt eine SAP-Datei ausschließlich für Carla. Annas Fassung ist seit 49 Stunden unbestätigt. Sie erhält Status 3 und wird für die Berechnung unwirksam. Bens Fassung ist 47 Stunden alt und behält Status 1. Beide Entscheidungen sind unabhängig von Carlas Buchungsdatum.

Liefert SAP am Mittwoch um 12:00 UTC Annas passende Buchung in einem neuen Stand ihres Tages, wird ihre PEP-ID wieder aktiv und erhält Status 2. Falls WebZerf die zwischenzeitliche Löschung bereits quittiert und das Webobjekt entfernt hat, kann die nächste WebZerf-Synchronisation eine neue Web-ID vergeben.

SAP verarbeitet und löscht vor der ersten Rücklieferung

PEP gibt eine WebZerf-Buchung mit 08:00 aus. SAP übernimmt und löscht sie, bevor ein Delta entsteht. PEP erhält deshalb nie eine Bestätigung dieser Zeit. Die Buchung bleibt zunächst in Status 1. Die erste erfolgreiche Datei ab Ablauf der 48 Stunden setzt sie auf 3, auch wenn SAP die Person überhaupt nicht mehr liefert. PEP kann aus diesem Ablauf allein nicht erkennen, ob SAP die Zeit gelöscht oder noch nicht verarbeitet hat. Liefert SAP die Zeit verspätet, gilt die Rückkehrregel für Status 3.

Wiederholte Datei und Altversand

  • Eine Datei mit Erstellungsstand 14:13 enthält einen neueren Stand für Person 1234 als die Datei von 14:04 desselben Tages. Wird 14:04 danach nochmals eingelesen, bleibt für Person 1234 der Stand von 14:13 gültig. Eine in 14:04 ebenfalls enthaltene Person ohne jüngeren oder gleichen Stand wird regulär verarbeitet.
  • Zu einer alten PEP-ID kennt die Migration nur die Auswahl für einen früheren SAP-Export. Die Buchung steht mit 08:30 Kommen in PEP und erhält Status 5. Auch nach drei Tagen ohne Rückmeldung bleibt sie bestehen. Liefert SAP 08:30, geht sie auf 2 und kann bei späterem Fehlen im vollständigen Tag auf 4 wechseln. Wird die lokale Zeit stattdessen zuvor auf 08:25 geändert, startet mit der Ausgabe der geänderten Fassung der reguläre Ablauf bei 1.

Wo speichert PEP den SAP-Stand?

Die eigentliche Buchung steht in Zeitereignisse. Ihre Person, Buchungszeit, Buchungsart und ihr Löschkennzeichen sind für die Zeitberechnung maßgeblich. Die SAP-Schnittstelle führt ihren eigenen Stand in SCHNITT_ZalarisTevenTag.

Eintrag Inhalt und Verwendung
Personentag Person, Tag und Erstellungszeit der jüngsten verarbeiteten SAP-Datei. So kann eine ältere Lieferung den Tagesbestand nicht zurücksetzen.
Einzelne Buchung PEP-ID, Person, Buchungsdatum mit Uhrzeit, Kommen/Gehen und SAP-Status. Beim Versand merkt sich PEP zusätzlich den UTC-Zeitpunkt für die offene 48-Stunden-Frist.
Lokale Buchung ohne SAP-Kontakt Sie benötigt keinen Eintrag in der Schnittstellentabelle. Ein späterer Export erkennt sie anhand der Auswahlregeln.

Beim Kundenupdate von Stand 918 übernimmt PEP vorhandene Buchungen aus der bisherigen Versandauswahl als 5 – Altversand. Für diese Buchungen läuft keine Versandfrist. Das Update legt alle SAP-Felder direkt in der Schnittstellentabelle an.

Dateiergebnis, Archiv und Nachberechnung

Die SQL-Prozedur dbo.SCHNITT_ZALARIS_TEVEN speichert Ereignisse, Tagesstände und Vormerkungen zusammen. Nach erfolgreichem Datenbank-Commit verschiebt der Import die Datei in IMP unter dem Eingangspfad. Fehler bei Format, unbekannter Personalnummer, Datenbankzugriff oder Archivierung erscheinen im Schnittstellenprotokoll. Bei bereits belegtem Archivnamen vergleicht PEP den Inhalt. Abweichender Inhalt unter demselben Namen ist ein Fehler. Ein erneuter Lauf nach einem Archivierungsfehler kann dank des gespeicherten Lieferstands einen bereits übernommenen Tag wiedererkennen.

Die Schnittstelle merkt die betroffenen Tage direkt beim Speichern vor. Dafür muss kein Datenbanktrigger eingerichtet werden. Nach Abschluss des Imports berechnet PEP die vorgemerkten Bereiche je Person über CalcZeitAuswahl. Ein Fehler bei einer einzelnen Nachberechnung macht den abgeschlossenen Dateiimport nicht fehlerhaft. Weitere Personen werden bearbeitet. Für die Nachverfolgung ist der Tagesstatus maßgeblich. Ein reiner Berechnungsfehler gehört weder in das Schnittstellenprotokoll noch in das PEP3-Log.

Technische Grundlage. Desktop-Klassen cSchnittZalarisZeitereignisse und cSchnittZalZeitOut, SQL-Prozeduren SCHNITT_ZALARIS_TEVEN und Get_SCHNITT_Zeitereignisse, Datenbankupdates 0920 bis 0922. Die SQL-Prüffälle für Wiederholung, Webkorrektur, Fristablauf und Migration liegen im Desktop-Projekt unter tests/WebZerfSync. Der beschriebene Stand wurde mit isolierten Prüfdaten abgeglichen. Die produktive SAP-Gegenstelle war nicht Teil der Prüfung.

Cookies helfen bei der Bereitstellung von Inhalten. Diese Website verwendet Cookies. Mit der Nutzung der Website erklären Sie sich damit einverstanden, dass Cookies auf Ihrem Computer gespeichert werden. Außerdem bestätigen Sie, dass Sie unsere Datenschutzerklärung gelesen und verstanden haben. Wenn Sie nicht einverstanden sind, verlassen Sie die Website.Weitere Information
schnittstellen/1321.txt · Zuletzt geändert: (Externe Bearbeitung)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki