Gesellschafterimport und -export

Was ist der Gesellschafterdatenimport

Der Gesellschafterimport ist eine Schnittstelle, um extern verwaltete Gesellschafterdaten in die Gesellschafterverwaltung einmalig oder jährlich zu importieren. Die Daten müssen als CSV-Datei zur Verfügung stehen und müssen ggf. an die Anforderungen der Schnittstelle angepasst werden. Dies kann z.B. über MS Excel erfolgen.

Neben den Quelldaten (*.csv) wird eine Beschreibungsdatei (*.cfg) benötigt, welche die Quelldaten beschreibt, so dass beim Import die relevanten Daten korrekt interpretiert werden.

CSV Importdatei

Die Quelldatei sollte nur die für den Import relevanten Daten beinhalten und die Gesellschafter in den Zeilen und die zu importierenden Daten in den Spalten beinhalten. In der Beschreibungsdatei wird dann mitunter festgelegt in welcher Zeile sich der erste Datensatz bzw. Gesellschafter befindet und aus welcher Spalte Daten importiert und interpretiert werden sollen.

Bei Bedarf kann die CSV Datei in MS Excel wie jede andere Tabelle bearbeitet werden. Beim Speichern ist darauf zu achten, die Datei wieder als CSV Datei zu speichern.

Aufbau der Beschreibungsdatei

Die Konfigurationsdatei verwendet drei Sektionen:
[Dateibeschreibung], [AllgemeineDaten] und [Feldbeschreibung]
Im Folgenden werden die einzelnen Konfigurationsoptionen beschrieben. Wenn bestimmte Datenquellen anzugeben sind, muss die entsprechende Spaltennummer ermittelt werden. Die erste Spalte ist dabei die 0.

Bereich Dateibeschreibung

Zeichenformat=0 0 = Kein Konvertierung
1 = Die Daten werden von OEM nach ANSI konvertiert.

ErsteImportZeile=1 Die Zeile mit dem ersten Gesellschafter bzw. ersten zu importierenden Datensatz

Feldtrenner=;
Die Daten in einer CSV-Tabelle sind durch diesen Feldtrenner getrennt. Oftmals Semikolon.

Textbegrenzer=" Legt das Zeichen fest, mit dem Textwerte als der CSV-Datei eingeschlossen werden (z. B. " für Anführungszeichen).

Dezimaltrennzeichen=,
Bestimmt das Zeichen, das zur Trennung von ganzzahligem und dezimalem Teil einer Zahl verwendet wird (z. B. Komma).

SymbolZifferngruppierung=. Definiert das Zeichen, mit dem größere Zahlen zur besseren Lesbarkeit gruppiert werden (z. B. Punkt für Tausendertrennung).

DefaultVorzeichen=+ Gibt das Vorzeichen an, das standardmäßig bei nicht explizit angegebenen Vorzeichenwerten angenommen wird.

VorzeichenPlus=+ Legt fest, welches Symbol in den Quelldaten für positive Werte als Vorzeichen verwendet wird.

VorzeichenMinus=- Legt fest, welches Symbol in den Quelldaten für negative Werte als Vorzeichen verwendet wird.

Datumsformat=TT.MM.JJJJ Bestimmt das Format, in dem Datumsangaben in der CSV-Datei vorliegen (z. B. Tag.Monat.Jahr).

DatumsSchwelle=80 Wenn ein Datum ohne Jahrhundert vorliegt, kann über diesen Eintrag gesteuert werden, ab wann 19 bzw. 20 benutzt werden soll. z.B. ein Wert von 5 bedeutet: Jahreszahl kleiner 5 wird als 20. Jahrhundert 20 und Jahreszahl größer 5 als 19. Jahrhundert interpretiert. Ist dieser Eintrag nicht vorhanden wird der Standardwert ( = 80) verwendet.

MergeLines=1 Ist dieser Eintrag gesetzt, werden Zeilen die innerhalb eines beginnenden Hochkommas umgebrochen sind mit der nachfolgenden Zeile zusammengeführt.

Bereich AllgemeineDaten

Vergleichsfelder=1,2 Anhand dieses Feldes bzw. über Komma getrennen Felder, kann ein Gesellschafter bei erneutem Import identifiziert werden kann. Wird der Gesellschafter anhand der Vergleichsfelder gefunden, wird er überschrieben. Andernfalls wird ein neuer Gesellschafter angelegt.
Beispiele für Vergleichsfelder: FB-Nummer, Steueridentnummer oder in Kombination die 3 Felder Name, Vorname und Geburtsdatum.

Titelfelder=4,5 Über diese Spaltennummern kann angegeben werden, welche Daten im Protokoll als Titel für den Gesellschafter verwendet werden sollen. Mehrere Spaltenangaben sind durch Komma getrennt zu erfassen.

GesellschafterSeit=01.01.2013 Das hier angegeben Datum wird für alle Gesellschafter als „Seit“ Datum gesetzt, für die kein Seit-Datum im Datensatz des Gesellschafters angegeben ist.

