/paychex-payroll | Type: Application | PCID required: Yes
Tools
paychex_payroll_add_pay_component_for_check
Pay Component to a check. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
checkId | string | Yes | — | ID associated with desired check. |
appliesToWorkerTypes | string[] | No | — | Applies To WorkerTypes. |
checkComponentId | string | No | — | The unique identifier associated for the pay component on this check. |
classificationType | string | No | — | The category that this component falls into. |
componentId | string | No | — | The identifier of the pay component to add to the check. An overtime pay component can’t be placed on a worker that is OT exempt. |
description | string | No | — | The description value |
effectOnPay | string | No | — | The effect that the pay component will have on the check amount. |
endDate | string | No | — | The date that the pay component is not available to be applied on a check moving forward. |
jobId | string | No | — | This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. |
laborAssignmentId | string | No | — | This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. |
lineDate | string | No | — | This is used optionally for specifying a date that the pay component was generated on. |
memoed | boolean | No | — | This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. |
name | string | No | — | The name given to the pay component |
payAmount | string | No | — | The flat amount to be applied for this component. Not used with Rate, Hours, or Units. |
payHours | string | No | — | The number of hours that will be applied for this component. Used in conjunction with rate. |
payRate | string | No | — | The rate amount that will be applied for this component. Used in conjunction with Hours or Units. |
payRateId | string | No | — | The rate identifier for the workers compensation |
payUnits | string | No | — | The number of units that will be applied for this component. Used in conjunction with rate. |
recurring | boolean | No | — | Whether or not this Check Pay Component is recurring or not. A recurring (true) means this is a representation of a Worker Pay Component on the check. A non-recurring (false) is the most common scenario and represents individual check pay components. |
startDate | string | No | — | The date that the pay component is able to be applied on a check. |
paychex_payroll_add_worker_federal_tax
Worker Federal Tax Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
deductionsAmount | string | No | — | See federal W-4 instructions. |
dependentsAmount | string | No | — | See federal W-4 instructions. |
extraWithholdingAmount | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingPercentage or overrideWithholdingPercentage. Cannot be used with overrideWithholdingAmount. If extraWithholdingAmount is entered, existing overrideWithholdingAmount data will be removed. |
extraWithholdingPercentage | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingAmount. Cannot be used with overrideWithholdingAmount or overrideWithholdingPercentage. If entered, existing overrideWithholdingAmount and overrideWithholdingPercentage data will be removed. |
filingStatus | string | No | — | Filing status. |
multipleJobs | string | No | — | See federal W-4 instructions. |
otherIncome | string | No | — | See federal W-4 instructions. |
overrideWithholdingAmount | string | No | — | See federal W-4 instructions. Cannot be used with extraWithholdingAmount, extraWithholdingPercentage, or overrideWithholdingPercentage. If entered, existing extraWithholdingAmount, extraWithholdingPercentage, and overrideWithholdingPercentage data will be removed. |
overrideWithholdingPercentage | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingAmount. Cannot be used with overrideWithholdingAmount or extraWithholdingPercentage. If entered, existing overrideWithholdingAmount and extraWithholdingPercentage data will be removed. |
taxesWithheld | string | No | — | Should federal taxes be withheld: true means federal taxes are withheld, false means federal taxes are NOT withheld. Earnings will still be reported to state and federal agencies. |
taxId | string | No | — | The ID for the federal tax item. |
paychex_payroll_create_company_checks
Company Checks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | Yes | — | ID associated with desired company. |
blockAutoDistribution | boolean | No | — | This is used optionally for blocking the auto distribution of the earnings on the workers if they are setup for auto distribution. |
checkCorrelationId | string | No | — | Id that you define which is used for error handling/responses. This is not required when sending a single check. |
checkDate | string | No | — | The check date |
deductions | object[] | No | — | Deduction pay components on the check. |
earnings | object[] | No | — | The earnings to apply to the check.Each earning needs to define as one of the following:1 .payHours: Will use the default hourly rate defined on the worker to apply the hours against. 2. payHours and payRate: Will allow you to define the monetary rate that the hours will be applied against. 3. payHours and payRateId: Will allow you to define which workers predefined pay rate the hours will be applied against. 4. payUnits: Will use the default hourly rate defined on the worker to apply the units against. 5. payUnits and payRate: Will allow you to define the monetary rate that the units will be applied against. 6. payUnits and payRateId: Will allow you to define which workers predefined pay rate the units will be applied against. 7. payAmount: Will allow you to define straight monetary amount. |
informational | object[] | No | — | Informational pay components on the check. |
links | object[] | No | — | The links value |
paycheckId | string | No | — | The id of a single check that a workers has. |
payPeriodId | string | No | — | The id for the unprocessed payperiod. |
taxes | object[] | No | — | Tax pay components on the check. |
workerId | string | No | — | The id assigned to the worker. |
paychex_payroll_create_worker_check
Worker Check Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
blockAutoDistribution | boolean | No | — | This is used optionally for blocking the auto distribution of the earnings on the workers if they are setup for auto distribution. |
checkCorrelationId | string | No | — | Id that you define which is used for error handling/responses. This is not required when sending a single check. |
deductions | object[] | No | — | Deduction pay components on the check. |
earnings | object[] | No | — | The earnings to apply to the check.Each earning needs to define as one of the following:1 .payHours: Will use the default hourly rate defined on the worker to apply the hours against. 2. payHours and payRate: Will allow you to define the monetary rate that the hours will be applied against. 3. payHours and payRateId: Will allow you to define which workers predefined pay rate the hours will be applied against. 4. payUnits: Will use the default hourly rate defined on the worker to apply the units against. 5. payUnits and payRate: Will allow you to define the monetary rate that the units will be applied against. 6. payUnits and payRateId: Will allow you to define which workers predefined pay rate the units will be applied against. 7. payAmount: Will allow you to define straight monetary amount. |
informational | object[] | No | — | Informational pay components on the check. |
paycheckId | string | No | — | The id of a single check that a workers has. |
payPeriodId | string | No | — | The id for the unprocessed payperiod. |
taxes | object[] | No | — | Tax pay components on the check. |
paychex_payroll_create_worker_direct_deposit
Worker Direct Deposit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
_links | object | No | — | The links value |
accountNumber | string | No | — | The financial institutions account number.This data field cannot be PATCHED. |
accountType | string | No | — | Financial institutions account type. This data field cannot be PATCHED. |
directDepositId | string | No | — | The ID for the direct deposit item. |
paymentType | string | No | — | A type of payment for the direct deposit. |
priority | string | No | — | The priority order for which the direct deposits will be performed in. When a new direct deposit is added the priority will be assigned. The priority can be modified only by swapping with a different direct deposit using the bulk PATCH. A paymentType of REMAINDER will show a priority of 99 and can’t be modified.This data field cannot be PATCHED. |
routingNumber | string | No | — | The financial institutions routing number.This data field cannot be PATCHED. |
startDate | string | No | — | The date that this direct deposit will be applied to future pay periods. This data field cannot be PATCHED. |
value | number | No | — | The amount to be applied to this direct deposit. |
paychex_payroll_create_worker_pay_rate
Worker Pay Rate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
_links | object | No | — | The links value |
amount | string | No | — | The currency amount which this rate is applied. |
default | boolean | No | — | If this rate is the default one to apply on the worker. This data field is not available for an IN_PROGRESS worker and is considered RATE_1. |
description | string | No | — | Describes the rate for the worker. A maximum of 30 characters is allowed. |
effectiveDate | string | No | — | The date when the pay rate becomes effective for the worker (can be used only in POST/PATCH for an active worker). |
rateId | string | No | — | Unique identifier for this workers pay rate. This ID will change if this is created for an IN_PROGRESS worker that is later completed within Flex |
rateNumber | string | No | — | The number of the rate. A worker can have up to 25 different rates. |
rateType | string | No | — | Type of rate. |
standardHours | string | No | — | Default standard hours that this rate is used with a pay frequency. This data field is not available for an IN_PROGRESS worker. |
standardOvertime | string | No | — | Default over time hours that this rate is used with a pay frequency. This data field is not available for an IN_PROGRESS worker. |
startDate | string | No | — | The date when the pay rate is going to begin. |
paychex_payroll_create_worker_recurring
Worker Pay Component Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
_links | object | No | — | The links value |
calculationBaseId | string | No | — | This is required if you are not using a FLAT_DOLLAR_AMOUNT Calculation Type. |
calculationType | string | No | — | The type of calculation that will be applied for the pay component . |
checkLimit | object | No | — | Check Limit |
classificationType | string | No | — | The category that this component falls into. |
componentId | string | No | — | The unique identifier of the pay component. This data field cannot be PATCHED. |
effectiveDate | string | No | — | Date which this pay component has started for the worker. |
effectOnPay | string | No | — | What the effect on pay will be (REDUCTION OR ADDITION), currently only reductions are available. This data field will be populated automatically based on componentId. This data field cannot be PATCHED |
endDate | string | No | — | Date which this pay component has ended for the worker. |
frequency | object | No | — | Worker pay frequency |
name | string | No | — | Name of the pay component. This data field will be populated automatically based on componentId. |
startDate | string | No | — | Date which this pay component will start to be applied during the payruns. This is an optional field that default to current datetime if not provided. This cannot be backdated but can be added to start in the future. |
transactions | object[] | No | — | Pay Component transaction details. |
value | number | No | — | This is used to specify the value that is used against the calculationType. |
workerComponentId | string | No | — | The id of a single pay component that a workers has. |
workerPayCompScheduledEntries | object[] | No | — | Worker Pay Comp Scheduled Entries |
paychex_payroll_delete_check_earning_by_id
Pay Component of a check Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
checkId | string | Yes | — | ID associated with desired check. |
checkComponentId | string | Yes | — | ID associated with an Earning of this check |
paychex_payroll_delete_checks_by_pay_period_id_user_id
Checks by Pay Period and User Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
payperiodid | string | Yes | — | ID associated with desired pay period. |
deletebyuserid | boolean | Yes | — | Value for deletebyuserid parameter should be “true” |
paychex_payroll_delete_worker_check
Worker Check Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
externalCheckId | string | Yes | — | The external check ID. |
paychex_payroll_delete_worker_direct_deposit
Worker Direct Deposit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
directDepositId | string | Yes | — | The id assigned to the direct deposit for this worker. |
effectivitydate | string | No | — | The effectivity date. |
paychex_payroll_delete_worker_pay_rate
Worker Pay Rate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
rateId | string | Yes | — | The id of a single workers compensation rate. |
paychex_payroll_delete_worker_recurring
Worker Pay Component Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
workerComponentId | string | Yes | — | The id of a single pay component that a workers has. |
paychex_payroll_get_company_checks
Company Checks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
companyId | string | Yes | — | ID associated with desired company. |
payperiodid | string | Yes | — | The id assigned to the pay period that the check will be within. |
offset | integer | No | — | The zero based offset of the next page of data to be presented. |
limit | integer | No | — | The maximum number of elements to be returned in a page transition. |
filterbyuserid | boolean | No | — | Filter by User Id. |
paychex_payroll_get_worker_check
Worker Check Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
externalCheckId | string | Yes | — | The external check ID. |
paychex_payroll_get_worker_checks
Worker Checks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
payperiodid | string | Yes | — | The id assigned to the pay period that the check will be within. |
filterbyuserid | boolean | No | — | Filter by User Id. |
paychex_payroll_get_worker_compensation_standard_rates_1
Worker Compensation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
paychex_payroll_get_worker_direct_deposit_by_id
Worker Direct Deposit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
directDepositId | string | Yes | — | The id assigned to the direct deposit for this worker. |
effectivitydate | string | No | — | The effectivity date. |
paychex_payroll_get_worker_direct_deposits
Worker Direct Deposits Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
effectivitydate | string | No | — | The effectivity date. |
asof | string | No | — | Returns all direct deposits as of the date used in the request |
paychex_payroll_get_worker_federal_tax
Worker Federal Tax Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
paychex_payroll_get_worker_pay_rates
Worker Pay Rates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
asof | string | No | — | Returns all pay rates as of the date used in the request |
paychex_payroll_get_worker_pay_rates_by_id
Worker Pay Rate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
rateId | string | Yes | — | The id of a single workers compensation rate. |
asof | string | No | — | Returns compensation as of the date used in the request |
paychex_payroll_get_worker_pay_standards
Worker Pay Standards Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
paychex_payroll_get_worker_recurring_by_id
Worker Pay Component Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
workerComponentId | string | Yes | — | The id of a single pay component that a “Active” worker has. |
asof | string | No | — | Returns pay component as of the date used in the request |
paychex_payroll_get_worker_recurrings
Worker Pay Components Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
effectonpay | string | No | — | What the effect on pay will be (REDUCTION OR ADDITION), currently only reductions are available. |
asof | string | No | — | Returns all pay components as of the date used in the request |
name | string | No | — | The name of a pay component that a workers has. |
componentid | string | No | — | The unique identifier of the pay component. |
classificationtype | string | No | — | The classification type of a pay component that a worker has. (such as “DEDUCTION”, or “REGULAR”,) |
paychex_payroll_get_worker_state_taxes
Worker State Tax Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
paychex_payroll_get_worker_time_off
Worker Time Off Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | The ID of the worker. |
paychex_payroll_patch_check_component_by_id
Pay Component of a Check Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
checkId | string | Yes | — | ID associated with desired check. |
checkComponentId | string | Yes | — | ID associated with an Earning of this check |
appliesToWorkerTypes | string[] | No | — | Applies To WorkerTypes. |
classificationType | string | No | — | The category that this component falls into. |
componentId | string | No | — | The identifier of the pay component to add to the check. An overtime pay component can’t be placed on a worker that is OT exempt. |
description | string | No | — | The description value |
effectOnPay | string | No | — | The effect that the pay component will have on the check amount. |
endDate | string | No | — | The date that the pay component is not available to be applied on a check moving forward. |
jobId | string | No | — | This is used optionally for overriding a job when it needs to be different then the workers default. This option is only available when the client has job costing. |
laborAssignmentId | string | No | — | This is used optionally for overriding a labor assignment when it needs to be different then the workers assignment distribution. This option is only available when the client has labor assignment. |
lineDate | string | No | — | This is used optionally for specifying a date that the pay component was generated on. |
memoed | boolean | No | — | This is used optionally for memoing the payHours or payUnits so that they are informational when using a payAmount. |
name | string | No | — | The name given to the pay component |
payAmount | string | No | — | The flat amount to be applied for this component. Not used with Rate, Hours, or Units. |
payHours | string | No | — | The number of hours that will be applied for this component. Used in conjunction with rate. |
payRate | string | No | — | The rate amount that will be applied for this component. Used in conjunction with Hours or Units. |
payRateId | string | No | — | The rate identifier for the workers compensation |
payUnits | string | No | — | The number of units that will be applied for this component. Used in conjunction with rate. |
recurring | boolean | No | — | Whether or not this Check Pay Component is recurring or not. A recurring (true) means this is a representation of a Worker Pay Component on the check. A non-recurring (false) is the most common scenario and represents individual check pay components. |
startDate | string | No | — | The date that the pay component is able to be applied on a check. |
paychex_payroll_patch_worker_state_taxes
Worker State Tax Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
additionalAmount | number | No | — | See state tax documentation |
additionalPercent | integer | No | — | See state tax documentation |
countrySubdivisionCode | string | No | — | The state abbreviation for a given state tax |
filingStatusType | string | No | — | The filing status of the worker for this state tax |
flatDollarOverride | number | No | — | See state tax documentation |
isResidentState | string | No | — | Whether this worker is a resident in this state |
overridePercent | number | No | — | See state tax documentation |
stateAllocationPercent | string | No | — | The percentage of a worker’s income to be applied to this state tax |
taxStatusType | string | No | — | The withholding status for this state tax |
paychex_payroll_update_worker_direct_deposits_1
Worker Direct Deposits Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
effectivitydate | string | No | — | The effectivity date. Cannot be used with Content Type “application/json-patch+json” |
body | object[] | Yes | — | Request body |
paychex_payroll_update_worker_direct_deposits_2
Worker Direct Deposit Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
directDepositId | string | Yes | — | The id assigned to the direct deposit for this worker. |
effectivitydate | string | No | — | The effectivity date. Cannot be used with Content Type “application/json-patch+json” |
_links | object | No | — | The links value |
accountNumber | string | No | — | The financial institutions account number.This data field cannot be PATCHED. |
accountType | string | No | — | Financial institutions account type. This data field cannot be PATCHED. |
paymentType | string | No | — | A type of payment for the direct deposit. |
priority | string | No | — | The priority order for which the direct deposits will be performed in. When a new direct deposit is added the priority will be assigned. The priority can be modified only by swapping with a different direct deposit using the bulk PATCH. A paymentType of REMAINDER will show a priority of 99 and can’t be modified.This data field cannot be PATCHED. |
routingNumber | string | No | — | The financial institutions routing number.This data field cannot be PATCHED. |
startDate | string | No | — | The date that this direct deposit will be applied to future pay periods. This data field cannot be PATCHED. |
value | number | No | — | The amount to be applied to this direct deposit. |
paychex_payroll_update_worker_federal_tax
Worker Federal Tax Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
deductionsAmount | string | No | — | See federal W-4 instructions. |
dependentsAmount | string | No | — | See federal W-4 instructions. |
extraWithholdingAmount | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingPercentage or overrideWithholdingPercentage. Cannot be used with overrideWithholdingAmount. If extraWithholdingAmount is entered, existing overrideWithholdingAmount data will be removed. |
extraWithholdingPercentage | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingAmount. Cannot be used with overrideWithholdingAmount or overrideWithholdingPercentage. If entered, existing overrideWithholdingAmount and overrideWithholdingPercentage data will be removed. |
filingStatus | string | No | — | Filing status. |
multipleJobs | string | No | — | See federal W-4 instructions. |
otherIncome | string | No | — | See federal W-4 instructions. |
overrideWithholdingAmount | string | No | — | See federal W-4 instructions. Cannot be used with extraWithholdingAmount, extraWithholdingPercentage, or overrideWithholdingPercentage. If entered, existing extraWithholdingAmount, extraWithholdingPercentage, and overrideWithholdingPercentage data will be removed. |
overrideWithholdingPercentage | string | No | — | See federal W-4 instructions. Can be used with extraWithholdingAmount. Cannot be used with overrideWithholdingAmount or extraWithholdingPercentage. If entered, existing overrideWithholdingAmount and extraWithholdingPercentage data will be removed. |
taxesWithheld | string | No | — | Should federal taxes be withheld: true means federal taxes are withheld, false means federal taxes are NOT withheld. Earnings will still be reported to state and federal agencies. |
taxId | string | No | — | The ID for the federal tax item. |
paychex_payroll_update_worker_pay_rate
Worker Pay Rate Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
rateId | string | Yes | — | The id of a single workers compensation rate. |
_links | object | No | — | The links value |
amount | string | No | — | The currency amount which this rate is applied. |
default | boolean | No | — | If this rate is the default one to apply on the worker. This data field is not available for an IN_PROGRESS worker and is considered RATE_1. |
description | string | No | — | Describes the rate for the worker. A maximum of 30 characters is allowed. |
effectiveDate | string | No | — | The date when the pay rate becomes effective for the worker (can be used only in POST/PATCH for an active worker). |
rateNumber | string | No | — | The number of the rate. A worker can have up to 25 different rates. |
rateType | string | No | — | Type of rate. |
standardHours | string | No | — | Default standard hours that this rate is used with a pay frequency. This data field is not available for an IN_PROGRESS worker. |
standardOvertime | string | No | — | Default over time hours that this rate is used with a pay frequency. This data field is not available for an IN_PROGRESS worker. |
startDate | string | No | — | The date when the pay rate is going to begin. |
paychex_payroll_update_worker_recurring
Worker Pay Component Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
workerComponentId | string | Yes | — | The id of a single pay component that a workers has. |
_links | object | No | — | The links value |
calculationBaseId | string | No | — | This is required if you are not using a FLAT_DOLLAR_AMOUNT Calculation Type. |
calculationType | string | No | — | The type of calculation that will be applied for the pay component . |
checkLimit | object | No | — | Check Limit |
classificationType | string | No | — | The category that this component falls into. |
componentId | string | No | — | The unique identifier of the pay component. This data field cannot be PATCHED. |
effectiveDate | string | No | — | Date which this pay component has started for the worker. |
effectOnPay | string | No | — | What the effect on pay will be (REDUCTION OR ADDITION), currently only reductions are available. This data field will be populated automatically based on componentId. This data field cannot be PATCHED |
endDate | string | No | — | Date which this pay component has ended for the worker. |
frequency | object | No | — | Worker pay frequency |
name | string | No | — | Name of the pay component. This data field will be populated automatically based on componentId. |
startDate | string | No | — | Date which this pay component will start to be applied during the payruns. This is an optional field that default to current datetime if not provided. This cannot be backdated but can be added to start in the future. |
transactions | object[] | No | — | Pay Component transaction details. |
value | number | No | — | This is used to specify the value that is used against the calculationType. |
workerPayCompScheduledEntries | object[] | No | — | Worker Pay Comp Scheduled Entries |
paychex_payroll_update_worker_recurrings
Worker Pay Components Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workerId | string | Yes | — | ID associated with desired worker. |
_links | object | No | — | The links value |
calculationBaseId | string | No | — | This is required if you are not using a FLAT_DOLLAR_AMOUNT Calculation Type. |
calculationType | string | No | — | The type of calculation that will be applied for the pay component . |
checkLimit | object | No | — | Check Limit |
classificationType | string | No | — | The category that this component falls into. |
componentId | string | No | — | The unique identifier of the pay component. This data field cannot be PATCHED. |
effectiveDate | string | No | — | Date which this pay component has started for the worker. |
effectOnPay | string | No | — | What the effect on pay will be (REDUCTION OR ADDITION), currently only reductions are available. This data field will be populated automatically based on componentId. This data field cannot be PATCHED |
endDate | string | No | — | Date which this pay component has ended for the worker. |
frequency | object | No | — | Worker pay frequency |
name | string | No | — | Name of the pay component. This data field will be populated automatically based on componentId. |
startDate | string | No | — | Date which this pay component will start to be applied during the payruns. This is an optional field that default to current datetime if not provided. This cannot be backdated but can be added to start in the future. |
transactions | object[] | No | — | Pay Component transaction details. |
value | number | No | — | This is used to specify the value that is used against the calculationType. |
workerComponentId | string | No | — | The id of a single pay component that a workers has. |
workerPayCompScheduledEntries | object[] | No | — | Worker Pay Comp Scheduled Entries |

