Grundlegende Informationen zu diesem Paket finden Sie unter Erste Schritte LOHN.
| Firma | Eingabe der Firma, für die der Import durchgeführt werden soll. Bleibt dieses Feld leer, werden alle in der Datei enthaltenen Datensätze importiert. Wird eine Firma ausgewählt, werden nur die Datensätze mit der entsprechenden Firmennummer importiert. | ||
| Schnittstelle | Auswahl der Importschnittstelle, die den benötigten Satzaufbau (wird in der Importvorschau angezeigt) enthält. Hinweis
![]() Über das blaue Fragezeichen (zu finden in der mittleren Buttonbar) öffnet sich eine Exceldatei, die alle verfügbaren Importfelder (inklusive der Feldnamen und der entsprechenden Ausprägungen (wo eindeutig)) des Programms enthält. | ||
Importdatei/Importverzeichnis | Auswahl der Importdatei bzw. des Importverzeichnisses, in dem die Datei(en) liegt (liegen). Folgende Eingabevarianten sind möglich:
Wichtig: Die Datei muss nicht zwingend im CSV-Format gespeichert werden. Ab der Version 16.46. ist auch der Import von .XLS-, .XLSX bzw. .XML-Dateien möglich. ![]() Der Import von XLS- und XLSX-Dateien kann durch die Verwendung eckiger Klammern, eines Rufzeichens und des Namens des Tabellenblatts auf ein bestimmtes Tabellenblatt innerhalb der Importdatei eingeschränkt werden. Beispiel: C:\Temp\Import.xlsx[!Tabelle2] Wichtig: Das Verzeichnis bzw. der Pfad darf kein Komma (keinen Beistrich) beinhalten, da das Komma als Trennzeichen zur Auswahl mehrerer Dateien bzw. Verzeichnisse genutzt wird. Werden mehrere Dateien oder wird ein Ordner (ein Verzeichnis) ausgewählt, erscheint im Bereich "Vorschau" eine Combobox, mit der eine beliebige Datei selektiert und in der Vorschau angezeigt werden kann. Importiert werden alle Dateien, die den Einstellungen in diesem Feld entsprechen. Das heißt, die angesprochene Combobox ist nicht als Auswahl für den Import, sondern als Auswahl für die Anzeige in der Vorschau zu verstehen. Alle Dateien werden nach dem Dateinamen aufsteigend sortiert importiert. Die Reihenfolge in der Combobox entspricht der Reihenfolge, wie die Dateien importiert werden. Falls sichergestellt werden muss, dass die korrekte Reihenfolge, in der die Dateien importiert werden, eingehalten wird, muss die Dateibezeichnung mit einem Timestamp mit folgendem Aufbau beginnen: <YYYYMMDDHHmmss> Hinweis
|
Feldauswahl können auch zusätzliche Felder hinzugefügt bzw. entfernt werden. Soll die bestehende Schnittstelle nicht verändert werden, muss eine neue Schnittstelle angelegt werden. Doku-Zeile definieren | Diese Funktion ist nur dann aktiv, wenn die Schnittstelle über eine Doku-Zeile verfügt. Mit dieser Funktion kann die Doku-Zeile für die markierte Spalte hinterlegt werden. |
fixe Spaltenlänge | Diese Funktion ist nur dann aktiv, wenn die Schnittstelle über fixe Spaltenlängen verfügt. Mit dieser Funktion kann die Spaltenlänge für die markierte Spalte hinterlegt werden. |
Makro nach Lesen | Über ein Makro kann eine Filterung auf die zu importierenden Daten vorgenommen werden. Das Makro wird direkt nach dem Lesen der Importdatei ausgeführt. Ist ein Makro hinterlegt, dann ändert sich das Icon in . |
Makro vor Schreiben | Über ein Makro kann eine Filterung auf die zu importierenden Daten vorgenommen werden. Das Makro wird direkt vor dem Schreiben der Importdatei aufgeführt. Ist ein Makro hinterlegt, dann ändert sich das Icon in . |
deaktivieren bzw. auf das grüne Häkchen
aktivieren Sie einen Datensatz und wechseln auf den nächsten. Dabei werden deaktivierte Datensätze kursiv, durchgestrichen und grau dargestellt (siehe Beispiel). ![]() | Die Information der gesperrten Datensätze bleibt jedoch nur temporär erhalten – d. h., solange das Programm geöffnet ist. Wird das Programm geschlossen und erneut geöffnet, sind wieder alle Datensätze aktiv gestellt. |
![]() | Diese Abbildung zeigt drei für den Import ausgeschlossene Datensätze. ![]() |
Soll die Importdatei nach erfolgtem Import umbenannt werden, muss dieser Parameter auf "Ja" gestellt werden. In diesem Fall werden Datensätze, die nicht importiert werden konnten, in eine Datei eigene Err-Datei zusammengefasst. Heißt die Importdatei beispielsweise C:\Test.csv, dann heißt die Err-Datei C:\~Test_err.csv. Die Tilde am Anfang des Dateinamens verhindert, dass die "fehlerhaften" Datensätze immer und immer wieder importiert werden. Die Err-Datei ist zu korrigieren und umzubenennen. Der Dateiname darf keine Tilde enthalten. Danach kann der Import erneut gestartet werden. 0 - Nein 1 - Ja |
![]() | C:\Test.csv wird zu C:\~Test_err.csv Existiert diese bereits, dann wird sie zu C:\~Test_err1.csv |
![]() | C:\Test.xlsx wird zu C:\~Test_err.csv |
Feldname | Feldbezeichnung | Datentyp | Hinweis |
DVH_DIENSTV_FIRMENNR | DV-Firma | N (10) | Firma, bei der das Dienstverhältnis angelegt ist. |
MIT_MITARBNR | Mitarb-Nr | N (10) | Mitarbeiternummer Führende Nullen werden ignoriert. |
DVH_DIENSTVLFDNR | DV-Nr | N (4) | Wenn mehrere Dienstverhältnisse vorhanden sind |
HRS_DVNR_STICHTAG | DVNrStichtag | Datum | Eingabeformat: TT.MM.JJJJ Wird keine DV-Nummer angegeben, so wird über dieses Feld das an diesem Tag gültige aktive Dienstverhältnis ermittelt. |
ABM_ABWESENHEITART | Art | N (2) | 1 - Urlaub 2 - Krankheit 3 - Arbeitsunfall 4 - Arzt 5 - Pflegeurlaub 6 - Gutstd./Div. NLZ: Hier muss die Gutstd./Div. NLZ im Feld "ABM_DIVNLZID" angegeben werden. 9 - Schlechtwetter 10 - Planurlaub 14 - Freizeitunfall 15 - pers. Feiertag 16 - pers. Feiertag gearbeitet Führende Nullen werden ignoriert. Hinweis: Die Abwesenheitsarten für den Import entsprechen nicht den Nichtleistungszeitarten in der NLZ-Verwaltung! |
ABM_DIVNLZID | Gutstd./Div. NLZ | N (19) | |
ABM_PFLG_ALTERKIND_KZ | Alter Kind | N (1) | Relevant bei Pflegeurlaub 1 - bis 11 2 - ab 12 |
ABM_VERARBKZ_IMPORT | Verarbeitungs-KZ | A (0) | 0 - Neu anlegen 1 - Löschen 2 - Neu anlegen/ändern 3 - Neu anlegen + zusammenhängen 4 - Reständerung 5 - Reständerung wg. Übernahme 6 - Reständerung wg. Einheitsänderung Details siehe Verarbeitungskennzeichen Führende Nullen werden ignoriert. |
ABM_ABWESENDVON | Von | Datum | Eingabeformat: siehe Datumsfelder |
ABM_ABWESENDBIS | Bis | Datum | Eingabeformat: siehe Datumsfelder Die NLZ-Arten "Krank" bzw. "Unfall" können auch ohne NLZ-Bis-Datum angeliefert werden und werden in diesen Fällen als eine noch offene laufende NLZ angesehen. |
ABM_WERT1_VERWALTUNG | Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Im Fall von Urlaub, Pflegeurlaub, Krankheit, Arbeitsunfall und Freizeitunfall werden die Werte automatisch aus dem hinterlegten Wochenmodell ermittelt. Ein Import ist daher nur notwendig, wenn der gewünschte Wert vom ermittelten Wert abweicht (z. B. in der Urlaubsverwaltung soll nur ein halber Tag (0,5) abgezogen werden). In diesen Fällen müssen die einzelnen NLZ-Tage jeweils in eigenen Datenzeilen angeliefert werden (tageweiser Import). Bei Gutstunden oder Diversen NLZ müssen Werte angeliefert werden, da bei diesen NLZ-Arten in der Regel ein stundenweiser Verbrauch vorliegt. Bei diesen NLZ-Arten werden keine Werte aus dem Tagesmodell ermittelt. |
ABM_WERT1_BEZAHLT | Bezahlt | N (24,9) | Anzahl der Tage oder Stunden, die auf der hinterlegten Lohnart in die Bruttoerfassung übergeben werden sollen. Hinweis: Im Fall von Urlaub, Pflegeurlaub, Krankheit, Arbeitsunfall und Freizeitunfall werden die Werte automatisch aus dem hinterlegten Wochenmodell ermittelt. Ein Import ist daher nur notwendig, wenn der gewünschte Wert vom ermittelten Wert abweicht (z. B. in der Urlaubsverwaltung soll nur ein halber Tag (0,5) abgezogen werden). In diesen Fällen müssen die einzelnen NLZ-Tage jeweils in eigenen Datenzeilen angeliefert werden (tageweiser Import). Bei Gutstunden oder Diversen NLZ müssen Werte angeliefert werden, da bei diesen NLZ-Arten in der Regel ein stundenweiser Verbrauch vorliegt. Bei diesen NLZ-Arten werden keine Werte aus dem Tagesmodell ermittelt. Achtung: Beim Nichtleistungszeitenimport von Urlauben für BUAK-Dienstnehmer bleibt dieses Feld unberücksichtigt. Es werden stets die Stunden aus dem hinterlegten Wochenmodell herangezogen. |
ABM_WERT2_VERWALTUNG | Wert 2 Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Dieses und die nachfolgenden Felder sind nur bei den NLZ-Arten "2 - Krankheit", "3 - Arbeitsunfall" und "14 - Freizeitunfall" relevant. |
ABM_WERT3_VERWALTUNG | Wert 3 Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Dieses und die nachfolgenden Felder sind nur bei den NLZ-Arten "2 - Krankheit", "3 - Arbeitsunfall" und "14 - Freizeitunfall" relevant. |
ABM_WERT4_VERWALTUNG | Wert 4 Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Dieses und die nachfolgenden Felder sind nur bei den NLZ-Arten "2 - Krankheit", "3 - Arbeitsunfall" und "14 - Freizeitunfall" relevant. |
ABM_WERT_FR_VERWALTUNG | Wert freiwillig Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Dieses und die nachfolgenden Felder sind nur bei den NLZ-Arten "2 - Krankheit", "3 - Arbeitsunfall" und "14 - Freizeitunfall" relevant. |
ABM_WERT_OG_VERWALTUNG | Wert ohne Entgelt Verwaltung | N (24,9) | Anzahl der Tage oder Stunden, die in der Verwaltung abgezogen oder hinzugefügt werden sollen. Hinweis: Dieses und die nachfolgenden Felder sind nur bei den NLZ-Arten "2 - Krankheit", "3 - Arbeitsunfall" und "14 - Freizeitunfall" relevant. |
ABM_ANMERKUNG | Anmerkung | A (255) | Anmerkung zur Nichtleistungszeit. |
ABM_NLZLOAGRUPPE | NLZ-Lohnartengruppe | N (2) | 1 - Gruppe 1 2 - Gruppe 2 |
![]() | Bei diesem Importprogramm muss nicht zwingend die DV-Nr. bzw. das Dienstverhältnis über das Feld "DVNrStichtag" angegeben werden. Gerade bei Importen aus Fremdsystemen ist die Dienstverhältnisnummer nicht bekannt. Aus diesem Grund gilt folgende Logik:
Sofern die DV-Zuordnung beim Import nicht zweifelsfrei ist, erfolgt ein Eintrag ins Logfile. Durch diese Programmlogik kann der Import in den meisten Fällen auf das korrekte Dienstverhältnis durchgeführt werden. In der Praxis kommen jedoch auch Ausnahmen vor. Beachten Sie deshalb das Logfile des Imports und kontrollieren Sie die importieren Daten im Rahmen der Bearbeitung in der Bruttoerfassung. |

