This section lists common Pay summary related errors that may appear in Audit log when you running payroll from XCD.
Message (on Click Log):
Attempt to de-reference a null object
User message description:
An Exception has occurred while generating Pay Summary records for the following employee record: salesforce ID
This error means the system has not been possible to create a Pay Summary record for an employee. It may occur if the employee does not have permission to access the record. Permission to see the Pay summary record is required this is so the employee can see their payslip.
We recommend you check the following then try re-draft employee:
Identify which employee record is affected by search salesforce ID in the URL
Check and amend relevant permission are given in standard permission set as well as custom permission set, i.e. Employee Pay or access to Pay Run record type
Message (on Click Log):
Attempt to de-reference a null object
User message description:
An Exception has occurred while updating Pay slip for employee : Employee's name
Line number may appear: 1016, 1186, 1207, 1224, 1245
We recommend you check the following then try re-draft employee:
From employee record → Job role → Check the contract number field is populated
Message (on Click Log):
Blank
User message description:
Insertion process failed for the following instance : Please review the record and do correction before repeat the process. (1)xcdhcm.PaydetailTrigger: execution of AfterInsert
This error is caused by custom process builder/flow which is causing too much load during the same process.
We recommend you to wait for few minutes before you try re-draft employee again
If this fails, contact support or PS to switch custom process builder off and re-draft employee
Message (on Click Log):
Before Insert or Upsert list must not have two identically equal elements
User message description:
An Exception has occurred while creating employee Pay details
Line number may appear: 84, 740, 761, 771
This error means there are two processes in the payroll were trying to access a record at the same time. As a result payments for an employee may fail. This could also affect other employees in the batch. This error may also arises where a record has a retro more than 12 months old as XCD retro handles only up to 12 months.
We recommend you check the following then try re-draft individual employee:
Check no other user are drafting payrun at the same time
From payroll events → Find and Cancel Event of more than 12 months old, or change date to maximum of 12 months back
Message (on Click Log):
Before Insert or Upsert list must not have two identically equal elements
User message description:
An Exception has occurred while processing DML
This error may occur during retro if there are payroll event dated more than 12 months ago.
We recommend you check the following then try re-draft employee:
Check if any employees in retro has payroll event dated more than 12 months ago
Cancel old payroll events and re-run retro
Message (on Click Log):
Update failed. First exception on row 6 with id salesforce record ID; first error: FIELD_CUSTOM_VALIDATION_EXCEPTION, You must remove the Pension scheme when an Employee is not contributing: [xcdhcm__Pension_Scheme__c]
User message description:
An Exception has occurred while creating employee Pay details
This error comes from a validation rule which occurs when a compensation record is linked to a pension scheme with 0 EE contribution and ER contribution. The system is trying to update a list of compensation records during the payrun process to populate the First payment made link and the validation rule is stopping this update.
We recommend you check the following then try re-draft employee:
Check if the compensation has a pension scheme, if there is scheme but no contribution rate, either remove the scheme or enter the correct contribution rate
Message (on Click Log):
Update failed. First exception on row 10 with id salesforce ID; first error: FIELD_CUSTOM_VALIDATION_EXCEPTION, Overtime may not be booked for a date when the employee was not working with the company: []
User message description:
An Exception has occurred while creating employee Pay details
We recommend you check the following then try re-draft employee:
Locate which employee is affected by search the salesforce ID in URL
Check overtime record linked to the employee which are being processed in the payrun
Check and Cancel booked overtime if the record was booked within the incorrect period
If error occurs during retro, you can exclude the Employee from the retro to process other records successfully
Message (on Click Log):
Update failed. First exception on row 9 with id salesforce record ID; first error: CANNOT_EXECUTE_FLOW_TRIGGER, We can't save this record because the "Process builder name" process failed. Give your Salesforce admin these details. This error occurred when the flow tried to update records: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY: xcdhcm.JobRoleTrigger: execution of AfterUpdate
User message description:
An Exception has occurred while creating employee Pay details
Line number may appear: 371, 783
This error is caused by custom process builder/flow which is causing too much load during the same process.
We recommend you to wait for few minutes before you try re-draft employee again
If this fails, contact support or Professional Service to switch custom process builder off and re-draft employee