SAP Knowledge Base Article - Public

3140353 - Error while mapping national id in BPE Tile - Onboarding


When we initiate onboarding for the candidate, we get the following error in BPE Tile : Country/Region Specific XML file does not have format defined for national ID type XYZ for Country/Region XYZ

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


SAP SuccessFactors Onboarding

Reproducing the Issue

  1. Initiate onboarding for candidate from RCM.
  2. Ensure that you pass the National Id information.
  3. Candidate is not successfully initiated. 


The value of the identifier maintained in Manage Business Configuration does not match the Picklist Value shared from RCM to ONB.


  • This was the value passed from RCM to ONB:
    36. nationalIdCard.[1].card-type: {EntityRecordFieldValue: {rawValue: 663919, localizedValue: Permanent Account Number, rawObject: Permanent Account Number, dataType: picklist}}


The value that should have been passed from RCM as follows: 
36. nationalIdCard.[1].card-type: {EntityRecordFieldValue: {rawValue: 663919, localizedValue: PAN, rawObject: PAN, dataType: picklist}}

  1. In picklist center > *defined picklist for card-type*, matches the Label of the picklist with the identifier. 

  2. Label is changed from "Personal Account Number" to "PAN".
  3. This matches the identifier maintained in the below screenshot from Manage Business Configuration


Manage, Business, Configuration, National Id, Card, Type, Country/Region Specific XML file does not have format defined for national ID type, RCM, nationalId , KBA , LOD-SF-OBX-RCM , Initiate onboarding from RCM , Problem


SAP SuccessFactors Onboarding all versions