Troubleshooting HR and Payroll Integrations

Symptoms

After the HR  data from the Human Resources (HR) Systems is imported to Anthology Student, in case of any failure, it displays a message in Request-Response You can select the link to view the details of the request and response JSON. column in the Inbound HR and Payroll Integration Log page explaining the reason for the failure. For more information, refer toInbound HR and Payroll Integration Log.

Possible Causes

This issue may occur due to the following reasons:

• Integration between Anthology Student and Human Resources (HR) has not been configured correctly.

• One or more of the required fields are missing data. Anthology Student validates a list of fields. If any of the required values are missing the data, the import of HR data fails.

Action to Take to Resolve

To resolve this issue:

• Use the Configure Anthology Student for Integration topic to verify if you have configured and enabled the integration correctly.

• Review the list of the following validations to understand the reason for the failure and provide the missing or incorrect information in the appropriate location to import the data automatically to Anthology Student.

Entities in Anthology Student	Scenarios	Message in Anthology Student	What it Means
Job Function	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Function does not exist.	The IntegrationReferenceIdentifier does not exist in Job Function.
		The Job Function cannot be deleted because it is associated with a Job.	The IntegrationReferenceIdentifier is used in other entities.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		Job Function does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Job Function.
Job Type	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Type does not exist.	The IntegrationReferenceIdentifier does not exist in Job Type.
		The Job Type cannot be deleted because it is associated with a Job.	The IntegrationReferenceIdentifier is used in other entities.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Type does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Job Type.
Position Title	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	The IntegrationReferenceIdentifier does not exist in Position Title.
		The Position Title cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entities.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Position Title.
Position Type	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position type does not exist.	The IntegrationReferenceIdentifier does not exist in Position Type.
		The Position Type cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entities.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Position Type.
		Classification Code is invalid.	The classification code passed is invalid. Pass a valid code.
Job	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job does not exist.	The IntegrationReferenceIdentifier does not exist in Job.
		The Job cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entities.
		The Job cannot be deleted because it is associated with Policies.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		Job does not exist.	In the update scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist or is not integrated.
		Job Type with IntegrationReferenceIdentifier does not exist.	The Job Type IntegrationReferenceIdentifier passed is invalid. Pass a valid value.
		Job Function with IntegrationReferenceIdentifier does not exist.	The Job Function IntegrationReferenceIdentifier passed is invalid. Pass a valid value.
		Effective From Date is invalid.	The effective from date passed is invalid. Pass a valid value. The year of the date must be greater than 1753.
		Effective To Date is invalid.	The effective to date passed is invalid. Pass a valid value.
		Effective From must be less than or equal to Effective To.	The effective from date field must be less than or equal to effective to date.
Position	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position does not exist.	The IntegrationReferenceIdentifier does not exist in Position.
		The Position cannot be deleted because it is associated with another Position.	The IntegrationReferenceIdentifier is used in other entities.
		The Position cannot be deleted because it is associated with Staff Position Assignment.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist or is not integrated.
		FTE is required.	The FTE field does not have a value. This is a mandatory field.
		FTE accepts (0 or greater).	The FTE value passed is a negative value. It must be greater than 0.
		FTE must be greater than 0.	The FTE value passed is a zero value. It must be greater than 0.
		FTE exceeds 9999999999999.99.	The FTE value passed exceeded the maximum length of 9999999999999.99.
		Valid From Date is invalid.	The valid from date passed is invalid. Pass a valid value. The year of the date must be greater than 1753.
		Valid To Date is invalid.	The valid to date passed is invalid. Pass a valid value.
		Valid From Date must be less than or equal to Valid To Date.	The valid from date field must be less than or equal to valid to date.
		Job IntegrationReferenceIdentifier is required.	The Job IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		Job with IntegrationReferenceIdentifier does not exist.	The Job is not integrated or Job record is not found in the system.
		Position valid from and to date should be within the Job duration.	The Position duration is not within the range of the selected Job duration.
		Position Title with IntegrationReferenceIdentifier does not exist.	The Position Title value passed is invalid. Pass a valid value.
		The field Position Type IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The Position Type IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Type with IntegrationReferenceIdentifier does not exist.	The Position Type value passed is invalid. Pass a valid value.
		Parent Position with IntegrationReferenceIdentifier does not exist.	The Parent Position value passed is invalid. Pass a valid value.
		Position cannot be associated with the same Parent Position.	In the update scenario, the same Position IntegrationReferenceIdentifier value is passed as the position.
		Pay Cycle IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		Pay Cycle with IntegrationReferenceIdentifier does not exist.	The Pay Cycle is not integrated or the record is not found in the system.
		Position does not exist.	In the update scenario, the Position value passed is invalid. Pass a valid value.
