Symptom
An error is received when passing the data from 3rd party ATS to SAP SuccessFactors Onboarding via API call.
Sample error message:
- <PostNewhireRecordResult><NewhireId>00000000-0000-0000-0000-000000000000</NewhireId><Errors><Error><ErrorCode>101</ErrorCode><ErrorDescription>Input XML does not match XSD. 'xpresshr' is an undeclared prefix. Line 60, position 2.</ErrorDescription></Error></Errors></PostNewhireRecordResult>
Environment
SAP SuccessFactors Onboarding All Versions
Cause
- Input Data XML is using the wrong address in header information like in this example:
<NewHire xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://ns.hr-xml.org/2007-04-15">
- Input Data XML under element "UserArea" uses a custom format that is causing the error. See example of incorrect XML Code Snippet below.
Sample XML Code Snippet:
<UserArea>
<xxx:CustomField name="DummyONBKey01" value="DummyValue" />
<xxx:CustomField name="DummyONBKey02" value="DummyValue" />
<xxx:CustomField name="DummyONBKey03" value="DummyValue" />
</UserArea>
NOTE:
- The SF Onboarding application requires data to be post in the specific format.
- Use only the standard format to avoid errors.
- There are other causes on why fields are having an error when sending it to Onboarding.
Resolution
In the header element, the correct for address is:
Sample XML Code Snippet:
- <NewHire xmlns="http://ns.hr-xml.org/2007-04-15" xmlns:xpresshr="http://online-onboarding.com/Schemas/XpressHR-hrxml.xsd" xmlns:dc="http://purl.org/dc/elements/1.1/">
- In the UserArea element section, the custom element start tag to be use is "xpresshr:CustomField".
Sample XML Code Snippet:
<UserArea>
<!-- Custom Fields -->
<xpresshr:CustomField name="DummyONBKey01" value="DummyValue"/>
<xpresshr:CustomField name="DummyONBKey02" value="DummyValue"/>
<xpresshr:CustomField name="DummyONBKey03" value="DummyValue"/>
<xpresshr:CustomField name="DummyONBKey04" value="DummyValue"/>
<xpresshr:CustomField name="DummyONBKey05" value="DummyValue"/>
</UserArea>
NOTE:
- All the custom elements "xpresshr:CustomField" are represented by the attributes "name" and "value" in the element "UserArea" as illustrated in the XML snippet above.
- SAP SuccessFactors Cloud Product Support does not rectify this kind of issues as this is controlled by a third-party system. If you are a customer, please reach-out to SAP Professional Services or Implementation Partners/Consultants, if you do not have kindly refer to KBA 2279979.
See Also
- Onboarding and Offboarding API: XML Schema and Code Samples
- 2279979 - How To - Engage with SAP Certified Partner or Professional Services/Consulting - Onboarding [General Knowledge]
Keywords
ATS; 3rd Party Integration; API Call error; , KBA , LOD-SF-OBD , Onboarding , LOD-SF-OBD-API , Webservices & API's , Problem