curl --request PUT \
--url https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}/insurance-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"employeeId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"employmentCountry": "DE",
"insuranceNumber": "<string>",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": "0",
"privateInsuranceCareMonthly": "0",
"careInsuranceChildren": 0,
"u1Exempt": false,
"u2Exempt": false,
"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"
}Update insurance details for an employee (creates new version).
curl --request PUT \
--url https://dev.intermezzo.ai/organizations/{organization_id}/employees/{employee_id}/insurance-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'{
"employeeId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"id": "<string>",
"employmentCountry": "DE",
"insuranceNumber": "<string>",
"contributionGroup": "<string>",
"personGroup": 101,
"insuranceProvider": "<string>",
"alternateCollectionAgency": "<string>",
"privateInsuranceHealthMonthly": "0",
"privateInsuranceCareMonthly": "0",
"careInsuranceChildren": 0,
"u1Exempt": false,
"u2Exempt": false,
"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"
}Get token from Auth0 and paste it here
"DE"German Versicherungsnummer (12 chars: region-birthdate-name-serial-check). Validates according to VKVV § 2. See: https://www.gesetze-im-internet.de/vkvv/__2.html
"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: Pension details for Annex 04a validation | DE: Rentendetails für Anlage 04a-Prüfung
Show child attributes
EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
Successful Response
Response model for insurance details with metadata fields.
"DE"An IntEnum representing the key numbers ('Schlüsselzahlen') for person groups in German social insurance notifications (DEÜV).
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:Private health insurance monthly|DE:Private Krankenversicherung monatlich
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$EN: Private care insurance monthly | DE: Private Pflegeversicherung monatlich
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$Show child attributes
Pension details for German employees according to Annex 04a specification. Required for extended plausibility checks of employed pensioners.
Show child attributes
EN: Valid from date | DE: Gültig ab Datum
EN: Valid to date | DE: Gültig bis Datum
Was this page helpful?