Grundlegende Informationen zum Paket finden Sie unter Erste Schritte LOHN.

Lohnverrechnung → Weitere Funktionen → Import und Export → Dienstnehmer → Angehörige importieren

Mit diesem Programm können die Angehörigen eines Dienstnehmers importiert werden.

Fensterbereiche

Dieses Fenster verfügt über ein flexibles Layout und kann sowohl fixe als auch optionale Bereiche enthalten. In manchen Fenstern sind im Standard nicht alle möglichen Bereiche eingeblendet. Hier finden Sie Details zu Fenstern mit flexiblem Layout.

Einstiegsfelder

Bevor der Import gestartet werden kann, müssen folgende Eingaben getätigt werden:

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

Der Satzaufbau der Importdatei muss mit dem Aufbau der ausgewählten Schnittstelle übereinstimmen. Ist das nicht der Fall, muss entweder eine neue Schnittstelle definiert oder die bestehende (wenn nicht anderweitig benötigt) über die

Feldauswahl angepasst werden.

Ü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:

Dateiname (z. B. C:\Temp\Import.csv)
Verzeichnis (z. B. C:\Temp)
Verzeichnis + Dateiendung (z. B. C:\Temp\*.csv → alle CSV-Dateien aus dem Temp-Verzeichnis werden importiert)
Verzeichnis + Dateimaske (z. B. C:\Temp\Imp*.csv)
Mehrere Dateien bzw. Verzeichnisse durch Komma (Beistriche) getrennt (z. B. C:\Import.csv, C:\Temp, C:\Daten\*.csv)

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

Die Importdatei bzw. das Importverzeichnis kann auch fix in den LOHN Parametern unter Punkt "Import" bzw. im Menü Extras → allgemeine bzw. firmenbezogene Einstellungen hinterlegt werden.

Seitenanfang

Importvorschau

In der Importvorschau sehen Sie den Satzaufbau der ausgewählten Importschnittstelle und den Inhalt der zu importierenden Datei.

Über die

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.

Wie bereits erwähnt, ist auch der Inhalt der Datei sichtbar, sobald eine Importdatei ausgewählt wird.

Funktionen zur Schnittstellendefinition

Folgende Funktionen stehen in der Importvorschau zur Verfügung:


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 .

Datensätze vom Import ausschließen

Es gibt in allen HRS-CSV-Importprogrammen die Möglichkeit, bestimmte Datensätze vom Programm auszuschließen.

Durch einen Mausklick auf das rote x

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).

Hinweis

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.

Beispiel

Diese Abbildung zeigt die Darstellung deaktivierter Datensätze:

Mögliche Importfelder