AnteilsErfassungAls=Prozent Hiermit kann angeben werden, wie der Wert „Anteilserfassung als“ gesetzt wird. Wird nichts angegeben, wird GezeichnetesKapital gesetzt. Es stehen zur Auswahl: GezeichnetesKapital|EingezahltesKapital|Prozent|Bruchteile

GesellschafterNichtLoeschen=1 Vor dem Import werden alle bestehenden Gesellschafter des Mandanten gelöscht. Dies kann mit GesellschafterNichtLoeschen=1 verhindert werden.

AnteileLoeschen=1 Mit AnteileLoeschen=1 werden bestehende Anteile eines Gesellschafters gelöscht, bevor die Anteile importiert werden. Ohne diese Option werden die Anteile nicht gelöscht, sondern nur bestehende zum gleichen Datum überschrieben.

Bereich Feldbeschreibung

Hier erfolgt die Zuordnung der einzelnen Gesellschafterdaten. Nach dem gewählten Feldnamen muss ein “=” stehen, und dahinter die zugehörige Spalte der Importdatei.

Die Felder Firmenbezeichnung1-4 beziehen sich auf die gleichen Felder wie Vorname/Nachname. Sind beide Felder beim Import angegeben, “gewinnen” die Firmendaten.

Es folgt die Liste der möglichen Feldnamen. Die Felder entsprechen den Erfassungsfeldern in der Gesellschafterverwaltung. Bei den historisiertem Feldern können bis zu fünf Historien angegeben werden. Dazu müssen die Feldnamen um eine Nummerierung [1..5] ergänzt werden, z.B.: KonfessionGueltigAb1, KonfessionRelSchluessel1, KonfessionGueltigAb2, KonfessionRelSchluessel2

GesellschafterSeit
GesellschafterBis
Titel
Strasse
Hausnummer
HausnummerZusatz
StrasseHausnummerUndZusatz
Namenszusatz
AdressErgaenzung
AkademischerGrad
Anrede
Land
Geburtsdatum Wird bei Gesellschaftern mit Typ Firma als Gründungsdatum eingelesen.
Notiz
SteuerIdentnummer
Konfession
Bundesland
ArtDesUnternehmens
UStIdentnummer
MandantNr
StillerGesellschafter
FBNummer
Name
Vorname
Nachname
Firmenbezeichnung1
Firmenbezeichnung2
Firmenbezeichnung3
Firmenbezeichnung4
PLZ
Ort
PLZUndOrt Die Daten werden automatisch in PLZ und Ort getrennt übernommen
Finanzamtnummer
Finanzamtname
Steuernummer
AnteilGueltigAb
AnteilKapital
AnteilProzent
AnteilNenner
AnteilZaehler
AnteilAbweichend
AnteilEinlage
AnteilInWA
AnteilSammelposten
AnteilAusschuettungsbeteiligung
AnteilAbweichendProzentInWA
Gruendungsdatum
KonfessionGueltigAb
KonfessionRelSchluessel
SteuerbefreitGueltigAb
Steuerbefreit
AnteileAusweisenGueltigAb
AnteileAusweisen
ArtDerBeteiligungGueltigAb
ArtDerBeteiligung
ArtDesBeteiligtenGueltigAb
ArtDesBeteiligten
BeteiligungGehoertZumGueltigAb
BeteiligungGehoertZum
BeteiligteKapitalgesellschProzentGueltigAb
BeteiligteKapitalgesellschProzent
BeschrSteuerpflichtigGueltigAb
BeschrSteuerpflichtig
SonderbilanzGueltigAb
Sonderbilanz
ErgaenzungsbilanzGueltigAb
Ergaenzungsbilanz
AuswertungskreisSBGueltigAb
AuswertungskreisSB
AuswertungskreisEBGueltigAb
AuswertungskreisEB
MandantNrSBGueltigAb
MandantNrSB
MandantNrEBGueltigAb
MandantNrEB
KontoEndnummerGueltigAb
KontoEndnummer
UnterkontoNummerGueltigAb
UnterkontoNummer
VollhafterGueltigAb
Vollhafter

Es folgt ein Beispiel einer Beschreibungsdatei. Die Daten können als Konfigurationsdatei mit der Dateiendung cfg gespeichert und angepasst werden. Die Beschreibungsdatei gesellschafterexport.cfg, die im ADDISON Installationsverzeichnis unter \ADDISON\Software\Master\Config\ zu finden ist, kann auch als Grundlage für die Importbeschreibungsdatei verwendet werden.

Beispiel Beschreibungsdatei

[Dateibeschreibung]

Zeichenformat=0

ErsteImportZeile=2

Feldtrenner=;

Dezimaltrennzeichen=,

SymbolZifferngruppierung=.

DefaultVorzeichen=+

VorzeichenPlus=+

