Symptom
New York WTPA form is not triggering even after the filterkey1 fieldmetaoverride configuration is maintained as per the SAP documentation - Configuring Wage Theft Protection Act (WTPA) Forms
Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.
Environment
SAP SuccessFactors Onboarding
Reproducing the Issue
- Initiate the Onboarding Process for the candidate with the Job Location/workState as New York.
- Completed the Data Collection Steps for the Candidate
- Wage Theft Protection Act (WTPA) Form is not getting triggered.
Cause
- The fieldmetaoverride for workstate is not returning the expected value as 'NY'
- Incorrect fieldType is used in the overrideFieldMeta under FieldMetaOverrideConfiguration.
Resolution
- The WTPA form would get assigned only when all matching criteria are met : formname , workstate (NY) work country(USA).
- If you are using 'Dropdown or picklist field for filterkey 1, use the below overrideFieldsMeta for workstate. See sample configuration screenshot below:
{
"entity": "jobInfo",
"entityPath": "jobInfoNav/locationNav/addressNavDEFLT/stateNav",
"fieldType": "picklist",
"field": "externalCode"
} - If you are using a 'string' field, use the below overrideFieldsMeta for workstate. See sample configuration in screenshot:
{
"entity": "jobInfo",
"entityPath": "jobInfoNav",
"fieldPath": "",
"fieldType": "",
"field": "[customstring where WTPA Form Name was configured in BCUI]"
}
NOTE: - Notice the field has not hyphen but written as 'customString3'
-
When a custom field is defined as a string type, the system expects the exact WTPA form code to be passed.
Accepted values: LS51, LS54, LS55, LS56, LS57, LS59
See Also
- Configuring Wage Theft Protection Act (WTPA) Forms | SAP Help Portal
- https://community.sap.com/t5/human-capital-management-blogs-by-sap/country-compliance-configure-overrides-for-us-wtpa-form-fields/ba-p/13673209
- https://community.sap.com/t5/human-capital-management-blogs-by-sap/global-filter-definition-for-country-compliance-wtpa-forms/ba-p/13670936
Keywords
WTPA Compliance Form, New York, WTPA, Compliance forms, Onboarding ,Wage Theft Protection Act (WTPA) Forms, Compliance, workState, filterkey1, fieldsOverrideMeta, FieldMetaOverrideConfiguration, NY WTPA, Onboarding, OBX, ONB2, LS51, LS54, LS55, LS56, LS57, LS59 , KBA , LOD-SF-OBX-FRM , Compliance 2.0 Country Forms (except i9&EV) , Problem
SAP Knowledge Base Article - Public