Skip to content
Developer home

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 employee
  • 0 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
}