DH-112-1 Request for customer information update – DSO

DH-112-1 Request for customer information update – DSO

image-20250930-071819.png
Information in the customer data update request from the DSO

Message DH-112-1 is of message type F01.

Message payload includes the following information:

Information field

Level

Necessity

Field content

Note

Information field

Level

Necessity

Field content

Note

Payload

1

1..1

 

 

Start of occurrence

2

1..1

 

 

Original message identification

2

0..1

If message DH-112-1 is a response to event DH-113, the field must contain the identifier of message DH-113-3.

Field usage

Description

2

0..1

 

 

Basic customer information

2

1..1

 

 

Customer identification

3

1..1

  • Business ID

  • Personal identity code

  • Party’s own customer identification

If a personal identity code is provided, it must comply with the format requirements for personal identity codes.

If a party’s own customer identification is used, it must be provided as <supplier’s identification>_<customer number> (used as specifying data in a situation in which the personal identity code is not known or business ID does not exist).

Customer identification type

3

1..1

  • Business ID

  • Personal identity code

  • Party’s own customer identification

If the customer type is consumer, customer identification type must be either personal identity code or party’s own identification. If the customer type is company, customer identification type must be business ID or party’s own identification.

Customer type

3

1..1

  • Company

  • Consumer

 

Customer sub-type

3

0..1

  • Normal

  • Estate of a deceased person

  • Company estate

 

Party’s own customer identification

3

0..1

 

This field can be used only in a situation in which party's own customer identification is updated into a personal ID or business ID. If customer identification type is being updated from party’s own identification to personal ID or business ID with the update, party’s own customer identification is a mandatory field.

Information restriction

3

0..1

Yes/No

 

Language

3

0..1

  • fi

  • en

  • sv

 

Company name

3

0..1

 

The company's official name according to the Business Information System YTJ which can be found in the trade register. In case of an association, the registered name of the association is used.

The maximum length of the company name in Datahub is 200 characters. If the name is longer, it is still written according to the official name and the name is truncated after 200 characters.

Given name

3

0..1

 

The consumer customer name must not contain numbers.

The first letter of a consumer customer’s first and middle name must be in uppercase, and the following letters in lowercase. For multi-part first and middle names, the first letter of each part must be in uppercase, and the following letters in lowercase (e.g., Hanna-Kaisa).

Middle names

3

0..1

 

Family name

3

0..1

 

The consumer customer name must not contain numbers.

Date of birth

3

0..1

Mandatory for a consumer customer, if no personal identity code has been provided

YYYY-MM-DD

 

Additional identification

3

0..1

 

If a business customer also needs to have a personal identity number, that is reported in the additional identification field.

Contact information

3

0..2

 

One telephone number and one e-mail address may be specified for a customer.

Contact information type

4

0..1

  • Telephone

  • E-mail address

 

Telephone number/Email address

4

0..1

 

The reported telephone number or email address must be in the correct format (see Datahub Datastandard). The information must be the customer’s actual contact information through which the customer can be reached if necessary. Contact information should be left blank if it is not known.

A phone number must start with a plus ’+’.

A phone number may not contain spaces.

The country code ‘+358’ may not be followed by the number zero.

Postal address

3

0..1

 

Address information may not contain both PO Box and street address information (street name, building number, stairwell identification or apartment).

If apartment information is reported, stairwell identification is mandatory.

If any data needs to be removed from customer information, the field in question will be sent empty.

Address specifier

4

0..1

c/o

 

Street name

4

0..1

 

 

Building number

4

0..1

 

When the address is in Finland, the building number field:

  • may not contain spaces

  • the only special characters allowed are dot (.), hyphen (-) and slash (/)

  • special characters only are not allowed

Stairwell identification

4

0..1

 

Rules for the stairwell identification field:

  • if the value is one of the following: ‘as’, ‘as.’, ‘bst’ or ‘bst.’, it must be in lowercase

  • if only one letter used, it must be in uppercase, if the address is in Finland

  • spaces are not allowed

Apartment

4

0..1

 

When the address is in Finland, the apartment field:

  • may not contain spaces

  • may not contain uppercase letters

  • the only special characters allowed are dot (.), hyphen (-) and slash (/)

  • special characters only are not allowed

Postal code

4

0..1

 

The postal code and post office must match. This check is only performed for addresses located in Finland.

PO Box

4

0..1

 

 

Post office

4

0..1

 

The postal code and post office must match. This check is only performed for addresses located in Finland.

Country

4

0..1

ISO 31661 alpha-2 ID is used.