Inhaltsverzeichnis

Schnittstelle 1501 – Personalakte Lohnnachweise

Importiert PDF-Lohnnachweise aus einem Ordner in die Personalakte. In PEP4 unter Schnittstellen → Stammdaten den Eintrag Personalakte Lohnnachweise auswählen und Ausführen anklicken. Das Programm ist für den manuellen Start registriert (InAutomatik = False).

Einstellungen vor dem ersten Import

Die Einstellungen findest du unter Einstellungen ZW → Schnittstellen → Lohnnachweis.

Einstellung Technischer Schlüssel Standard Wirkung
Dateinamenmuster SCHNITT_Lohnnachweis_Dateimuster LOHN_{PNR}.pdf Legt fest, wie PEP4 den Dateinamen erkennt und daraus Person, Abrechnungszeitraum und gegebenenfalls SAP-Personalbereich liest. Beim Standardmuster ist {PNR} die interne PEP4-PersonID. Monat und Jahr werden beim Start eingegeben.
Ordner-ID Personalakte SCHNITT_Lohnnachweis_OrdnerID 0 0 legt den Nachweis ohne Ordnerzuordnung ab. Für einen Zielordner dessen gültige positive ID aus PersonDokumenteOrdner eintragen. PEP4 prüft die ID vor dem Import. Die Vertraulichkeit des gewählten Ordners gilt für die dort abgelegten Nachweise. Bereits vorhandene Nachweise werden bei einem Wiederholungslauf nicht verschoben.

SAP-Personalbereich in den Filialstammdaten: Wenn das Muster {SAPPersonalbereich} enthält, pro relevanter Filiale den vierstelligen SAP-Personalbereich im Feld SAPPersonalbereich pflegen. Das Datenbankfeld dbo.Filialen.SAPPersonalbereich wird über SQL-Update 0918 bereitgestellt. Es speichert vier Ziffern als Text, einschließlich führender Nullen. Das Feld kann leer bleiben, wenn der SAP-Abgleich für die Filiale nicht benötigt wird.

Die SQL-Befehle des Imports verwenden außerdem Einstellungen ZW → Allgemein → Server → SQL TimeOut (SQL_TIMEOUT, Standard 60 Sekunden).

Parameter beim Start

Parameter Eingabe Bedeutung
PFAD Vorhandener Quellordner Pflichtangabe. PEP4 liest die PDFs direkt in diesem Ordner. Unterordner werden nicht durchsucht.
MONAT Ganze Zahl 1 bis 12 oder 0 (Standard) 0 setzt voraus, dass das Dateimuster {Monat} liefert. Steht der Monat im Dateinamen, hat dieser Wert Vorrang.
JAHR Ganze Zahl 1000 bis 9999 oder 0 (Standard) 0 setzt voraus, dass das Dateimuster {Jahr} liefert. Steht das Jahr im Dateinamen, hat dieser Wert Vorrang.

Dateinamenmuster

Das Muster gilt für den vollständigen Dateinamen einschließlich Endung. Feste Textteile werden ohne Beachtung der Groß-/Kleinschreibung verglichen. Das Muster braucht mindestens einen Platzhalter zur Personenzuordnung. Bei mehreren Personenfeldern müssen alle zur selben Person passen und genau einen Treffer in Personen ergeben.

Platzhalter Bedeutung
{PNR} oder {PersonID} Interne numerische PersonID in PEP4. Führende Nullen ändern den Zahlenwert nicht. Beide Schreibweisen bezeichnen dasselbe Feld.
{Personalnummer1}, {Personalnummer2}, {Personalnummer3} Das jeweilige Personalnummernfeld im Personenstamm. Der Wert wird als Text verglichen und führende Nullen bleiben erhalten. Akzeptiert werden 1 bis 64 Zeichen aus Buchstaben, Ziffern, Bindestrich und Unterstrich.
{SAPPersonalbereich} Genau vier Ziffern. Aktiviert den Abgleich mit dem SAP-Personalbereich der ITorga-Filiale am letzten Kalendertag des Abrechnungsmonats. Es muss genau eine gültige ITorga-Zeile mit einer zugeordneten Filiale und einem übereinstimmenden SAP-Personalbereich vorliegen.
{Jahr} Vier Ziffern, zwischen 1000 und 9999.
{Monat} Zwei Ziffern, von 01 bis 12.
? Genau ein beliebiges Zeichen.
* Beliebig viele Zeichen, auch null.

