2.2.2.2. address

Entity: address

The address entity is used for grouping address-related data. The definition of an address is broad. On the one hand an address is an indication of a location that a person can visit or that has been recognized by a postal service. On the other hand the address entity can also be used for URLs.

Example usage

Below is an example address entity, filled with some attributes. The address entity is nested under the corresponding core entity. 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
address entity. More documentation on the use of SIVI AFS is available in chapter Where to find elements of SIVI AFS.

{
	"party": [ { 
		"entityType": "policyHolder",
		"surname": "Janssen",
		"address": [ {
			"entityType": "default",
			"addressType": "003",
			"street": "Graafseweg",
			"houseNumber": 22,
			"city": "Apeldoorn",
			"country": "NL"
		} ]
	} ]
}

Addresses in different contexts

Using the address entity to register address data is not always necessary. Some entities have their own address attributes. For instance, a company’s address might differ from the address of a building it owns. Below is an overview of how addresses are used in different contexts:

1. Company Insurance: When insuring a company (where the company itself is the risk object), it is essential to know the official company address (defined by attributes under party.company).
2. Liability or Business Interruption Loss Insurance: For liability insurance or business interruption loss insurance, the official company address is required (defined by attributes under party.company).
3. Building Insurance: When insuring a building (e.g., fire insurance), the address of the building must be registered (defined by attributes under object.building).
4. Multiple Addresses: If there are multiple addresses, the address entity can be used.
   

Thus depending on the coverage different addresses may apply.

A change of the home address can have impact on an insurance contract, but not in any case. Insurance contracts linked to the home address, like car, home contents and building are affected by a change of the home address. while other contracts are not.

Entity types

There are no entity types within the address entity. The address entity corresponds to the XA entity plus attributes from the UR entity in AFD 1.0.