Feldname	Feldbezeichnung	Datentyp	Hinweis
PER_FIRMENNR	Firma	N* (10)
MIT_MITARBNR	Mitarb-Nr	N (10)	Mitarbeiternummer Führende Nullen werden ignoriert.
GAZ_ANGNR_ANZEIGE	AngNr	N (10)	Angehörigennummer, laufende Nummerierung
GAZ_VERWANDTSCHAFTSTYP	Angehörigkeit	N (2)	1 - Ehegatte/Partner 2 - Kind 3 - Elternteil
PER_NAME	Nachname	A* (50)
PER_VORNAME	Vorname	A (50)
PER_SVNR	SVNR	A (20)
PER_GEBURTSDATUM	Geburtsdatum	Datum	Eingabeformat: TT.MM.JJJJ
GAZ_HATUNTERHALT	Unterhaltsberechtigt	N (1)	0 - Nein 1 - Ja
PER_HATSERVICEENTGELT	Service-Entgelt	N (1)	0 - Nein 1 - Ja
PER_GESCHLECHT	Geschlecht	N (1)	0 - männlich 1 - weiblich 2 - keine Angabe
PER_TITEL	Titel	A (50)
PER_TITEL_HINTEN	Titel hinten	A (30)
PER_KURZNAME	Kurzname	A (30)
PER_GEBURTSNAME	Geburtsname	A (50)
PER_ZUSATZNAME	Zusatzname	A (50)
PER_MATCHCODE	Matchcode	A (50)
ADR_STRASSE	Straße	A (100)
ADR_PLZ	Plz	A (10)	Postleitzahl
ADR_ORTSNAME	Ort	A (50)
PER_EMAILADRESSE	E-Mail	A (100)
PER_TELEFONNUMMER	Telefonnummer	A (50)
PER_TELEFAX	Telefax	A (50)
GAZ_UNTERHALTAB	Unterhalt ab	Datum	Eingabeformat: TT.MM.JJJJ
GAZ_UNTERHALTBIS	Unterhalt bis	Datum	Eingabeformat: TT.MM.JJJJ
GAZ_FAMBEIHILFEVON	Familienbeihilfe ab	Datum	Eingabeformat: TT.MM.JJJJ
GAZ_FAMBEIHILFEBIS	Familienbeihilfe bis	Datum	Eingabeformat: TT.MM.JJJJ
GAE_FABO_LANDNR	FABO+ Land-Nr.	N (4)	Landnummer siehe Paket CRM → Stammdaten → Diverse Stammdaten → Länder Für den FABO+ sollten die folgenden Felder beim Angehörigenimport jeweils in Kombination importiert werden. GAE_FABO_LANDNR GAE_FABOPLUS GAE_FABOPLUS_HOEHE GAE_BEZIEHUNG Achtung: Nach dem Import der Felder "FABO+" bzw. "AVAE" über das Programm "Angehörige importieren" ist über das Programm "Dienstnehmer" der jeweilige Dienstnehmer zu bearbeiten und am Reiter "Finanzamt" im Feld "Familienbonus Plus" bzw. "AVAE Kinder" mit F8 einzusteigen. Dadurch werden die Beträge für den FABO+ bzw. den AVAE aktualisiert.
GAE_FABOPLUS	FABO+	N (1)	0 - Nein 1 - Ja, bis 18 Jahre 2 - Ja Für den FABO+ sollten die folgenden Felder beim Angehörigenimport jeweils in Kombination importiert werden. GAE_FABO_LANDNR GAE_FABOPLUS GAE_FABOPLUS_HOEHE GAE_BEZIEHUNG Achtung: Nach dem Import der Felder "FABO+" bzw. "AVAE" über das Programm "Angehörige importieren" ist über das Programm "Dienstnehmer" der jeweilige Dienstnehmer zu bearbeiten und am Reiter "Finanzamt" im Feld "Familienbonus Plus" bzw. "AVAE Kinder" mit F8 einzusteigen. Dadurch werden die Beträge für den FABO+ bzw. den AVAE aktualisiert.
GAE_FABOPLUS_HOEHE	FABO+ Höhe	N (1)	0 - Nein 1 - Voll 2 - Halb Für den FABO+ sollten die folgenden Felder beim Angehörigenimport jeweils in Kombination importiert werden. GAE_FABO_LANDNR GAE_FABOPLUS GAE_FABOPLUS_HOEHE GAE_BEZIEHUNG Achtung: Nach dem Import der Felder "FABO+" bzw. "AVAE" über das Programm "Angehörige importieren" ist über das Programm "Dienstnehmer" der jeweilige Dienstnehmer zu bearbeiten und am Reiter "Finanzamt" im Feld "Familienbonus Plus" bzw. "AVAE Kinder" mit F8 einzusteigen. Dadurch werden die Beträge für den FABO+ bzw. den AVAE aktualisiert.
GAE_BEZIEHUNG	Beziehung zum Kind	N (1)	0 - Familienbeihilfen-Bezieher 1 - Partner des Familienbeihilfen-Beziehers 2 - Unterhaltszahler Für den FABO+ sollten die folgenden Felder beim Angehörigenimport jeweils in Kombination importiert werden. GAE_FABO_LANDNR GAE_FABOPLUS GAE_FABOPLUS_HOEHE GAE_BEZIEHUNG Achtung: Nach dem Import der Felder "FABO+" bzw. "AVAE" über das Programm "Angehörige importieren" ist über das Programm "Dienstnehmer" der jeweilige Dienstnehmer zu bearbeiten und am Reiter "Finanzamt" im Feld "Familienbonus Plus" bzw. "AVAE Kinder" mit F8 einzusteigen. Dadurch werden die Beträge für den FABO+ bzw. den AVAE aktualisiert.
GAE_AVAE	AVAE	N (1)	0 - Nein 1 - Ja Ab der Version 27.45 gilt: Wenn Angehörige importiert werden und das Feld "AVAE" auf "Ja" gesetzt wird, dann werden die AVAE im Programm "Dienstnehmer" am Reiter "Finanzamt" am Feld AVAE Kinder nur dann ermittelt, wenn das Feld Alleinverdiener im Programm "Dienstnehmer" am Reiter "Finanzamt" auf die Ausprägungen "Alleinverdiener" oder "Alleinerzieher" gesetzt ist. Falls das Feld Alleinverdiener nicht auf eine der genannten Ausprägungen gesetzt ist, aber ein entsprechender Angehöriger mit AVAE-Kennzeichnung in diesem Importfeld importiert wird, erfolgt ein Hinweis im Logfile. Achtung: Nach dem Import der Felder "FABO+" bzw. "AVAE" über das Programm "Angehörige importieren" ist über das Programm "Dienstnehmer" der jeweilige Dienstnehmer zu bearbeiten und am Reiter "Finanzamt" im Feld "Familienbonus Plus" bzw. "AVAE Kinder" mit F8 einzusteigen. Dadurch werden die Beträge für den FABO+ bzw. den AVAE aktualisiert.
PER_BERUFSBEZ	Beruf	A (50)
PER_BANKKONTONR	Bankkontonummer	A (80)
PER_BANKLEITZAHL	Bankleitzahl	A (80)
PER_SWIFTCODE	SWIFT/BIC	A (30)
PER_IBAN	IBAN	A (50)

