Guidelines for Loading Salary Basis Records
You need to understand key aspects of the Salary Basis object to load salaries and salary bases successfully using HCM Data Loader.
Payroll Elements
Elements that you link to salary bases need to exist in the destination environment before you load salary bases. And, the elements need to be configured for use with salary bases and salaries. Otherwise, your salary bases might not load successfully. For example, the salary bases might not link to a legislative data group or a payroll element.
You can manually correct salary bases using the Salary Basis task in the Compensation work area. For more information about creating the appropriate elements, see DOC ID 1589502.1
Grade Rates
To validate people's salaries against salary ranges defined for a grade you can link a grade rate to the salary basis. This linking also let's you display salary ranges and calculate analytical values, such as compa-ratio and range position. Here are the conditions needed for this to work:
-
The person's grade needs to be in the grade rate linked to their salary basis.
-
The grade rate currency needs to match the currency of the payroll element linked to the salary basis.
-
The grade needs to be in the same legislative data group as the salary basis.
Salary Basis Code
To record the frequency that base pay is stored and displayed at, use the SalaryBasisCode attribute. Valid values are in the CMP_SALARY_BASIS lookup type. The PERIOD (payroll period) value means that the salary frequency comes from the payroll defined at the assignment level.
When you set Salary Basis Code to PERIOD, leave SalaryAnnualizationFactor blank.
Salary Basis Components
To specify whether you're loading salary basis components to itemize salary adjustments, use the ComponentUsage attribute. Valid values are in the CMP_COMPONENT_USAGE lookup type and described here.
| Value | Meaning |
|---|---|
| NO_COMPONENT | Components aren't used and aren't loaded with the Salary Basis object. |
| SELECTED_COMPONENTS | Components are used and are loaded with the Salary Basis object. |
| USER_DECIDES_USAGE | Managers select the components to use when adjusting salary. Components aren't loaded with the Salary Basis object. |
If you set ComponentUsage to SELECTED_COMPONENTS, load the components using the SalaryBasisComponent discriminator. If you omit ComponentUsage, the loader assumes NO_COMPONENT.
You need to provide one Salary Basis Component record for each component type. To identify the component type, such as PROMOTIONAL, COST_OF_LIVING, or ADJUSTMENT, use the AttributeValue attribute. Valid values are in the CMP_SALARY_COMPONENTS lookup type. Use the Manage Base Pay Lookups task in the Setup and Maintenance work area to manage the lookup type.
Salary Basis Deletions
You can delete a Salary Basis object using HCM Data Loader only if the object is unassigned and wasn't used to create salary records. You can delete individual salary bases most easily using the Salary Basis task in the Compensation work area.