Customer information

Customer information class diagram

Note that the table is divided horizontally into two parts, and additional information for each attribute is provided in the lower table.

Entity	Entity synonyms	Entity definition	Attribute	Attribute synonyms	Attribute definition	Purpose	Data origin

Entity	Entity synonyms	Entity definition	Attribute	Attribute synonyms	Attribute definition	Purpose	Data origin
Customer		A physical person, company, association or other community (e.g. municipality) with a contract for electricity sales, electricity supply and/or electricity purchasing with a supplier and/or a grid agreement with a DSO and which acquires or produces electricity mainly for its own use.	Additional identification		Customer ID that does not uniquely identify the customer	Another ID can be entered in the additional ID field if, for example, a personal identity code is given as the customer ID, and a business ID or VAT number can be entered in the additional ID field.	The customer informs the supplier at the time of agreement or when the information changes
			Customer identification		Customer's unique ID	Based on the unique ID, data retrievals and other actions can be performed on the customer information.	The customer informs the supplier at the time of agreement or when the information changes
			Customer identification type		Information that specifies the type of customer ID	Needed for customer ID validation and efficient data processing.
			Customer sub-type		Customer sub-type that can be normal or an estate	The field is used to separate estate customers from other customers.	Supplier submits the details of the new contract to Datahub
			Customer type		Customer type that can be a consumer or a company	The customer type specifies which customer information must be reported, and the parties need the information about the customer type because consumers and companies are dealt with differently in business operations and legislation.	Supplier submits the details of the new contract to Datahub
			Email address		Customer's e-mail address	Parties can contact the customer by e-mail in various matters.	The customer informs the supplier at the time of agreement or when the information changes
			Information restriction	Private customer	Information that the customer information is classified as private	The supplier informs the network that the customer information is private; preventing the forwarding of the customer information to third parties.	The customer informs the supplier at the time of agreement or when the information changes
			Language	Contact language	Contact language chosen by the customer	The information is forwarded between the parties, so that each party can use the correct language in its communications.	The customer informs the supplier at the time of agreement or when the information changes
			Telephone number		Customer's telephone number	The DSO and/or supplier can call or send an SMS to this number, if necessary.	The customer informs the supplier at the time of agreement or when the information changes
Company	Corporate customer	A customer that is not a consumer. In general, a company customer is a customer that acquires or produces electricity as part of business operations. ’Company customer’ may also mean, however, some other juridical person, such as an association or public body.	Company name		Name of corporate customer	Used to identify a corporate customer	The customer informs the supplier at the time of agreement or when the information changes
Consumer		A customer, who is a natural person and acquires or produces electricity mainly for a purpose that is not connected to a business enterprise.	Date of birth		Consumer customer's date of birth	Information for personal identification	The customer informs the supplier at the time of agreement
			Family name		Consumer customer's family name	Information for personal identification	The customer informs the supplier at the time of agreement or when the information changes
			Given name	First name	Consumer customer's first name	Information for personal identification	The customer informs the supplier at the time of agreement or when the information changes
			Middle names		Consumer customer's middle names	Information for personal identification	The customer informs the supplier at the time of agreement or when the information changes
Postal address		Official postal address of the customer or party.	Apartment	Apartment number Apartment ID Room ID	Apartment identification of the address	Information specifying the address
			Building number	House number	Building number of the address	Information specifying the address
			c/o		Address specifier, or the party the mail is sent to	Information specifying the address
			Country		Country the address is located in	Information specifying the address
			PO Box		PO Box of the address	Information specifying the address
			Post office		Post office of the address	Information specifying the address
			Postal code		Postal code of the address	Information specifying the address
			Stairwell identification	Stair ID Floor identification	Stairwell identification of the address	Information specifying the address
			Street name		Street name of the address	Information specifying the address

Entity	Attribute	Example	Technical example	Cardinality	Data type	Field length	Permitted values

Entity	Attribute	Example	Technical example	Cardinality	Data type	Field length	Permitted values
Customer	Additional identification	1234567-8	1234567-8	0..1	Text	50
	Customer identification	121298-341A	121298-341A	1	Text	50	Format in accordance with ID type and with the following further specifications: The VAT number is used for foreign operators instead of a business ID. The business ID is reported in the international format FI+business ID The party's own ID is in the format <party ID>_<party's own customer number>
	Customer identification type	Personal identity code	AA03	1	Code list	4	Code list
	Customer sub-type	Estate of a deceased person	BF02	1	Code list	4	Code list
	Customer type	Consumer	AB02	1	Code list	4	Code list
	Email address	name.familyname@domain.com	name.familyname@domain.com	0..1	Text	320	RFC 3696
	Information restriction	Yes	1	1	Boolean	1	0 = No 1 = Yes
	Language	Finnish	fi	1	Code list	2	Code list
	Telephone number	+358403453133	+358403453133	0..1	Text	16	ITU-T E.164
Company	Company name	Talent Base Oy	Talent Base Oy	1	Text	200	The official name of the company, entered in the Trade Register or Finnish Register of Associations
Consumer	Date of birth	10.6.1986	1986-06-10	0..1	Date	10	YYYY-MM-DD (ISO 8601)
	Family name	Charlton	Charlton	1	Text	50
	Given name	Edward	Edward	1	Text	50
	Middle names	Michael George	Michael George	0..1	Text	50
Postal address	Apartment	13a	13a	0..1	Text	10
	Building number	21 9b-11a 160/10 35z/3	21 9b-11a 160/10 35z/3	0..1	Text	10
	c/o	Harry Hickson	Harry Hickson	0..1	Text	150
	Country	Finland	FI	1	Code list	2	Code list
	PO Box	PO Box 41	PO Box 41	0..1	Text	15
	Post office	HELSINKI	HELSINKI	1	Text	50	Official post office by Posti, capital letters.
	Postal code	00560	00560	1	Text	10	Official postal codes by Posti
	Stairwell identification	A as. bst.	A as. bst.	0..1	Text	10
	Street name	Syyriankatu	Syyriankatu	0..1	Text