Staff Position Assignment	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Staff Position Assignment does not exist. .	The Staff Position Assignment IntegrationReferenceIdentifier does not exist in FWM.
		You cannot delete the selected Staff Position Assignment because it is set as primary. Select another Position as primary and try again.	The selected Staff Position Assignment cannot be deleted because it is primary. Select another Position as primary and try again.
		The Staff Position Assignment cannot be deleted because it is associated with Staff Policy Association.	The selected Staff Position Assignment cannot be deleted because it is associated with Staff Policy Association. Or The Staff is configured as part of all Positions in Staff Policy Association.
		The Staff Position Assignment cannot be deleted because it is associated with Staff Payroll.	The Staff Position Assignment cannot be deleted because it is associated with Staff Payroll.
	Create or update	Personnel Number is required.	The Personnel Number does not have a value. This is a mandatory field.
		Primary Contact Email is required.	The Primary Contact Email does not have a value. This is a mandatory field.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Valid From Date is invalid.	The valid from date format is invalid.
		Valid To Date is invalid.	The valid to date format is invalid.
		Valid From must be less than or equal to Valid To.	The valid from date must be less than or equal to Valid to date.
		Staff Position Assignment valid from and to date should be within the Position duration.	The Staff Position Assignment valid from and to date must be within the range of Position duration.
		Staff Position Assignment does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist.
		Staff with Employee Number does not exist.	The Staff with Personnel Number does not exist.
		You cannot change the Staff Position Assignment from primary because at least one primary is required. Specify another Position as primary instead.	When you are trying to update the only primary record to non primary.
		Position IntegrationReferenceIdentifier is required.	The Position IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field Position IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The Position IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Position with IntegrationReferenceIdentifier does not exist.	The Position with IntegrationReferenceIdentifier does not exist in FWM.
		Staff Position Assignment already exists.	The Staff Position Assignment already exists for the Staff.
		Position Assignment cannot be saved because a Staff member is assigned to the Position for dates you specified. Active Assignment cannot have overlapping dates.	The Staff Position Assignment already exists for the dates specified with a different Staff.
		Pay Cycle with IntegrationReferenceIdentifier does not exist.	The Pay Cycle with IntegrationReferenceIdentifier not exists in FWM.
		At least one Staff Position Assignment must be active because the Staff Policy Association exists for the Staff.	The existing Staff Position Assignment for staff must have at least one active staff position assignment.
		Code already exists.	The Code for Staff exists already.
		Campus Group is required.	The Campus Group does not have a value. This is a mandatory field.
		Staff Group Membership is required.	The Staff Group Membership does not have a value. This is a mandatory field.
		Staff Group Membership is invalid.	The Staff Group Membership value is invalid.
		You cannot Add/ Edit the System Administrator.	The System Administrator cannot be added or edited.
		The staff member cannot be deactivated until these scheduled tasks are assigned to another staff member.	The staff member with scheduled task cannot be deactivated. Assign a staff member for the task.
		You cannot deactivate a staff member who manages staff groups.	The staff member who manages the staff group cannot be deactivated.
		Change the Organizational Hierarchy or Delegation configuration in SFAA to deactivate.	To deactivate SFAA, change the Organizational Hierarchy or Delegation configuration
		The staff member cannot be deactivated because they are the default Financial Aid Advisor for below campuses.	The default Financial Aid Advisor staff member for campuses cannot be deactivated.
		Assign new default advisors to deactivate the staff member.	To deactivate the staff member, assign new default advisors.
		{0} has already been selected as Automated User.	{0} is the automated user.
		There can only be one Automated User.	Only one automated user is authorized.
		Password must contain at least {1} character(s).	The password must have minimum characters.
		Password must contain at least {1} character(s).	The password must have minimum numeric.
		Password and Code cannot be same.	The password and code must be unique.

For additional information, contact Anthology Professional Services.

Symptoms

After the payroll data from the Payroll Systems is imported to Anthology Student, in case of any failure, it displays a message in Request-Response You can select the link to view the details of the request and response JSON. column in Inbound HR and Payroll Integration Log page explaining the reason for the failure. For more information, refer toInbound HR and Payroll Integration Log.

Possible Causes

This issue may occur due to the following reasons:

