/ukg-payroll | Type: Application | PCID required: Yes
Tools
ukg-payroll_add_accruals
Import Accruals Information Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
US-Client-Id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
User-Agent | string | Yes | — | Populates the SourceSytem table into the PayrollPendingItemAccruals table during the import process. |
body | object[] | Yes | — | Request body |
ukg-payroll_company_pay_detail_get_pay_statement_reports_v2
Retrieve finalized pay history details from UKG Pro. This includes earnings, deductions, and tax data. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | No | — | Company identifier the component company of the pay statements |
endDate | string | Yes | — | Ending date for the pay period range to retrieve (inclusive) |
page | integer | No | — | The page number for pagination, starting at 1. |
pagesCount | integer | No | — | The number of pages. |
payGroup | string | No | — | Identifier for a specific group of employees with the same pay schedule |
payPeriodId | integer | No | — | Unique identifier for a specific pay period |
per_Page | integer | No | — | Number of records to return per page (1-200) |
startDate | string | Yes | — | Beginning date for the pay period range to retrieve (inclusive) |
ukg-payroll_create_deduction_pending_pay_item
Create Deduction Pending Pay Item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
comments | string | No | — | A set of notes about the earnings that you may want or need to include. |
companyCode | string | Yes | — | The company identifier: company code. |
deductionAmountEE | string | No | — | The employee deduction amount. Format must be: nnn.nn. |
deductionAmountER | string | No | — | The employer deduction amount. Format must be: nnn.nn. |
deductionCode | string | Yes | — | The deduction code, which must be a deduction with calculation rule Flat Amount and assigned to the employee or part of the employee’s deduction group. |
employeeNumber | string | Yes | — | The employee identifier: employee number. |
includeInNextPayDate | boolean | No | — | A Boolean indicator of whether or not the item is to be paid in the next payroll. If a Scheduled pay date is not provided, it will default to be included in the next payroll. |
itemStatus | string | No | — | The pending pay item status. Only statuses of ‘Pending’ or ‘Submitted’ are allowed. |
itemType | string | Yes | — | The item type of the pending pay record. The system delivered items types available to use are: ‘OnDemandPay’, ‘Giving’, ‘BenefitsInt’, ‘DeductionImport’, ‘Standard’, ‘RetroPay’, ‘StandardAPI’ and ‘EarningImport’. If it is not sent, it will default to ‘StandardAPI’. If sent and an the item type does not exist, it will automatically create a custom item type. |
scheduledPayDate | string | Yes | — | The pay date that the earning is to be paid, which is the Scheduled Pay Date for all imported earnings is Next Pay Date unless a pay date is sent. It does not need to be sent if includeInNextPayDate is true. It must be provided if includeInNextPayDate is false. If provided, it must be a pay date for a regular payroll for the employee’s pay group. If it is not a regular payroll pay date, the earning will not be paid. Format is YYYY-MM-DD. |
sourceKey | string | No | — | A uniquely identifying, user generated source key that is sent in a POST. Pass this as a query parameter in a GET to identify the record you want. |
userName | string | Yes | — | The username of the employee updating the pending pay record. If not specified, ‘Pending Pay Items API’ is used. |
ukg-payroll_create_earnings_pending_pay_item
Create Earnings Pending Pay Item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
comments | string | No | — | A set of notes about the earnings that you may want or need to include. |
companyCode | string | Yes | — | The company identifier: company code. |
earnAmount | string | No | — | The earning amount. Format should be: nnn.nn. |
earnCode | string | Yes | — | The earning code, which must be an earning with a Flat Amount, Flat Amount Track Hours or some related hours based (that is, hours x rate x rate factor) calculation rule. |
earnHours | string | No | — | Earning hours. Format should be: nnn.nn. |
employeeNumber | string | Yes | — | The employee identifier: employee number. |
includeInNextPayDate | boolean | No | — | A Boolean indicator of whether or not the item is to be paid in the next payroll. If a Scheduled pay date is not provided, it will default to be included in the next payroll. |
itemStatus | string | No | — | The pending pay item status. Only statuses of ‘Pending’ or ‘Submitted’ are allowed. |
itemType | string | Yes | — | The item type of the pending pay record. The system delivered items types available to use are: ‘OnDemandPay’, ‘Giving’, ‘BenefitsInt’, ‘DeductionImport’, ‘Standard’, ‘RetroPay’, ‘StandardAPI’ and ‘EarningImport’. If it is not sent, it will default to ‘StandardAPI’. If sent and an the item type does not exist, it will automatically create a custom item type. |
scheduledPayDate | string | Yes | — | The pay date that the earning is to be taken. The Scheduled Pay Date for all imported earnings is Next Pay Date unless a pay date is sent. It does not need to be sent if includeInNextPayDate is true. It must be provided if includeInNextPayDate is false. If provided, it must be a pay date for a regular payroll for the employee’s pay group. If it is not a regular payroll pay date, the earning will not be taken. Format is YYYY-MM-DD. |
sourceKey | string | No | — | A uniquely identifying, user generated source key that is sent in a POST. Pass this as a query parameter in a GET to identify the record you want. |
userName | string | Yes | — | The username of the employee updating the pending pay record. If not provided, ‘Pending Pay Items API’ will be used. |
ukg-payroll_deductions_history_get
Get Payroll Deductions History Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
employeeId | string | No | — | Employee Id |
companyId | string | No | — | Company Id |
checkId | string | No | — | Check Id |
employeeNumber | string | No | — | Employee Number |
deductionCode | string | No | — | Deduction Code |
deductionType | string | No | — | Deduction Type |
benefitOption | string | No | — | Benefit Option |
benefitProvider | string | No | — | Benefit Provider |
payGroup | string | No | — | Pay Group |
periodControl | string | No | — | Period Control |
payDate | string | No | — | Pay Date |
is401K | string | No | — | Is401 K |
is403B | string | No | — | Is403 B |
is408K | string | No | — | Is408 K |
is408P | string | No | — | Is408 P |
is457 | string | No | — | The is457 value |
is457B | string | No | — | Is457 B |
is457F | string | No | — | Is457 F |
is501C | string | No | — | Is501 C |
isD125 | string | No | — | Is D125 |
isDeductionOffSet | string | No | — | Is Deduction Off Set |
isDeferredCompensation | string | No | — | Is Deferred Compensation |
isDependentCare | string | No | — | Is Dependent Care |
isHousing | string | No | — | Is Housing |
isNonQualifiedPlan | string | No | — | Is Non Qualified Plan |
startPerControl | string | No | — | Start Per Control |
endPerControl | string | No | — | End Per Control |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_delete_accrual_by_batch_id
Delete Accrual by Batch ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
US-Client-Id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
User-Agent | string | Yes | — | Populates the SourceSytem table into the PayrollPendingItemAccruals table during the import process. |
batchId | string | Yes | — | Identifier for a batch of accruals. |
ukg-payroll_delete_accrual_by_batch_id_and_source_id
Delete Accrual by Batch ID and Source ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
US-Client-Id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
User-Agent | string | Yes | — | Populates the SourceSytem table into the PayrollPendingItemAccruals table during the import process. |
batchId | string | Yes | — | A unique identifier for a batch of accruals. |
sourceId | string | Yes | — | A unique identifier for accrual from source system. |
ukg-payroll_delete_deduction_pending_pay_item
Delete Deduction Pending Pay Item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The Pending Pay Item ID. |
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_delete_earnings_pending_pay_item
Delete Earnings Pending Pay Item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The Pending Pay Item ID. |
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_delete_services_payroll_v1_import_pay_items_earnings_ref_id
Delete Earning by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
x-correlation-id | string | No | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
refId | string | Yes | — | A unique identifier associated with an earning. |
ukg-payroll_earnings_history_get_ins_rate
Get Earnings History Base Elements Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyID | string | No | — | Company ID |
earningCode | string | No | — | Earning Code |
employeeID | string | No | — | Employee ID |
employeeNumber | string | No | — | Employee Number |
payDate | string | No | — | Pay Date |
payGroup | string | No | — | Pay Group |
periodControl | string | No | — | Period Control |
startPerControl | string | No | — | Start Per Control |
endPerControl | string | No | — | End Per Control |
includeInDeferredCompensation | boolean | No | — | Include In Deferred Compensation |
includeInDeferredCompensationHours | boolean | No | — | Include In Deferred Compensation Hours |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_general_ledger_run_details_v2_get
Retrieve General Ledger Runs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
runId | string | No | — | Run Id |
blockId | string | No | — | Block Id |
mostRecent | string | No | — | Most Recent |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_general_ledger_run_details_v2_get_by_run_id
Retrieve General Ledger Run by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
runId | string | Yes | — | Run Id |
blockId | string | No | — | Block Id |
mostRecent | string | No | — | Most Recent |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_get_activities
Obtains all activities. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_assigned_holidays
Obtains all assigned holidays. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Emp Name |
emp_id | integer | No | — | Emp Id |
from | string | Yes | — | Start range for holidays |
to | string | Yes | — | End range for holidays |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_clock_pending_transactions
Get pending clock transactions. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
emp_id | integer | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_clock_transactions
Get processed clock transactions. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
emp_id | integer | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
date | string | Yes | — | Date of clock transaction |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_current_user
Obtains the current user information. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_employee_jobs
Obtains all jobs for an employee. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Emp Name |
emp_id | integer | No | — | Emp Id |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_employees
Obtains all employees. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | Index when paging is to be used. |
max | integer | No | — | Max elements per page |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_hour_types
Obtains all hour types. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_services_payroll_v1_import_pay_items_earnings_ref_id
Retrieve Earning by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
x-correlation-id | string | No | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
refId | string | Yes | — | A unique identifier associated with an earning. |
ukg-payroll_get_services_ws_mob_simpleschedule_coid_employees_eeid
Obtains a UTA Employee by coId and eeId. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
coid | string | Yes | — | coid of employee. |
eeid | string | Yes | — | eeid of employee. |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_teams
Obtains all teams. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
index | integer | No | — | Index when paging is to be used. |
max | integer | No | — | Max elements per page |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_time_codes
Obtains all time codes. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_time_off_requests
Obtains all time off requests. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Emp Name |
emp_id | integer | No | — | Emp Id |
from | string | Yes | — | Start range for requests |
to | string | Yes | — | End range for requests |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_v1_companies_company_id_direct_deposit
Get list of direct deposit details for US and Canadian employees by company Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | Yes | — | Company Id |
accountIsInactive | string | No | — | Account Is Inactive |
employeeId | string | No | — | Employee Id |
employeeBankRoutingNumber | string | No | — | Employee Bank Routing Number |
countryCode | string | No | — | Country Code |
dateTimeChanged | string | No | — | Used to find direct deposit record changed date less than, greater than, equal to, or between passed date(s) |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_get_v1_direct_deposit
Get list of direct deposit details for US and Canadian employees Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
accountIsInactive | string | No | — | Account Is Inactive |
employeeId | string | No | — | Employee Id |
companyId | string | No | — | Company Id |
employeeBankRoutingNumber | string | No | — | Employee Bank Routing Number |
countryCode | string | No | — | Country Code |
dateTimeChanged | string | No | — | Used to find direct deposit record changed date less than, greater than, equal to, or between passed date(s) |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_get_v1_employees_pay_statement_pay_identifier
Get employee pay statement based on the given pay identifier. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
PayIdentifier | string | Yes | — | Pay Identifier |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_get_work_summaries
Obtain work summaries. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
emp_name | string | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
emp_id | integer | No | — | Employee can be specified by their emp_name or emp_id. At least one parameter must be specified. |
from | string | Yes | — | Start range for work summaries |
to | string | Yes | — | End range for work summaries |
full | boolean | No | — | Specifies if both clock and work detail data should be loaded |
authStatus | boolean | No | — | If specified will load only work summaries with Authorized status equal to true or false |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_get_work_summary
Obtain a work summary. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workSummaryId | integer | Yes | — | Work Summary id |
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
ukg-payroll_pay_group_pay_period_get_pay_group_pay_period
Get PayGroup PayPeriods Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
payDateSeq | integer | No | — | Pay Date Seq |
periodEndDate | string | No | — | Period End Date |
periodStartDate | string | No | — | Period Start Date |
payGroup | string | No | — | Pay Group |
payDate | string | No | — | Pay Date |
startPerControl | string | No | — | Start Per Control |
endPerControl | string | No | — | End Per Control |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_pay_register_get
Get Pay Register Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
employeeId | string | No | — | Employee Id |
companyId | string | No | — | Company Id |
checkId | string | No | — | Check Id |
employeeNumber | string | No | — | Employee Number |
documentNumber | string | No | — | Document Number |
payGroup | string | No | — | Pay Group |
periodControl | string | No | — | Period Control |
payDate | string | No | — | Pay Date |
periodEndDate | string | No | — | Period End Date |
periodStartDate | string | No | — | Period Start Date |
page | integer | No | — | Page number for pagination |
per_Page | integer | No | — | Number of results per page |
ukg-payroll_post_services_payroll_v1_import_pay_items_earnings
Import Earnings for Payroll Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
x-correlation-id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
failAllOnRequest | boolean | No | — | A Boolean indicator of whether or not the entire request fails if any errors are present. When false, valid earnings are staged for import even when errors are present in the request payload. |
earnings | object[] | No | — | The earnings value |
ukg-payroll_post_v1_companies_pay_statements
Get employee(s) pay statement(s) for a company or pay group for a given date range. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
companyId | string | No | — | Company Id |
endDate | string | Yes | — | End date for filtering |
page | integer | No | — | Page number for pagination |
pagesCount | integer | No | — | Pages Count |
payGroup | string | No | — | Pay Group |
per_Page | integer | No | — | Number of results per page |
startDate | string | Yes | — | Start date for filtering |
ukg-payroll_post_v1_companies_pay_statements_summary
Get employee(s) pay statement(s) summary for a company or pay group for a given date range. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
companyId | string | No | — | Company Id |
endDate | string | Yes | — | End date for filtering |
page | integer | No | — | Page number for pagination |
pagesCount | integer | No | — | Pages Count |
payGroup | string | No | — | Pay Group |
per_Page | integer | No | — | Number of results per page |
startDate | string | Yes | — | Start date for filtering |
ukg-payroll_post_v1_employees_pay_statement_last
Get employee last pay statement based on the passed employee identifier. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
employeeIdentifier | object | No | — | Employee Identifier |
endDate | string | No | — | End date for filtering |
page | integer | No | — | Page number for pagination |
pagesCount | integer | No | — | Pages Count |
per_Page | integer | No | — | Number of results per page |
startDate | string | No | — | Start date for filtering |
ukg-payroll_post_v1_employees_pay_statements
Get employee pay statement(s) based on the passed employee identifier for a given date range. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
employeeIdentifier | object | No | — | Employee Identifier |
endDate | string | No | — | End date for filtering |
page | integer | No | — | Page number for pagination |
pagesCount | integer | No | — | Pages Count |
per_Page | integer | No | — | Number of results per page |
startDate | string | No | — | Start date for filtering |
ukg-payroll_put_schedule_details
Publish schedule details. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
wbat | string | Yes | — | The wbat header required for authorization in subsequent requests. |
comment | string | No | — | The comment value |
scheduleDetails | object[] | No | — | Schedule Details |
ukg-payroll_retrieve_deduction_pending_pay_item_by_id
Retrieve Deduction Pending Pay Item by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The Pending Pay Item ID. |
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_retrieve_deduction_pending_pay_item_by_source_key
Retrieve Deduction Pending Pay Item by Source Key Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sourcekey | string | Yes | — | The source key. |
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_retrieve_earnings_pending_pay_item_by_id
Retrieve Earnings Pending Pay Item by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | string | Yes | — | The Pending Pay Item ID. |
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
ukg-payroll_retrieve_earnings_pending_pay_item_by_source_key
Retrieve Earnings Pending Pay Item by Source Key Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
X-Correlation-Id | string | Yes | — | A client-supplied GUID used for tracking the operation’s execution. |
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
sourcekey | string | Yes | — | The source key. |
ukg-payroll_retrieve_employee_pay_details_report_v1
Retrieve finalized pay history details from UKG Pro (v1). This includes earnings, deductions, and tax data. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
us-client-id | string | Yes | — | The Pro Customer primary company code which is unique to each Pro HR Tenant and can be found by navigating to System Configuration > Company Setup and referring to the value for Primary Company Code. |
accruals | object[] | No | — | The accruals value |
addressline1 | string | No | — | Employee address line 1. |
addressline2 | string | No | — | Employee address line 2. |
city | string | No | — | Employee city. |
companyaddresscity | string | No | — | Component company city. |
companyaddresscountry | string | No | — | Component company country. |
companyaddresscounty | string | No | — | Component company county. |
companyaddressline1 | string | No | — | Component company address line 1. |
companyaddressline2 | string | No | — | Component company address line 2. |
companyaddresspostalcode | string | No | — | Component company postal code. |
companyaddressstateorprovince | string | No | — | Component company state or province |
companyname | string | No | — | Component company name. |
companyphone | string | No | — | Component company phone number. |
companyphoneext | string | No | — | Component company phone extention. |
country | string | No | — | The country value |
deductions | object[] | No | — | The deductions value |
deductionscurrent | number | No | — | Total deductions in current pay statement. |
document | string | No | — | The document value |
earnings | object[] | No | — | The earnings value |
employeeidentifier | object | No | — | The employeeidentifier value |
employeenumber | string | No | — | Employee number. |
employeeStatus | number | No | — | Employee status code. “A” = Active, “L” = Leave of Absence (LOA) “O” = On Strike “R” Released/Laid Off “S” = Suspended “T” = Terminated |
federaladditionalamountWithheld | number | No | — | The amount of money an employee requests to their employer to withhold from your paycheck to pay the Internal Revenue Service (IRS) for federal income taxes beyond the normal amount. |
federalallowancesclaimed | integer | No | — | The number of federal allowances claimed. |
fullname | string | No | — | The employee’s full name. |
grosswagescurrent | number | No | — | The total wages on current pay statement. |
job | string | No | — | The employee’s job. |
location | string | No | — | The employee’s work location. |
netpay | object[] | No | — | The netpay value |
netpaycurrent | number | No | — | The netpaycurrent value |
orglevel1 | string | No | — | Customer configured org level 1. |
orglevel2 | string | No | — | Customer configured org level 2. |
orglevel3 | string | No | — | Customer configured org level 3. |
orglevel4 | string | No | — | Customer configured org level 4. |
paydate | string | No | — | The pay date for the pay statement. |
paygroup | string | No | — | Pay group code for the pay statement. |
payidentifier | string | No | — | GenNumber for the pay statement. |
payperiodfrequency | string | No | — | Pay frequency (for example: monthly, weekly, bi-weekly, etc.). |
payrate | number | No | — | Pay rate for the employee. |
periodenddate | string | No | — | End date for the pay period. |
periodstartdate | string | No | — | Start date for the pay period. |
postalcode | string | No | — | The postalcode value |
residentstateallowancesclaimed | integer | No | — | The number of state allowances claimed. |
ssn | string | No | — | The employee’s social security number. |
stateorprovince | string | No | — | State or Province |
taxes | object[] | No | — | The taxes value |
taxescurrent | number | No | — | Total taxes in current pay statement. |
workstateallowancesclaimed | integer | No | — | The workstateallowancesclaimed value |

