SAP Knowledge Base Article - Public

2093378 - National ID validation issues - Employee Central

Symptom

This article touches on different validation errors received when adding/editing a National ID number for an employee.

  • Please enter a valid National ID of type *** for country/region ***
  • The check digit in the National ID of type *** for country/region *** is not valid. Please correct your entry
  • The format of National ID maintained in CSF Succession Data Model does not match with Standard format for country/region: ***
  • Please enter a valid National ID of this type: ***. You should use the format: ***
  • Please enter a *** using the format ***

Scenario: When entering National ID and try to save, the system throws warning/error asking to enter a valid National ID number. You may have a special set of allowed characters configured, and you are entering the ID correctly according to the format provided on screen, but you get an error.

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

Environment

SAP SuccessFactors Employee Central- National ID

Cause

There are different possibilities that can cause the error/warning messages. It could be at least one of the following:

  • Incorrect National ID configuration in Manage Business Configuration tool (BCUI).
  • Incorrect National ID value entered. There are pre-delivered algorithm based validations for some National IDs.

Resolution

It is likely that you have enabled National ID Validations: Admin Tools > Company System and Logo Settings > Enable National ID Validations.

Enabling this feature will enable algorithm based validations, which will be used instead of those configured in the country/region-specific Succession Data Model. These validations use algorithms to validate whether the ID number being entered is correctly formatted, depending on the country/region you have selected. This maybe a mathematical algorithm or possible reliant on certain values being correctly set in the Biographical Information portlet (personInfo).

Disabling this feature will cause the system to follow the National ID Format configuration defined in the country/region-specific Succession Data Model configuration file (which can be configured to adhere to any format you have chosen) instead of using hard-coded algorithms to calculate and validate an ID number.

To get more information about National ID breakdown validation, please check Employee Central country/region Specifics - Breakdown Validation Rules of National ID

*Note: With this validation enabled, system will generate an error message when using different values than the format provided. This is a hard coded error message and can't be disabled/configured as alert.

FAQ - Additional Information

Q) Does deep validation work during hiring process?

A) Yes, there is not a special logic hereand it's the same as for other national id validations


Q) Can I have a different validation message other than the standard/pre-delivered message?

A) You cannot change the standard/pre-delivered message. You can configure a custom National ID (2668688 - National ID Card: How to create custom Regular Expression and Display Format) where standard validation is not applicable.


Q) Is it possible to have custom National ID configuration for all countries?

A) No. Some countries support custom National ID configuration, whereas others don't support it. Unfortunately, we do not have a list of countries that support/do not support custom National ID configuration. If it's allowed, only regex validation takes place and algorithm based validation does not come into effect. This is the reason sometimes you get an error/warning message for custom National ID configuration for some countries, whereas you do not face any issue for other countries' custom National ID configuration.


Q) Is it possible to change the pre-delivered/pre-defined regular expression (regex) of a national id card?

A) It's not possible to change the pre-delivered/pre-defined regular expression (regex) of some national id cards in Manage Business Configuration (BCUI)/Contry-specific Succession Data Model (CSF SDM). You'll get an error when saving such change(s). However, there are some national id cards for which you can change the regex, and the validation will be only for the configured regex (length, type digit/alphanumeric, etc.). The algorithm-based data validation will not take place in such scenarios. Unfortunately, we do not have list of national id cards for which the pre-defined regex change is allowed.

Q) Why does the system display validation message with previous Regular Expression or Display Format when incorrect data is entered, even after Regular Expression or Display Format is changed/updatde for the National ID card?

A) This is an expected behaviour. It's possible to change Regular Expression or Display Format for some countries and National ID cards, but the built in validation message will still use the pre-delivered Regular Expression and Display Format.


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 on Implement then scroll down to Configuration here
Or

See Also

  • 2601647 - Is it possible to add National ID deep validation to custom national IDs?
  • 2255508 - Can you disable National ID validation?
  • 2668688 - National ID Card: How to create custom Regular Expression and Display Format
  • 2472343 - How to Manage National ID Formats via Manage Business Configuration (BCUI)
  • 2923091 - Error: National ID XYZ already exists for country/region ABC and card type MNP
  • 2268770 - Error: In the country/region-specific XML file, define a format for national ID type *** for *** 
  • 2636240 - National ID Error: Country/Region of National ID must be the same as country/region of legal entity due to restricted permission

Keywords

national ID, validation, breakdown, country/region-specific, rule,country/region-specific, csf, warning, configuration, hard coded, standard, custom, check digit, format, regex, reg-ex, algorithm, previous, old, message , KBA , sf employee_central , sf employee , sf bizx , sf v12 , LOD-SF-EC-PER-NAT , National ID - Config, Rules, RBP, UI , LOD-SF-EC , Employee Central , How To

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM Core all versions

Attachments

error.jpg