• Integration between Anthology Student and payroll system has not been configured correctly.

• One or more of the required fields are missing the data.Anthology Student validates a list of fields. If any of the required values are missing the data, the import of payroll data fails.

Action to Take to Resolve

To resolve this issue:

• Use the Configure Anthology Student for Integration topic to verify if you have configured and enabled the integration correctly.

• Review the list of following validations to understand the reason for the failure and provide the missing or incorrect information in the appropriate location to import the data automatically to Anthology Student.

Entities in Anthology Student	Scenarios	Message in Anthology Student	What it Means
Earning Code	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Earning Code does not exist.	The IntegrationReferenceIdentifier does not exist in Earning Code.
		The Earning Code cannot be deleted because it is associated with a Load Type.	The IntegrationReferenceIdentifier is used in other entities.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Valid From Date is invalid.	The valid From Date does not have a value. This is a mandatory field.
		Valid To Date is invalid.	The valid To Date does not have a value. This is a mandatory field.
		Start Date must be less than or equal to End Date for Pay Period. IntegrationReferenceIdentifier is required.	The start date field must be less than or equal to end date for pay period.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		Position Type Code does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Earning Code.
Pay Cycle	Delete	IntegrationReferenceIdentifier is required.	The IntegratinoReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Pay Cycle does not exist.	The Pay Cycle IntegrationReferenceIdentifier does not exist in FWM.
		The Pay Cycle cannot be deleted because it is associated with Position.	The Pay Cycle cannot be deleted because it is associated with Position.
		The Pay Cycle cannot be deleted because it is associated with Staff Position Assignment.	The Pay Cycle cannot be deleted because it is associated with Staff Position Assignment.
		The Pay Cycle cannot be deleted because it is associated with a Earning Lines.	The Pay Cycle cannot be deleted because it is associated with a Earning Lines.
	Create or Delete	Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 50.	The Name field exceeded the maximum length of 256.
		Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Frequency Code is required.	The Frequency Code does not have a value. This is a mandatory field.
		Frequency Code is invalid.	The Frequency Code value is invalid.
		Frequency of Pay Cycle cannot be changed.	The Frequency of Pay Cycle cannot be updated.
		Code already exists.	The Pay Cycle Code already exists.
		IntegrationReferenceIdentifier for Pay Period is already integrated.	The IntegrationReferenceIdentifier for Pay Period is already integrated.
		Integration with Payroll system is not available.	There is no integration with any Payroll system.
Pay Period	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Pay Period does not exist.	The Pay Period IntegrationReferenceIdentifier does not exist in FWM.
		Pay Cycle does not exist.	The Pay Cycle IntegrationReferenceIdentifier does not exist in FWM.
		Pay Period association to Pay Cycle is invalid based on Pay Cycle IntegrationReferenceIdentifier.	The Pay Cycle and Pay Period combination based on IntegrationReferenceIdentifier does not exist in FWM.
		The Pay Period cannot be deleted because it is associated with Staff Position Assignment.	The Pay Period cannot be deleted because it is associated with Staff Position Assignment.
		The Pay Period cannot be deleted because it is associated with a Earning Lines.	The Pay Period cannot be deleted because it is associated with a Earning Lines.
	Create or update	Status is required.	The Status does not have a value. This is a mandatory field.
		Pay Period Status code is invalid.	The Pay Period Status code is invalid. Pass a valid value.
		Payment Default Date is invalid.	The Payment Default date is invalid. Pass a valid value.
		Start Date is invalid.	The Start Date is invalid. Pass a valid value.
		End Date is invalid.	The End date is invalid. Pass a valid value.
		Start Date should be less than End Date.	The start date must be less than end date.
		Pay Cycle with IntegrationReferenceIdentifier does not exist.	The Pay Cycle IntegrationReferenceIdentifier does not exist in FWM.
		Pay Period does not exist.	The Pay Period IntegrationReferenceIdentifier does not exist in FWM.
		Pay Period association to Pay Cycle is invalid based on Pay Cycle IntegrationReferenceIdentifier.	The Pay Cycle and Pay Period combination based on IntegrationReferenceIdentifier does not exist in FWM.
Payroll Acknowledgement	Create or update	Sync Status is invalid.	The syncStatus passed is invalid.
		Earning Line Action is invalid.	The EarningLineAction passed is invalid.
		Earning Line does not exist.	The Earning Line does not exist in system.
		Earning Line is in the Generated Status.	The Earning Line is not in exported status.

For additional information, contact Anthology Professional Services.