Company Roles

Roles must be defined while importing a company with different types of participants.

Code	Description
10	Account Owner (requires identification)
60	Wirtsch. Berechtigter
61	fiktiv wirtschaftlich Berechtigter
70	Gesetzlicher Vertreter /Vertretungsorgan

SubPerson roles

The SubPerson roles can be combined with each other, so an Account Owner can also be a legal representative, beneficial owner or fictitious beneficial owner. For example, the code 106070 indicates that the account owner is also a beneficial Owner and a legal representative. Please use the ascending order in case you need to assign multiple roles. The voting and capital shares are also available in the data of the acting person and can be provided as string ("33.3" without any "%" symbol).

10 Account Owner (requires identification)

Field	Type	Required	Description
type	number	required	0 (customer)
professionell	string	The standard case, the Investor is always a "retail client " within the meaning of the German Securities Trading Act (WpHG) and is therefore always transferred with "False". Classification as a "professional client" within the meaning of the German Securities Trading Act (WpHG) is only made by arrangement.	"""True"" = professional client (WpHG) ""False"" = retail client (WpHG)"
precheckPep	string	required	"True" if politically engaged person
salutation	string	optional	Mr. = "Herr" Mrs. = "Frau"
title	string	optional	Title like "Dr." , "Prof." or "Prof. Dr."
foreName	string	required	All forenames of customer
surName	string	required	Surname of customer
street	string	required	Street name and number
zip	string	required	Postal code
city	string	required	City
country	string	required	Country code
birthDate	string	required	Birthdate (18+)
birthPlace	string	required	Birthplace
birthCountry	string	optional	Birth country code
emailPriv	string	optional	Private e-mail address
nationality	string	required	nationality (country code)
furtherNationalities	array[string]	optional	List of further Nationalities (country code)
phonePriv	array[string]	optional	List of private phone numbers
email	string	optional	Business e-mail address
mobile	string	optional	Mobile phone number
phone	array[string]	optional	Further phone numbers
web	string	optional	Web address
bankAccounts	object	optional	See: Bank Accounts
customFields[].name	string	required	"KYC" (to define the KYC Provider)
customFields[].value	string	required	Chosen KYC Provider (see: KYC-List)
key	string	required	See: Key
modified	string	required	See: Modified

60 Wirtschaftlich Berechtigter/ Beneficial Owner

The beneficial owner within the meaning of the GWG is, among others, a natural person at whose instigation a transaction is ultimately carried out or a business relationship is ultimately established. In the case of legal entities (with the exception of those mentioned in Section 3 (2) GWG), the beneficial owner includes any natural person who directly or indirectly holds more than 25% of the capital shares, controls more than 25% of the voting rights or exercises control in a comparable manner.

Field	Type	Required	Description
type	number	required	0 (customer)
precheckPep	string	required	"True" if politically engaged person
salutation	string	optional	Mr. = "Herr" Mrs. = "Frau"
title	string	optional	Title like "Dr." , "Prof." or "Prof. Dr."
foreName	string	required	All forenames of customer
surName	string	required	Surname of customer
street	string	required	Street name and number
zip	string	required	Postal code
city	string	required	City
country	string	required	Country code
birthDate	string	required	Birthdate (18+)
birthPlace	string	required	Birthplace
birthCountry	string	optional	Birth country code
emailPriv	string	optional	Private e-mail address
nationality	string	required	nationality (country code)
furtherNationalities	array[string]	optional	List of further Nationalities (country code)
phonePriv	array[string]	optional	List of private phone numbers
email	string	optional	Business e-mail address
mobile	string	optional	Mobile phone number
phone	array[string]	optional	Further phone numbers
web	string	optional	Web address
bankAccounts	object	optional	See: Bank Accounts
customFields[].name	string	optional	"KYC" (to define the KYC Provider) OR votingShare OR capitalShares OR fictitious
customFields[].value	string	optional	Chosen KYC Provider (see: KYC-List) OR for votingShare/capitalShares: String (ex. "33.3") , fictitious: BOOL
key	string	required	See: Key
modified	string	required	See: Modified

61 fiktiv wirtschaftlich Berechtigter/ fictitous beneficial owner

If no natural person directly or indirectly controls more than 25% of the voting or capital shares, a fictitious beneficial owner must be designated. The (fictitious) beneficial owner can be the legal representative (e.g. board of directors, managing director, managing manager) or the managing partner.

Field	Type	Required	Description
type	number	required	0 (customer)
precheckPep	string	required	"True" if politically engaged person
salutation	string	optional	Mr. = "Herr" Mrs. = "Frau"
title	string	optional	Title like "Dr." , "Prof." or "Prof. Dr."
foreName	string	required	All forenames of customer
surName	string	required	Surname of customer
street	string	required	Street name and number
zip	string	required	Postal code
city	string	required	City
country	string	required	Country code
birthDate	string	required	Birthdate (18+)
birthPlace	string	required	Birthplace
birthCountry	string	optional	Birth country code
emailPriv	string	optional	Private e-mail address
nationality	string	required	Nationality (country code)
furtherNationalities	array[string]	optional	List of further Nationalities (country code)
phonePriv	array[string]	optional	List of private phone numbers
email	string	optional	Business e-mail address
mobile	string	optional	Mobile phone number
phone	array[string]	optional	Further phone numbers
web	string	optional	Web address
bankAccounts	object	optional	See: Bank Accounts
customFields[].name	string	optional	"KYC" (to define the KYC Provider)
customFields[].value	string	optional	Chosen KYC Provider (see: KYC-List)
key	string	required	See: Key
modified	string	required	See: Modified

70 Gesetzlicher Vertreter/ Vertretungsorgan/ legal representative

Legal representatives of the company are for example the managing director, autorised signatories or the director.

Field	Type	Required	Description
type	number	optional	0 (customer)
salutation	string	optional	Mr. = "Herr" Mrs. = "Frau"
title	string	optional	Title like "Dr." , "Prof." or "Prof. Dr."
foreName	string	required	All forenames of customer
surName	string	required	Surname of customer
customFields[].name	string	optional	"KYC" (to define the KYC Provider)
customFields[].value	string	optional	Chosen KYC Provider (see: KYC-List)
key	string	required	See: Key
modified	string	required	See: Modified