SAP Knowledge Base Article - Public

2433026 - How to Configure Mapping of Address Information in Onboarding 1.0


This KB article explains how to configure Mapping of Address Information of Onboarding with Employee Central fields

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 1.0
  • SAP SuccessFactors Employee Central


For Go-Live Customer(s), and Live Customer(s)

Configuration of Home, Mailing, or Business Address is responsibility of your Implementation Partner or consultant.

For Implementation Partner(s) and Consultant(s)

  1. With Respect to Home Address, issue will be in state mapping.
  2. For USA, state field will flow without any issue since standard field used in Standard Federation Panels.
  3. If you are using lookup in ONB side, then RCM2KMS Lookup Configuration is required please refer to this KBA 2396681 - RCM2KMS Lookup Mapping (state, gender field) - Onboarding 1.0
  4. Panel Configuration:

    Note: Please make sure that the Country is the first field in the Onboarding 1.0 to EC mapping template.

  5. Data Dictionary Configuration:
    4.Data Dictionary.PNG
    5.Data Dictionary.PNG
    6.Data Dictionary.PNG
  6. EC Integration:
  7. Field Mapping Tool Configuration:
    8.Field Mapping Tool.PNG
    Please do not forget to map the Variant to the corresponding Address Type you need to map the address.

  8. Manage Pending Hires

Note: You do not have to stick to our standard Countries and Data List fields in Onboarding 1.0 to map Address Information to EC. What is important is for Country which is mandatory field in EC you send the value for example "USA" for State "California". Use picklists/your own custom data list in Onboarding 1.0 . If using the Standard Data List in Onboarding 1.0 , use RCM2KMS Lookup mapping to ensure the data maps over to EC. To send the data back to Offboarding, it will not work in reverse if you're using the standard data list in Onboarding 1.0 , as EC will send back "USA" for Country "California" for State that doesn't match the value in the data list.


Onboarding, EC, integration, Home Address, State, Country, ISO, 3 Letter Code , KBA , LOD-SF-OBD-INT , Integrations with Onboarding , How To


SAP SuccessFactors Onboarding all versions