* N = Numerisch; A = Alphanumerisch

Hinweis

Das Importprogramm ist natürlich auch stapelfähig und kann in einen oder mehrere Lohnstapel aufgenommen werden (siehe Lohnstapelverwaltung). Der Import funktioniert jedoch nur, wenn im Stapelprogramm eine bestimmte Firma ausgewählt und die jeweilige Importdatei in den Lohnparametern hinterlegt worden ist.

Seitenanfang

Hinweis

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.

Folgende Funktionen stehen über das Fenstermenü zur Verfügung:

Funktionen
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.
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.
Logdatei ansehen	Die Logdatei des Importprogramms kann auch nachträglich angesehen und kontrolliert werden.

Extras
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.
Datensatz für Import sperren	Mit dieser Funktion können Datensätze deaktiviert werden. Die Zeile wird dann kursiv, durchgestrichen und grau dargestellt.
Datensatz für Import aktivieren	Mit dieser Funktion können Datensätze wieder aktiviert werden.

Ansicht
Platzhalter: Werte in Spalten anzeigen	Bei Platzhalter-Spalten werden die Werte der Importdatei in der Importvorschau angezeigt.
Vorschau: Alle Importdatensätze anzeigen	Zeigt alle Importdatensätze in der Importvorschau an. Bei sehr umfangreichen Importdateien bedeutet dies Performance-Einbußen.
Vorschau: Doku-Zeile in Vorschau anzeigen	Bei Verwendung einer Doku-Zeile wird diese in der Importvorschau angezeigt.
Vorschau: Kennzeichen als Text anzeigen	Zeigt den "sprechenden" Text bei Kennzeichen an und nicht den Wert, welcher importiert wird.
Vorschau: Makro in Vorschau berücksichtigen	Makros werden zur Ermittlung der Importdatensätze in der Vorschau berücksichtigt.

Relevante LOHN Parameter

Folgende Einstellungen können in den LOHN Parametern für den Abrechnungsimport getroffen werden:

Importdatei/Importverzeichnis	An dieser Stelle kann das Importverzeichnis bzw. die Importdatei bereits fix hinterlegt werden. Folgende Eingabevarianten sind möglich: Dateiname (z. B. C:\Temp\import.csv) Verzeichnis (z. B. C:\Temp) Verzeichnis + Dateiendung (z. B. C:\Temp\.csv) Verzeichnis + Dateimaske (z. B. C:\Temp\Imp.csv) mehrere Dateien bzw. Verzeichnisse durch Kommas (Beistriche) getrennt (z. B. C:\Import.csv, C:\Temp, C:\Daten\.csv) 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.
Schnittstelle	Über diesen Parameter kann die benötigte Import-Schnittstelle fix hinterlegt werden.
Importdatei umbenennen	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

Seitenanfang

Siehe auch:

Dienstnehmer importieren

Fixwerte importieren

Vordienstzeiten importieren

Berechnungsbasis für Schnitte importieren

Kostenverteilung importieren