![]() |
Bestehende Krankheit: 01.04. bis 10.04
Importierte Krankheit: 03.04. bis 10.04
Die bestehende Krankheit vom 01.04. bis 10.04. wird gelöscht und die neue Krankheit vom 03.04. bis zum 10.04. wird in die Krankenverwaltung geschrieben. |
![]() |
Bestehende Urlaube: 01.04. bis 10.04. und 14.04. bis 20.04.
Importierte Urlaube: 09.04. bis 17.04.
Die bestehenden Urlaube werden gelöscht, da sich der neue Urlaub mit den beiden bestehenden überschneidet. Daraufhin wird der neue Urlaub in die Urlaubskartei geschrieben. |
![]() | Beim Zusammenhängen sollte Folgendes beachtet werden:
|
![]() | 5-Tage-Woche (Mo–Fr) bestehende Krankheit: 03.05.–07.05. (Mo–Fr) importierte Krankheit: 10.05.–14.05. (Mo–Fr) Zwischen den beiden Krankheiten liegen nicht mehr als 3 Kalendertage. Außerdem sind die Tage, die dazwischenliegen, keine Arbeitstage (SA und SO). Darum können die Krankheiten zusammengehängt werden. Die alte Krankheit (03.05. - 07.05) wird gelöscht und es wird eine neue Krankheit vom 03.05. - 14.05. generiert. |
![]() | 5-Tage-Woche (Mo–Fr) bestehende Krankheit: 03.05.–03.05. (Mo) importierte Krankheit: 05.05.–07.05. (Mi–Fr) Die Krankheiten werden nicht zusammengehängt, weil der Tag, der zwischen beiden Sätzen liegt, ein Arbeitstag ist. Darum wird davon ausgegangen, dass es sich um zwei verschiedene Krankheiten handelt. |
![]() |
Aktueller Gesamtrest in Urlaubsverwaltung: 35 Tage
Angeliefert wird das Kennzeichen 4 mit 10 Tagen
Die Reständerung von 25 Tagen wird automatisch errechnet und in die Urlaubsverwaltung geschrieben. Der aktuelle Gesamtrest beträgt nun 10 Tage.
|
![]() | Zu beachten ist, dass diese Differenz ausschließlich zum angelieferten Stichtag eingetragen wird und somit als Verbrauch im jeweiligen Urlaubsjahr zählt. Dies hat zur Konsequenz, dass der aliquote Urlaub in Urlaubsjahr des Imports ggf. falsch ausgewiesen wird, wenn die Reständerung einen alten Urlaub beinhaltet. Aus diesem Grund können Sie im Zuge einer Reständerung von Urlauben auch den alten Urlaub vom alten Urlaubsjahr im Feld Wert 2 Verwaltung importieren. |
![]() | Der Urlaubsbeginn ist der 1.6. eines jeden Jahres. Per 01.01.20xx soll eine Reständerung vorgenommen werden. Aus dem alten Urlaubsjahr hat der Mitarbeiter 60 Tage Resturlaub. Aktuell per 01.01.20xx hat er 80 Tage Resturlaub. Der Mitarbeiter hat einen Urlaubsanspruch von 25 bereits in der NLZ-Verwaltung erfasst. ![]() Im Feld "Verarbeitungs-KZ" ist das Kennzeichen 4 für Reständerung anzuliefern. In den Feldern "Von" und "Bis" wird der Stichtag der Reständerung in diesem Beispiel der 01.01.20xx übergeben. Das Feld "Verwaltung" beinhaltet den Resturlaub, den der Mitarbeiter zum jeweiligen Stichtag hat, im Beispiel 80. Im Feld "Wert 2 Verwaltung" wird der alte Urlaub vom letzten Urlaubsjahr angeliefert, in diesem Fall 60. Durch den Import wird eine Reständerung von +35 per 31.5. des Vorjahres angelegt. Das ist der letzte Tag des alten Urlaubsjahres. Eine Reständerung von +35 ergibt sich deshalb, weil vor der Reständerung ein Resturlaub von 25 eingetragen war. Damit man auf die gewünschten 60 Tage für das alte Urlaubsjahr kommt, müssen 35 addiert werden. Danach erfolgt eine zweite Reständerungszeile zum importierten Stichtag. Das ist der 01.01.20xx. An diesem Stichtag steht fest, dass der Mitarbeiter 80 Tage Resturlaub hat. Also müssen zu den bisherigen 60 Tagen noch einmal 20 addiert werden. Durch den gesonderten Import des Urlaubsrestes vom alten Urlaubsjahr (in diesem Fall 60) wird der aliquote Urlaub ab dem Datum der Stichtag der Reständerung korrekt ermittelt. In diesem Beispiel hat der Mitarbeiter 60 Tage Resturlaub aus dem alten Urlaubsjahr. Er hat pro Urlaubjahr einen Anspruch von 25 Tagen, aber per 01.01.20xx einen Resturlaub von 80 Tagen. Das bedeutet, dass der Mitarbeiter im aktuellen Urlaubsjahr bis zum 01.01.20xx bereits 5 Urlaubstage verbraucht haben muss. Insofern werden in der Zeile "+ alter Urlaub - Verbrauch lfd. Jahr" 55 Tage ausgewiesen. |
![]() | Beim Import von Gutstunden oder Diversen NLZ muss im Feld "Gutstd./Div.NLZ" immer die Nummer des Gutstundentopfes bzw. der Diversen NLZ angegeben sein. Diese Nummer kann im Paket LOHN → Stammdaten → Diverse Stammdaten → Gutstunden/Diverse NLZ abgelesen werden. |
![]() | Eine Reständerung wegen Übernahme ist insbesondere bei einem Wechsel im Konzern oder einer Übernahme von Dienstnehmern mit allen Rechten und Pflichten zu verwenden. |
![]() | Der Wechsel der Einheit im Feld Urlaub-Einheit ist manuell im Dienstnehmerstamm und den historischen Daten durchzuführen. Kontrollieren Sie außerdem den DN-Vorschlag im Lohnfirmenstamm, sodass neu angelegte Mitarbeiter gleich mit der gewünschten Urlaubseinheit angelegt wird. |
![]() | Nichtleistungszeiten, die tageweise eingegeben werden, müssen immer in der chronologisch richtigen Reihenfolge angeliefert werden! Der tageweisem Import muss verwendet werden, wenn beispielsweise nur ein halber Urlaubstag abgezogen werden soll. |
![]() | Import von unterschiedlichen Nichtleistungszeiten: |
![]() | Eine passwortgeschützte Datei kann nicht importiert werden und die Vorschau wird nicht angezeigt, weil es sich um geschützte Daten handelt. Die Meldung "Fehler beim Öffnen der Datei "..." Invalid password to open or create a file" wird angezeigt. ![]() |
An dieser Stelle kann das Importverzeichnis bzw. die Importdatei bereits fix hinterlegt werden. Folgende Eingabevarianten sind möglich:
Wichtig: Die Datei muss nicht zwingend im CSV-Format gespeichert werden. Ab der Version 16.46. ist auch der Import von XLS- bzw. XLSX-Dateien möglich. Der Import von XLS- und XLSX-Dateien kann durch die Verwendung eckiger Klammern, eines Rufzeichens und des Namens des Tabellenblatts auf ein bestimmtes Tabellenblatt innerhalb der Importdatei eingeschränkt werden. Beispiel: C:\Temp\Import.xlsx[!Tabelle2] Wichtig: Das Verzeichnis bzw. der Pfad darf kein Komma (keinen Beistrich) beinhalten, da das Komma als Trennzeichen zur Auswahl mehrerer Dateien bzw. Verzeichnisse genutzt wird. | |
Über diesen Parameter kann die benötigte Import-Schnittstelle fix hinterlegt werden. | |
Soll die Importdatei nach erfolgtem Import umbenannt werden, muss dieser Parameter auf "Ja" gestellt werden. In diesem Fall werden Datensätze, die nicht importiert werden konnten, in eine Datei eigene Err-Datei zusammengefasst. Heißt die Importdatei beispielsweise C:\Test.csv, dann heißt die Err-Datei C:\~Test_err.csv. Die Tilde am Anfang des Dateinamens verhindert, dass die "fehlerhaften" Datensätze immer und immer wieder importiert werden. Die Err-Datei ist zu korrigieren und umzubenennen. Der Dateiname darf keine Tilde enthalten. Danach kann der Import erneut gestartet werden. 0 - Nein 1 - Ja | |
Hier wird festgelegt, ob die zu importierenden Nichtleistungszeiten mit bereits existierenden Nichtleistungszeiten gleicher Art entsprechend dem Wochenmodell zusammengehängt werden sollen oder nicht. Folgende Ausprägungen stehen zur Verfügung: 1 - Vom Wochenmodell abhängig 2 - nur angrenzende NLZ Beispiel: Eine Krankheit ist vom 1. bis 10. eines Monats erfasst. Eine weitere Krankheit soll vom 13. bis 15. desselben Monats importiert werden. 1 - Von Wochenmodell abhängig: Diese Einstellung prüft, ob eine Sollarbeitszeit entsprechend dem Wochenmodell (bzw. Tagesmodell) für die dazwischenliegenden Tage (11 - 12) vorliegt. Ist dies der Fall werden die Nichtleistungszeiten vom 1. bis 10. und 13. bis 15. nicht zusammengehängt, andernfalls schon. 2 - nur angrenzende NLZ: Diese Einstellung hängt nur bei direkt aneinander angrenzende Nichtleistungszeiten gleichen Typs immer zusammen. Die Krankheiten vom 1. bis 10. und 13. bis 15. werden nicht zusammengehängt. | |
Mit diesem Parameter wird geregelt, ob beim Import von Zeiträumen die Werte für "Verwaltung" und "Bezahlt" ermittelt oder importiert werden. Wichtig: Dieser Parameter hat für den Import von Nichtleistungszeiten der NLZ-Arten Krank, Arbeitsunfall und Freizeitunfall keine Bedeutung. Bei einem tageweisen Import, das heißt jeder Tag der Nichtleistungszeit wird in einem eigenen Datensatz angeliefert, kann die Einstellung dieses Parameters immer übersteuert werden. Folgende Ausprägungen stehen zur Verfügung: 0 - ignorieren: Mit dieser Einstellung ist das Programmverhalten wie bisher. Beim Import von Zeiträumen werden die Werte für "Verwaltung" und "Bezahlt" anhand des beim Dienstnehmer hinterlegten Wochenmodells ermittelt. Eventuell in der Importdatei angelieferte Werte werden ignoriert. 1 - berücksichtigen: Hier werden die beim Import angelieferten Werte bei Zeiträumen berücksichtigt, d. h. für Verwaltung und Bezahlt herangezogen. Zuerst wird die NLZ wie bisher importiert und die einzelnen Tage werden aufgrund des Wochenmodells bewertet. Danach wird festgestellt, ob es zwischen den ermittelten und den angelieferten Werten Differenzen gibt. Die Differenz wird auf den ersten Tag der NLZ addiert, sodass die Summe der Verwaltung/Bezahlt-Werte den importieren Werten entspricht. Diese Ausprägung greift bei allen Nichtleistungszeit-Arten außer Krank, Arbeitsunfall und Freizeitunfall. Sollen auch hier die über den Import in den Felder "Verwaltung" und "Bezahlt" angelieferten Tage und Stunden berücksichtigt werden, dann muss ein tageweiser Import erfolgen. |