Dies ist eine alte Version des Dokuments!
Inhaltsverzeichnis
3522 – Zeitbuchungen an Zalaris exportieren
Mit KaDeWeZa Zeitereignisse stellt PEP4 Kommen- und Gehen-Buchungen für Zalaris/SAP bereit. Sie finden den Export unter Zeiten. Sie können ihn manuell starten oder in der Schnittstellenautomatik einplanen.
Welche Buchungen werden exportiert?
PEP berücksichtigt aktive Buchungen ab dem eingestellten Anfangsdatum. Dazu zählen Buchungen mit einer hinterlegten Terminalnummer ungleich 0. Auch bei Terminalnummer 0 kommt eine Buchung für den Export infrage, wenn sie aus WebZerf übernommen wurde oder bereits mit SAP abgeglichen oder für SAP ausgegeben wurde.
Eine bereits ausgegebene oder von SAP gelieferte Buchung wird bei weiteren Läufen übersprungen, solange Uhrzeit und Buchungsart gleich bleiben. Ein Storno allein erzeugt keine Meldung an SAP.
Was lässt sich einstellen?
Den Ausgabeordner wählen Sie beim Einrichten oder Starten der Schnittstelle. Anfangsdatum und Terminalkennung finden Sie in den ZW-Einstellungen unter Schnittstellen → SAP - KDW.Zal.
| Einstellung | Parameter | Bedeutung |
|---|---|---|
| Ausgabeordner | PFAD | Wählen Sie einen vorhandenen Ordner, in den PEP schreiben darf. Bei automatischer Ausführung muss der Ordner für den ZW-Worker erreichbar sein. |
| Frühestes Buchungsdatum | SCHNITT_ZAL_ZE_DATMIN | Standard ist -30. PEP berücksichtigt damit Buchungen ab dem Tag, der 30 Tage vor dem jeweiligen Export liegt, einschließlich dieses Tages. Mit 0 beginnt die Auswahl am heutigen Tag. Sie können auch ein festes Datum wie 2026-11-01 eintragen. |
| Terminalkennung für Zalaris | SCHNITT_ZAL_ZE_TERMINAL | Standard ist 999. Diese Kennung steht bei jeder exportierten Buchung in der Datei. Sie dient als gemeinsame Kennung für Zalaris. Buchungen verschiedener Erfassungsterminals können in derselben Datei stehen. |
Was steht in der Datei?
PEP legt pro Lauf eine XML-Datei im Ausgabeordner ab, zum Beispiel 20261118_091500_Zeitereignis.xml für einen Export am 18.11.2026 um 09:15 Uhr. Jeder Eintrag enthält Personalnummer, Buchungsdatum, Uhrzeit auf die Sekunde, Buchungsart (P10 für Kommen, P20 für Gehen) und die eingestellte Terminalkennung. Die Felder für Abwesenheitsgrund und Tageszuordnung bleiben leer. Gibt es keine passenden Buchungen, entsteht eine XML-Datei ohne Buchungseinträge.
Welchen SAP-Status erhält die Buchung?
Der SAP-Status (SapSync) zeigt, wie weit der Abgleich für diese Buchung ist. Für die Zeitberechnung zählt außerdem, ob die Buchung aktiv oder als gelöscht markiert ist. Eine als gelöscht markierte Buchung bleibt in PEP gespeichert.
| SAP-Status | Wann setzt PEP ihn? | Was passiert mit der Buchung? |
|---|---|---|
| 0 – Lokal | Eine Buchung wird lokal neu angelegt oder als geänderte Fassung zum Versand vorgemerkt. | Eine aktive Buchung zählt bereits für die Zeitberechnung. Die Versandfrist hat noch nicht begonnen. |
| 1 – An SAP gesendet | Der Export hat die fertige XML-Datei im Ausgabeordner bereitgestellt. | Die Buchung bleibt aktiv. PEP speichert den Versandzeitpunkt und wartet auf die SAP-Rücklieferung. Ein weiterer Exportlauf mit unveränderter Buchung verlängert die Frist nicht. |
| 2 – Von SAP bestätigt | SAP liefert für dieselbe Person dieselbe Buchungszeit und Buchungsart. | PEP bestätigt die vorhandene Buchung oder legt eine erstmals gelieferte Buchung aktiv an. Ein ausdrücklich in WebZerf storniertes Original bleibt gelöscht. |
| 3 – Frist abgelaufen | Beim SAP-Dateiimport ist eine aktive, unveränderte Buchung seit mindestens 48 Stunden im Status 1 und weiterhin unbestätigt. | PEP markiert die Buchung als gelöscht. Sie zählt danach nicht mehr für die Zeitberechnung. Eine spätere passende SAP-Lieferung kann dieselbe Buchung wieder aktivieren und auf Status 2 setzen. |
| 4 – In SAP entfallen | Eine bestätigte und seither unveränderte Buchung fehlt im neueren vollständigen SAP-Tagesstand für genau diese Person. | PEP markiert die Buchung als gelöscht. Diese PEP-ID bleibt gelöscht. Fehlt die Person oder der ganze Tag in der Lieferung, setzt PEP deshalb keinen Status 4. |
| 5 – Altversand | Bei der Umstellung wurde eine frühere Auswahl für den SAP-Export übernommen. | Die unveränderte Buchung behält ihr Löschkennzeichen und wird beim Export übersprungen. Es läuft keine Frist. Eine passende SAP-Lieferung setzt sie auf 2, der Versand einer geänderten aktiven Fassung auf 1. |
Wann prüft PEP die 48 Stunden? Ausgangspunkt ist der gespeicherte Versandzeitpunkt (SapGesendetUtc, UTC). Bei jedem erfolgreichen SAP-Dateiimport verarbeitet PEP zuerst die Bestätigungen und prüft anschließend die offenen Fristen aller Personen. Das gilt auch für eine leere Datei oder eine Lieferung, die nur andere Personen enthält. Ohne Dateieingang bleibt die Prüfung bis zum nächsten Import aus.
Beispiel: WebZerf korrigiert Kommen von 08:10 auf 08:00
| Vorgang | Original 08:10 | Korrektur 08:00 |
|---|---|---|
| SAP liefert 08:10 zum ersten Mal. | 2, aktiv | Noch nicht vorhanden |
| WebZerf storniert die ursprüngliche Stempelbuchung und PEP übernimmt die Korrektur. | 2, als gelöscht markiert | 0, neu und aktiv |
| PEP stellt die Ausgabedatei mit 08:00 für SAP bereit. | 2, gelöscht | 1, aktiv, Frist beginnt |
| SAP liefert den Tag mit beiden Zeiten zurück. | 2, bleibt storniert | 2, dieselbe Buchung bleibt aktiv |
Für die Zeitberechnung zählt damit nur 08:00. Die Rücklieferung legt keine zweite Kommen-Buchung an.