When a record in SelectHR is ready to be submitted to SelectPay, an audit record is created and placed in the Pending Audit area. These records are picked up during the next run of the payroll service.
If a submission fails, SelectHR generates an XML response in the audit record that contains a brief description of the error. This guide helps you:
Identify the cause of failed submissions
Understand the XML error messages
Apply the correct resolution
🤓 Tip: Use Ctrl + F to search for the error message you're seeing.
Check for failed submissions
To locate failed submissions, follow these steps.
Log in to SelectHR using the HR Menu Set
Go to Admin, click Admin.
Click Integration, then SelectPay Audit Submissions
Click the Failed Submissions tab
From this screen, you’ll see a list of submissions that failed to send.
Alternatively, to see failed submissions on the website, follow these steps.
Under Admin, click Admin.
Click Integration, then click Payroll Audit Data.
Click the Failed Submissions tab.
If you see an error, search for it on the help center to resolve it.
XML errors, causes, and resolutions
Use the table below to match your error to its likely cause and solution.
XML Response | Cause | Resolution | Related Article |
Value cannot be null. Parameter name: first | The Pay Method field is blank in the employee’s Appointment History, even though Payroll Name and Payroll Number exist. | Add a Pay Method to the Appointment History. | |
Cannot insert the value NULL into column 'PPAY_CODE'... | A Pay Element in SelectHR is not mapped to a Pay Element in SelectPay. | Use the Service Administrator to map the Pay Element correctly. | |
The deserializer has no knowledge of which type to deserialize... | Mismatch between the DLL files on the SelectPay Web Server and those in SelectHR. | Update the DLLs on the SelectPay server to match the versions in SelectHR. | |
Unable to retrieve from SelectPay the current period start and end dates for the Monthly Pay Frequency | Pay Periods in SelectPay are not aligned with Tax Periods, causing data retrieval to fail. | Follow the steps in the related article and raise a support case if needed. |