Symptom
- During the signature step for the California State Withholding Form (DE-4), the employer section is not fully populated. No error message is displayed.
- Missing details include Employer Address, California Employer Payroll Tax Account Number, Employer Name & Address (combined section), and Employer Identification Number (EIN). Only the Employer Name appears while other required employer fields remain blank.
Environment
SAP SuccessFactors Onboarding
Reproducing the Issue
- Generate the California State Withholding Form (DE-4) for DocuSign.
- Send the form for DocuSign.
- Open the form and observe the employer section fields; several employer fields are blank except Employer Name.
Cause
- The California Employer Payroll Tax Account Number (DE-4) and US W4 Federal form Employer Identification number are both mapped by default to the same EC field (entity path - jobInfoNav/companyNav/toLegalEntityUSA and field id - employerID).
Resolution
- Align address source mapping:
- Employer address details standard mapping is changed to FOCorporateAddress details, just like in I9 form. And I9 Employer address fields are overridden by JobInfo Location address fields. If the user intend to use Job Location address then re-use same override for other compliance forms as well. For that please just remove the 'supportedTypes' value, so that it will be applicable for all forms. Or please just define another override entry for other compliance forms and override the desired fields.
- Verify employer data exists at the standard EC paths for DE-4:
- CA_BusinessName: jobInfoNav/companyNav/name
- CA_ER_FEID (EIN): jobInfoNav/companyNav/toLegalEntityUSA/employerID
- CA_ER_ADD_LINE1: jobInfoNav/locationNav/addressNavDEFLT/address1
- CA_ER_ADD_LINE2: jobInfoNav/locationNav/addressNavDEFLT/address2
- CA_ER_ADD_City: jobInfoNav/locationNav/addressNavDEFLT/city
- CA_ER_ADD_State: jobInfoNav/locationNav/addressNavDEFLT/stateNav/externalCode
- CA_ER_ADD_Zip: jobInfoNav/locationNav/addressNavDEFLT/zipCode
- Separate US W4 Federal form Employer Identification number and California Employer Payroll Tax Account Number (DE-4):
-
- If DE-4 payroll tax account number must differ from EIN, use fieldMetadataOverride to point the DE-4 field to the desired EC path and set supportedType = US_SWH. For federal W-4, set supportedType = US_W4.
See Also
Keywords
california de-4, employer address missing, employer section blank, docusign, state withholding form, compliance 2.0, fieldMetadataOverride, US_SWH, US_W4, FOCorporateAddress, mapping, permissions, BPE admin, employer section, EIN, Employer Identification number, Employer Payroll Tax Account Number, OBX , KBA , LOD-SF-OBX-FRM , Compliance 2.0 Country Forms (except i9&EV) , Problem
Product
SAP SuccessFactors Onboarding all versions
SAP Knowledge Base Article - Public