curl --request POST \
--url https://sandbox.intermezzo.ai/organizations/{organization_id}/employees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"employeeData": {
"birthDate": "2023-12-25",
"employmentCountry": "DE",
"externalRef": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"birthPlace": "<string>",
"birthCountry": "<string>",
"personalEmail": "[email protected]",
"workEmail": "[email protected]",
"phoneNumbers": [
{
"phoneNumber": "<string>",
"phoneType": "mobile",
"isPrimary": false
}
],
"personalData": {
"employeeName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"employmentCountry": "DE",
"gender": "M",
"maritalStatus": "Single",
"nationality": "German",
"residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
"statusIndicator": "managing_partner_gmbh_ug",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"relatedPersons": {
"persons": [
{
"dependentName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"dependentBirthDate": "2023-12-25",
"relationshipProof": "<string>"
}
],
"employmentCountry": "DE",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"jobDetails": {
"employmentCountry": "DE",
"jobType": "Full Time Indefinite Term",
"employmentStatus": "Employee",
"isSeasonalWorker": false,
"jobTitle": "<string>",
"jobDescription": "<string>",
"schoolEducation": "Ohne Schulabschluss",
"professionalEducation": "Ohne beruflichen Ausbildungsabschluss",
"occupationCode": "<string>",
"contractedWeeklyHours": 40,
"contractedToOtherCompany": false,
"worksiteId": "<string>",
"department": "<string>",
"otherJobs": [
{
"employmentCountry": "DE",
"employerName": "<string>",
"employmentStartDate": "2023-12-25",
"monthlyGrossIncome": 1
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"insuranceDetails": {
"employmentCountry": "DE",
"insuranceNumber": "12345678A123",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": "0",
"privateInsuranceCareMonthly": "0",
"careInsuranceChildren": 0,
"u1Exempt": true,
"u2Exempt": true,
"uvRiskTariff": [
{
"tariffCode": "<string>",
"tariffDescription": "<string>",
"tariffPercentage": "0"
}
],
"pensionDetails": {
"employmentCountry": "DE",
"receivedMiningAdjustmentPayments": false,
"pensionType": "full_old_age_pension_eu_eea_sva",
"pensionStartDate": "2023-12-25",
"waiverDeclarationStatus": "default",
"waiverReceiptDate": "2023-12-25",
"waiverValidityDate": "2023-12-25"
},
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"birthDateContext": "2023-12-25"
},
"taxDetails": {
"taxId": "<string>",
"taxClass": "1",
"employmentCountry": "DE",
"childAllowances": "0.0",
"churchConfession": "AK",
"churchConfessionPartner": "AK",
"factorProcedure": false,
"factor": 499,
"taxAllowanceAmount": 1,
"additionalTaxableAmount": 1,
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"churchMember": false,
"churchTaxState": "Baden-Württemberg"
}
},
"bankAccounts": [
{
"financialInstitutionName": "<string>",
"accountNumber": "DE89370400440532013000",
"routingNumber": "<string>",
"iban": "<string>",
"isActive": true,
"isPrimary": false
}
]
}
]
'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}curl --request POST \
--url https://sandbox.intermezzo.ai/organizations/{organization_id}/employees \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"employeeData": {
"birthDate": "2023-12-25",
"employmentCountry": "DE",
"externalRef": "<string>",
"startDate": "2023-12-25",
"endDate": "2023-12-25",
"birthPlace": "<string>",
"birthCountry": "<string>",
"personalEmail": "[email protected]",
"workEmail": "[email protected]",
"phoneNumbers": [
{
"phoneNumber": "<string>",
"phoneType": "mobile",
"isPrimary": false
}
],
"personalData": {
"employeeName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"employmentCountry": "DE",
"gender": "M",
"maritalStatus": "Single",
"nationality": "German",
"residenceAddress": "Taigschuster 11, 82380 Peissenberg, Germany",
"statusIndicator": "managing_partner_gmbh_ug",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"relatedPersons": {
"persons": [
{
"dependentName": {
"familyName": "<string>",
"givenName": "<string>",
"familyNamePrefix": "<string>",
"givenNameSuffix": "<string>",
"birthName": "<string>",
"birthFamilyNamePrefix": "<string>",
"birthGivenNameSuffix": "<string>",
"title": "<string>"
},
"dependentBirthDate": "2023-12-25",
"relationshipProof": "<string>"
}
],
"employmentCountry": "DE",
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"jobDetails": {
"employmentCountry": "DE",
"jobType": "Full Time Indefinite Term",
"employmentStatus": "Employee",
"isSeasonalWorker": false,
"jobTitle": "<string>",
"jobDescription": "<string>",
"schoolEducation": "Ohne Schulabschluss",
"professionalEducation": "Ohne beruflichen Ausbildungsabschluss",
"occupationCode": "<string>",
"contractedWeeklyHours": 40,
"contractedToOtherCompany": false,
"worksiteId": "<string>",
"department": "<string>",
"otherJobs": [
{
"employmentCountry": "DE",
"employerName": "<string>",
"employmentStartDate": "2023-12-25",
"monthlyGrossIncome": 1
}
],
"validFrom": "2023-12-25",
"validTo": "2023-12-25"
},
"insuranceDetails": {
"employmentCountry": "DE",
"insuranceNumber": "12345678A123",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": "0",
"privateInsuranceCareMonthly": "0",
"careInsuranceChildren": 0,
"u1Exempt": true,
"u2Exempt": true,
"uvRiskTariff": [
{
"tariffCode": "<string>",
"tariffDescription": "<string>",
"tariffPercentage": "0"
}
],
"pensionDetails": {
"employmentCountry": "DE",
"receivedMiningAdjustmentPayments": false,
"pensionType": "full_old_age_pension_eu_eea_sva",
"pensionStartDate": "2023-12-25",
"waiverDeclarationStatus": "default",
"waiverReceiptDate": "2023-12-25",
"waiverValidityDate": "2023-12-25"
},
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"birthDateContext": "2023-12-25"
},
"taxDetails": {
"taxId": "<string>",
"taxClass": "1",
"employmentCountry": "DE",
"childAllowances": "0.0",
"churchConfession": "AK",
"churchConfessionPartner": "AK",
"factorProcedure": false,
"factor": 499,
"taxAllowanceAmount": 1,
"additionalTaxableAmount": 1,
"validFrom": "2023-12-25",
"validTo": "2023-12-25",
"churchMember": false,
"churchTaxState": "Baden-Württemberg"
}
},
"bankAccounts": [
{
"financialInstitutionName": "<string>",
"accountNumber": "DE89370400440532013000",
"routingNumber": "<string>",
"iban": "<string>",
"isActive": true,
"isPrimary": false
}
]
}
]
'{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Country-specific employee data based on employment country
Show child attributes
"DE"EN: External reference | DE: Externe Referenz
EN: Employment start date | DE: Beschäftigungsbeginn
EN: Employment end date | DE: Beschäftigungsende
EN: Phone numbers | DE: Telefonnummern
EN: Personal data | DE: Personaldaten
Show child attributes
EN: Employee name | DE: Mitarbeitername
Show child attributes
"DE"EN: Gender | DE: Geschlecht)
M, W, D EN: Marital status | DE: Familienstand
Single, Married EN: Nationality | DE: Staatsangehörigkeit
"German"
EN: Residence address | DE: Wohnadresse
"Taigschuster 11, 82380 Peissenberg, Germany"
EN: Employee status indicator | DE: Statuskennzeichen
managing_partner_gmbh_ug, proprietor_spouse, proprietor_life_partner, proprietor_biological_child, proprietor_adopted_child, proprietor_grandchild EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
EN: Family details | DE: Familiendaten
Show child attributes
Array of family members
Show child attributes
EN: Dependent name | DE: Name des Angehörigen
Show child attributes
EN: Dependent date of birth | DE: Geburtsdatum des Angehörigen
1"DE"EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
EN: Job details | DE: Beschäftigungsdetails
Show child attributes
"DE"EN: Employment type | DE: Beschäftigungsart
Full Time Indefinite Term, Full Time Fixed Term, Part Time Indefinite Term, Part Time Fixed Term EN: Employee type | DE: Mitarbeitertyp
Employee, Mini Jobber, Midi Jobber, Apprentice, Intern, Werkstudent, Temporary Worker EN: Is seasonal worker? | DE: Ist Saisonarbeitnehmer?
EN: Job title | DE: Berufsbezeichnung
EN: Job description | DE: Stellenbeschreibung
EN: School education | DE: Höchster allgemeinbildender Schulabschluss
Ohne Schulabschluss, Haupt-/Volksschulabschluss, Mittlere Reife oder gleichwertiger Abschluss, Abitur / Fachabitur, Abschluss unbekannt EN: Professional education | DE:Höchster berufsbildender Ausbildungsabschluss
Ohne beruflichen Ausbildungsabschluss, Abschluss einer anerkannten Berufsausbildung, Meister-/Techniker- oder gleichwertiger Fachschulabschluss, Bachelor, Diplom/Magister/Master/Staatsexamen, Promotion, Abschluss unbekannt EN: Occupation code | DE: Tätigkeitsschlüssel
EN: Contracted weekly hours | DE: Vertraglich vereinbarte Wochenstunden
EN: Contracted to another company | DE: Vertrag mit anderem
EN: Work location | DE: Arbeitsort
EN: Department | DE: Abteilung
EN: Other jobs | DE: Andere Beschäftigungen
Show child attributes
"DE"EN: Employer name | DE: Arbeitgebername
EN: Employment start date | DE: Beschäftigungsbeginn
EN: Monthly gross income | DE: Monatliches Bruttogehalt
x >= 0EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
EN: Insurance details | DE: Versicherungsdetails
Show child attributes
"DE"EN: Health insurance number | DE: Versicherungsnummer
"12345678A123"
EN: Contribution group | DE: Beitragsgruppe
4EN: Person group | DE: Personengruppe
101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 116, 117, 118, 119, 120, 121, 122, 123, 124, 127, 190, 140, 141, 142, 143, 144, 149, 150, 203, 204, 207, 208, 209, 210, 301, 302, 303, 304, 305, 306, 307 EN: Health insurance provider | DE: Krankenkasse
EN: Alternate collection agency | DE: Einzugsstelle
EN:Private health insurance monthly|DE:Private Krankenversicherung monatlich
x >= 0EN: Private care insurance monthly | DE: Private Pflegeversicherung monatlich
x >= 0EN: Children for care insurance | DE: Kinder für Pflegeversicherung
0 <= x <= 5EN: U1 exemption | DE: U1 Befreiung
EN: U2 exemption | DE: U2 Befreiung
EN: UV risk tariff details | DE: UV-Risikotarifdetails
Show child attributes
EN: UV risk tariff code | DE: UV-Risikotarifcode
EN: UV risk tariff description | DE: UV-Risikotarifbeschreibung
EN: UV risk tariff percentage | DE: UV-Risikotarifprozentsatz
EN: Pension details for Annex 04a validation | DE: Rentendetails für Anlage 04a-Prüfung
Show child attributes
"DE"EN: Receipt of adjustment payments for dismissed mining employees | DE: Anpassungsgeld-Bezug
EN: Type of pension received (due to age) | DE: Art der Rente (wegen Alters)
full_old_age_pension_eu_eea_sva, full_pension_civil_service, partial_old_age_pension, partial_pension_civil_service, full_old_age_pension_non_eu, full_pension_reduced_earning_capacity EN: Pension start date according to pension notice | DE: Rentenbeginn laut Rentenbescheid
EN: Waiver of pension insurance exemption declaration | DE: Verzichtserklärung Versicherungsfreiheit RV
default, yes, no EN: Date employer received waiver declaration | DE: Eingang Verzichtserklärung beim Arbeitgeber
EN: Date from which waiver is valid | DE: Verzicht gültig ab
EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
EN: Tax data | DE: Steuerdaten
Show child attributes
Steuerliche Identifikationsnummer (11 digits) - ELSTAM: steuerid
11Steuerklasse (1-6) - ELSTAM: steuerklasse
1, 2, 3, 4, 5, 6 "DE"Kinderfreibeträge - ELSTAM: kinderfreibetrag
0 <= x <= 9Must be a multiple of 0.5Konfession für Kirchensteuer - ELSTAM: kirchensteuer
AK, EV, FA, FB, FG, FM, FR, FS, IB, IH, IL, IS, IW, JD, JH, LT, RF, RK, NA, KEINE Konfession des Partners - ELSTAM: kirchensteuer_partner
AK, EV, FA, FB, FG, FM, FR, FS, IB, IH, IL, IS, IW, JD, JH, LT, RF, RK, NA, KEINE Faktorverfahren
Factor Percent as Integer (0-999)
0 <= x <= 999Steuerfreibetrag - ELSTAM: freibetrag monat
x >= 0Hinzurechnungsbetrag - ELSTAM: hinzurechnungsbetrag monat
x >= 0Gültig ab Datum - ELSTAM: gueltig_ab
EN: Valid to date | DE: Gültig bis Datum
Kirchensteuerpflichtig
Bundesland for church tax
Baden-Württemberg, Bayern, Berlin, Brandenburg, Bremen, Hamburg, Hessen, Mecklenburg-Vorpommern, Niedersachsen, Nordrhein-Westfalen, Rheinland-Pfalz, Saarland, Sachsen, Sachsen-Anhalt, Schleswig-Holstein, Thüringen List of bank accounts associated with the employee
Show child attributes
"DE89370400440532013000"
934Successful Response
Was this page helpful?