====== 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. Der Export erkennt Änderungen durch den Vergleich beim Lauf. Dafür ist kein Datenbanktrigger erforderlich. 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** | Zur lokalen Buchung fehlt ein SAP-Vergleichsstand, oder Person, Buchungszeit oder Buchungsart haben sich seit dem letzten Abgleich geändert. | 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. [[schnittstellen:1321|1321 – Zeitereignisse aus Zalaris importieren]]