VorzeichenMinus=-

Datumsformat=TT.MM.JJJJ

MergeLines=1

Textbegrenzer="

[AllgemeineDaten]

Vergleichsfelder=0

Titelfelder=0,4,6

AnteilsErfassungAls=GezeichnetesKapital

[Feldbeschreibung]

FBNummer=0

Zeichnernummer=1

GesellschafterTyp=2

Anrede=3

Nachname=4

Vorname=5

PLZUndOrt=6

StrasseHausnummerUndZusatz=7

SteuerIdentnummer=8

Geburtsdatum=9

GesellschafterSeit=10

AnteilKapital1=11

ArtDerBeteiligungGueltigAb=12

ArtDerBeteiligung=13

ArtDesBeteiligtenGueltigAb=14

ArtDesBeteiligten=15

Gesellschafterexport

Der Gesellschafterexport bietet die Möglichkeit die vorhandenen Gesellschafter eines Mandanten in eine CSV-Datei zu exportieren. Die Beschreibungsdatei gesellschafterexport.cfg, die im ADDISON Installationsverzeichnis unter \ADDISON\Software\Master\Config\ zu finden ist, kann auch als Grundlage für die Importbeschreibungsdatei verwendet werden.

Verwandte Themen

Freischalten von ADDISON Direkt-Anwendungen - Schnelleinstieg für die Steuerkanzlei (ADDISON)

Das Dokument bietet eine Schritt-für-Schritt-Anleitung zur Konfiguration von ADDISON Direkt-Anwendungen für Mandanten. Es beschreibt, wie man die Software öffnet, den Status überprüft, Mandanten auswählt und Anwendungen aktiviert. Es wird darauf hingewiesen, dass verschiedene Applikationen von Wolters Kluwer und Partnern verfügbar sind, und Informationen zu Preisen und AGB gegeben. Der Prozess endet mit einer Übersicht der ausgewählten Anwendungen und der Bestätigung der Konfiguration.

Erstellung von Mandanten-Zugangsdaten für ADDISON Direkt - Schnelleinstieg für den Berater mit ADDISON

Das Dokument beschreibt die Schritte zur Erstellung von Zugangsdaten für den Informationsaustausch über ADDISON Direkt zwischen einer Steuerkanzlei und deren Mandanten. Es erklärt die Freischaltung einzelner oder mehrerer Mandanten. Der Prozess umfasst die Generierung von Logins im ADDISON-Programm, die Auswahl der Mandanten und die Weitergabe der Zugangsdaten.

ADDISON: ADDISON Direkt Berechtigungen, Benutzerverwaltungen und Kommunikation aus ADDISON für Kanzleimitarbeiter

Das Dokument beschreibt die aktuellen Updates zu Berechtigungen, Benutzerverwaltung und Kommunikation in ADDISON Direkt. Es erläutert die Voraussetzungen für den Versand und Aufruf von Kommunikationsnachrichten sowie die Rolle des Absenders. Zudem werden neue Menüpunkte im Register Online vorgestellt, die den Login und die Benutzerverwaltung für AOC-Administratoren betreffen. Besonderes Augenmerk liegt auf der Möglichkeit, Mandantensperren zu übermitteln, sodass gesperrte Mandanten nicht in ADDISON Direkt aufgerufen werden können. Eine PDF-Anleitung ist ebenfalls beigefügt.

ADDISON Direkt Portalindividualisierung: E-Mails und Zugangsdaten anpassen - Schnelleinstieg für den Berater (ADDISON und AKTE)

Das Dokument beschreibt die Anpassung von E-Mails und Zugangsdaten in ADDISON Direkt. Dabei können E-Mails an Mandanten personalisiert werden, um auf neue Dokumente oder Nachrichten hinzuweisen. Mit Variablen können Platzhalter eingesetzt werden, die automatisch durch spezifische Informationen ersetzt werden. Grundlegende Einstellungen für Absender und Signatur sowie individuelle Anpassungen der E-Mail-Vorlagen werden erläutert. Zudem wird die Anpassung von Zugangsdaten-Dokumenten behandelt, einschließlich der Erstellung und Vorschau als PDF. Abschließend werden Tipps zur Bearbeitung und Formatierung der Dokumente gegeben.

ADDISON Direkt Portalindividualisierung - Schnelleinstieg für den Berater (ADDISON)

Der Text beschreibt die „ADDISON Direkt Portalindividualisierung“, die es ermöglicht, ein Kanzleiportal individuell zu gestalten. Nutzer lernen, wie sie Designanpassungen, Logos, Farbpaletten und Kontaktinformationen einfügen können. Zudem werden Funktionen zur Anpassung der Login-Seite, E-Mail-Signaturen, Dateitypen und Impressum erklärt. Am Ende können Nutzer eine Datenschutzerklärung verwalten und anpassen. Eine PDF-Anleitung steht zum Download zur Verfügung, um den Einstieg zu erleichtern.