Creating a New Employee
Less than to read
Creating a new employee requires different parameters, dependent on the actual case. Details are described here.
The data is provided via a NewEmployee
object.
The gender is specified via an integer with 2 supported values:
-1
for a male employee0
for a female employee
If no concrete entry data is provided, the first of the current payroll calculation month of the company is assumed.
To determine the Betriebsnummer (company registration number) of the health insurance, Sage Business Cloud Payroll provides a separate route. The next steps and the data required depend on whether a social security number does exist for the new employee or not
-
If a social security number is available for the new employee it needs to bbe provided via a dedicated attribute:
string insurance_number; // Social security number
-
If the social security number is not available, some other attributes needs to be provided as they are required for notification purposes:
string birth_name, // Name at birth string birth_place, // Place of birth Date birth_date, // Date of birth int country, // Country of birth
To correctly represent the place of birth of a new employee, a list is provided with supported standardized country codes.
Example #1:
{
"company_id": 196753,
"id": 42,
"last_name": "Flintstone",
"first_name": "Fred",
"address": {
"street_address": "Karl-Heine-Straße 109",
"postal_code": "04229",
"location": "Leipzig"
},
"entry": "2015-04-28",
"sex": -1,
"email": "[email protected]",
"health_insurance": "67450665",
"insurance_number": "13120680D891"
}
Example #2:
{
"company_id": 196753,
"id": 43,
"last_name": "Rubble",
"first_name": "Barney",
"address": {
"street_address": "Karl-Heine-Straße 109",
"postal_code": "04229",
"location": "Leipzig"
},
"entry": "2015-04-28",
"sex": 0,
"email": "[email protected]",
"health_insurance": "01083422",
"insurance_number": "",
"birth_name": "AnotherLastName",
"birth_place": "Leipzig",
"birth_date": "1985-09-13",
"country": 0
}