SAP Knowledge Base Article - Public

3749758 - New hire home address is blank and unable to complete Section 1 of I9 - Onboarding

Symptom

  • A new hire with a different Home Address from the US cannot complete US I9 Section 1
  • US I-9 Section 1 state field is showing blank or missing for a new not residing in the US.

Environment

SAP SuccessFactors Onboarding

Reproducing the Issue

  1. Login as the affected candidate
  2. Open the Complete US I9 Section 1 card
  3. See that the State field is blank or missing

Cause

Configuration Issue:

Our system is designed to retrieve the state value from the EC entity:

  • EmpEmployment/personNav/homeAddressNavDEFLT/stateNav/externalCode

However, in this case, the system cannot retrieve the value because:

  • EmpEmployment/personNav/homeAddressNavDEFLT/stateNavis null.

When checking Manage Business Configuration, the field is configured as:

  • Data Type: String
  • Picklist: No selection

This means the state field is configured as a string, not as a picklist, while our application expects it to be a picklist.

For comparison, if you check:

  • Manage Business Configuration → homeAddress → homeAddress_USA → state: the field is configured as a picklist and takes values from the STATE_USA picklist.

Based on this, since the user’s home address country is specified as Canada, the system uses the EC structure where state is a string. As a result, our application cannot read externalCode, because the field is not configured as a picklist.

Resolution

To resolve the issue:

  • Please adjust the homeAddress configuration so that the state field uses a picklist.
  • After that, update the user’s home address and select a valid picklist value for the state field.
  • Once this is done, the I-9 Section 1 form is expected to open with the correct state value.

Alternatively:

  • You can override the field metadata configuration using the MDF object FieldMetaOverrideConfiguration and point it to another field that contains a value in this scenario.
  • However, please note that this configuration will apply to all cases, including U.S. candidates, so you should confirm that the adjustment works correctly for U.S. home address scenarios as well. (Coordinate with your Onboarding Certified Consultant for configuration queries).

See Also

  • 3081817 - Form I-9 Section 2 Address Employer's Address Fields Shows Blank - Onboarding
  • 3299710 - Compliance Tasks have Blank or Missing Field - Onboarding
  • 3630089 - Data not populating for First Name, Last Name, Address, SSN of form I-9 - Onboarding

Keywords

US I-9, I-9, I9, Section 1, US I9 Section 1, Compliance Form, Compliance, HomeAddress, Compliance Task, Onboarding, Form, OBX, ONB2 , KBA , LOD-SF-OBX-I9 , i9 Compliance Form , Problem

Product

SAP SuccessFactors Onboarding all versions