3283171 - How To Configure Finland Henkilötunnus National ID in Manage Business Configuration (BCUI)

Due to a legal change in the validation of the Finland Henkilötunnus National ID, a configuration change in Manage Business Configuration (BCUI) is required. The legal change will be effective on 1st January, 2023 onwards.

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

• SuccessFactors Employee Central- Localisation Country Specific

• SAP SuccessFactors Employee Central -National ID

The validation for national ID is designed to work exclusively with the standard card type. for Finland (FIN), the standard card type should be `HETU`, not NationalID. 

The sufficient availability of personal identity codes is ensured by introducing new punctuation marks. The current personal identity codes will not be voided, which means that the personal identity codes that have already been granted, would remain unchanged.

The new letters are:

• For those born in the 2000s: Letters B, C, D, E and F will be introduced alongside the letter A currently in use.
• For those born in the 20th century: Letters Y, X, W, V and U will be introduced alongside the hyphen currently in use.

The configuration change can be done either through BCUI or CSF SDM. 

Change Through Manage Business Configuration (BCUI):

1. Navigate to Admin Center and select Manage Business Configuration
2. Expand the HRIS Element nationalIdCard
3. Click on nationalIdCard_FIN
4. In the field Regular Expression replace the existing expression '[\d]\{6\}[A-]\{1\}[\d]\{3\}[0-9 A-FHJK-NPR-Y]\{1\}' with the new expression [\d]{6}[ABCDEFYXWVU-]{1}[\d]{3}[0-9 A-FHJK-NPR-Y]{1}

Change in Country-specific Succession Data Model (CSF SDM):

Download the CSF SDM,

Go to :3153500 - How to Download Data Models, Picklists and other configuration files for Employee Central - SAP SuccessFactors URL: https://me.sap.com/notes/3153500

1. Go to URL: Software Download Center
2. Export 51059062_42 -EC Master Data Model
3. Open the CSF SDM file and go to the following section:

<country id="FIN">
    <format-group id="national-id">
      <format id="HETU">
        <instruction>Henkilötunnus</instruction>

 <instruction xml:lang="en-GB">Personal Identity Code</instruction>
  <instruction xml:lang="en-DEBUG">Personal Identity Code_Lbl#2842</instruction>

<display-format>DDMMYY*NNNX</display-format>
        <reg-ex>[\d]{6}[ABCDEFYXWVU-]{1}[\d]{3}[0-9 A-FHJK-NPR-Y]{1}</reg-ex>
      </format>
    </format-group>

You have to change the reg-ex to the new format as shown below: [\d]{6}[ABCDEFYXWVU-]{1}[\d]{3}[0-9 A-FHJK-NPR-Y]{1}

Once the change is saved, please upload the modified CSF SDM file. You may need access to Provisioning for uploading CSF SDM. If you do not have access to Provisioning, please consider making the change through BCUI or you may contact your implementation partner. 

The code level validation of the new changes should be effective from 12th December, 2022 in Preview environments and 15th December, 2022 in Production environments. If there are any changes in the schedule, we'll update this article. 

FAQ - Additional Information

Q) Where can I download Employee Central Master Data Models?

A) The Data Models are available in the SAP Help Portal under Configuration - Employee Central Master Data Models:

• Click Implement then scroll down to Configuration Here
• URL: https://help.sap.com/viewer/product/SAP_SUCCESSFACTORS_EMPLOYEE_CENTRAL/latest/en-US?task=implement_task

Q) Where can I get information on this from the Guide?

A) Guide: Guide:Country/Region-Specifics for Employee Central 

     Chapter: Identity - Finland

• 2668688 - National ID Card: How to create custom Regular Expression and Display Format 
• 2701612 - How to Import National ID Information 
• 3271777 -How To Retrieve National ID Record In Canvas Report
• 2162838 - National ID Column is not visible in reporting
• 2162775 - How to mask National ID to be kept confidential - SuccessFactors Employee Profile 
• 2456957 - How to default National ID Information fields in the Add New Employee wizard

Finland, Henkilötunnus, National ID, country/region-specific, BCUI, Manage Business Configuration, ECT-201906, PTCH-39773, reg-ex, regular expression, validation, Incident INC16161195, HETU,   <format id="HETU"> , KBA , LOD-SF-EC-PER-NAT , National ID - Config, Rules, RBP, UI , Product Enhancement