2.2.2.15. partyDetails

Entity: partyDetails

The partyDetails entity is used for grouping specific information about a given party, such as health or income data. The entity can be used for supporting a party entity (for example of entityType policyHolder or regularDriver).

Example usage

Below is an example partyDetails entity, filled with some attributes. If income data are part of a message, use the entity partyDetails, entityType income. partyDetails.income should always be used in combination with a party by nesting the partyDetails under the according party, as you can see in the example below.

See AFD 2.0 Online for the complete and up-to-date data catalog with all available entity types and associated attributes listed under the partyDetails entity. More documentation on the use of SIVI AFS is available in chapter Where to find elements of SIVI AFS.

...
{
    "party": [
        {
            "entityType": "policyHolder",
            "surname": "De Jong",
            "partyDetails": [
                {
                    "entityType": "income",
                    "workSituationDescription": "fulltime",
                    "numberOfWorkWeeksPerYear": 46,
                    "travelAllowance": true
                }]
        }]
}
...

Income in case of different occupations

The example below focuses on income in case of different occupations: a primary and a secondary occupation. Data about a secondary occupation can be included with the attributes additionalProfessionEmploymentType, additionalProfessionDescription, additionalProfessionHoursPerWeek. The income data under partyDetails.income are by default considered as total income for all occupations together.

...
{
    "party": [
        {
            "entityType": "policyHolder",
            "surname": "De Jong",
            "partyDetails": [
                {
                    "entityType": "income",
                    "occupationDescription": "hartchirurg",
                    "averageWorkingHoursPerWeek": 16,
                    "employmentType": "Z",
                    "estimatedProfitBeforeTaxCurrentYear": 75000,
                    "profitBeforeTaxOneYearAgo": 258000,
                    "profitBeforeTaxTwoYearsAgo": 18000,
                    "profitBeforeTaxThreeYearsAgo": 35000,
                    "grossIncomeWagesTwoYearsBack": 55000,
                    "grossIncomeWagesThreeYearsBack": 50000,
                    "additionalProfessionEmploymentType": "Z",
                    "additionalProfessionDescription": "kunstschilder",
                    "additionalProfessionHoursPerWeek": 24
                }]
        }]
}
...

Entity types

All entity types currently in use can be found in AFD 2.0 Online.