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
- Login as the affected candidate
- Open the Complete US I9 Section 1 card
- 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/stateNavisnull.
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_USApicklist.
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
statefield 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
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
SAP Knowledge Base Article - Public