[KYC-Match]: Legal Address Classification (Multi-Address Support)

[FabrizioMoggio]

In countries like Italy, users may legally declare multiple addresses (residence, domicile, temporary residence). We suggest restructuring the current address handling as an array of address objects, each with a defined legal purpose:

addresses:
type: array
items:
type: object
properties:
addressType:
type: string
enum: [RESIDENCE, DOMICILE, TEMPORARY_RESIDENCE, OTHER]
description: Legal classification of the address.
streetName: string
streetNumber: string
houseNumberExtension: string
locality: string
region: string
postalCode: string
country:
type: string
description: ISO 3166-1 alpha-2

Why?
• Aligns better with civil law systems.
• Enables richer and more precise address matching.
• Removes ambiguity on what the current address field represents.

[GillesInnov35]

@FabrizioMoggio, an issue has been opened on a quite similar subject https://github.com/camaraproject/KnowYourCustomer/issues/151
What address should be checked and the conclusion was that most of operators compare the input address value with each address they have. So in fact type of address may be not useful. WDYT ?
Gilles

[HuubAppelboom]

At KPN we have 2 adresses, a contact address, and a billing address (in case you want to have a paper bill send to another address).
We don't record what type of address it is (like residence, domicile) etc. For Match we alwyas use the contact address.

[FabrizioMoggio]

The discussion continues in https://github.com/camaraproject/KnowYourCustomer/issues/151