Platzhalternamen ohne Leerzeichen schreiben und jeden Platzhalter höchstens einmal verwenden. Feste Trennzeichen erleichtern die eindeutige Zuordnung. Mehrdeutige Treffer werden als Fehler protokolliert. Beispiel mit Zeitraum im Dateinamen: {Jahr}_{Monat}_{Personalnummer1}.pdf.

SAP-HR-Dateien ohne Monat und Jahr

Beispiel für den Aufbau Personalbereich (4 Ziffern) _ Geschäftsbereich (4 Stellen) _ SAP-Personalnummer (8 Stellen), mit fiktiver Datei.

0500_0000_01234567.pdf
{SAPPersonalbereich}_????_{Personalnummer1}.pdf
  1. In PEP4 muss 01234567 im Feld Personalnummer 1 stehen. Liegt die SAP-Nummer in Feld 2 oder 3, im Muster {Personalnummer2} oder {Personalnummer3} verwenden. {PersonID} ist möglich, wenn die Nummer tatsächlich der internen PEP4-PersonID entspricht.
  2. 0500 muss in den Filialstammdaten der ITorga-Filiale hinterlegt sein, die für die Person am Monatsletzten gültig ist. Bei einem Filialwechsel zählt der zu importierende Abrechnungsmonat.
  3. Der Geschäftsbereich 0000 wird durch ???? überlesen. Dieses Muster verlangt dort vier Zeichen. Die Prüfung auf vier Ziffern gilt für den SAP-Personalbereich. Die acht Stellen der SAP-Personalnummer sind eine Vorgabe des Lieferformats.
  4. Beim Start MONAT und JAHR für den gesamten Ordner eingeben, etwa 10 und 2026. Für mehrere Abrechnungsmonate die Dateien nach Monat trennen und je Ordner einen eigenen Lauf starten.

Ergebnis und Protokoll

  1. Die Datei erscheint als Dokumentart Lohnnachweis (404) mit der Beschreibung Lohnnachweis MM/JJJJ. PDF, Zuordnung zur Person und gegebenenfalls Ordnerzuordnung werden pro Datei in einer SQL-Transaktion gespeichert. Die Quelldateien bleiben im Eingangsordner.
  2. Ein aktiver Nachweis derselben Person mit derselben Dokumentart, demselben Zeitraum und bytegleichem PDF-Inhalt wird als bereits vorhanden gezählt. Ein geändertes PDF kann als weiterer Nachweis abgelegt werden.
  3. PDFs, die nicht zum Muster passen, werden als nicht passend protokolliert. Bei uneindeutiger Person, fehlendem Abrechnungszeitraum, fehlendem PDF-Kopf oder fehlendem beziehungsweise abweichendem SAP-Personalbereich meldet PEP4 einen Dateifehler und verarbeitet die übrigen Dateien weiter. Bereits erfolgreich gespeicherte Nachweise bleiben abgelegt. Das Abschlussprotokoll zählt importierte, bereits vorhandene und nicht passende PDFs.
  4. Das Protokoll enthält Dateinamen und bei erfolgreicher Zuordnung interne PersonIDs. Entsprechend vertraulich behandeln.

Quellenstand

Statisch abgeglichen am 17.11.2026 mit pep4desktop master, Commit dbbb7673e14440895979b3b908a51e0823d08f3b. Maßgeblich sind cProgramme.vb, cSchnittPersonalakteLohnnachweise.vb, cLohnnachweisDateiname.vb, cEinstellungenZw.vb und update_0918.sql. Für diese Dokumentation wurde kein Importlauf ausgeführt.

Zur Schnittstellenübersicht