---
title: "Create a PY Employee Deduction"
slug: "create-a-py-employee-deduction"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/create-a-py-employee-deduction"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a PY Employee Deduction
Post/hcm-rest-api/rest/1/pyempded
## Create Employee Deductions
UI Location: Human Capital Management - US Payroll - Setup - Employees - Deductions
###
SecurityHTTPType basic
Basic authentication
Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceItem+json
Body parametersobject Example{
"EmdPloName": "401K 1%",
"EmdPloCode": "401K 1%",
"EmdStartDate": "2015-01-01",
"EmdCompCode": "001",
"EmdPrnCode": "WK",
"EmdDedCode": "401K",
"EmdDedType": "L",
"EmdPlanCode": "401K",
"EmdPlanName": "401K",
"EmdEmpNo": "006",
"EmdEffStartDate": "2022-01-01",
"EmdLastUpdDate": "2022-12-15T12:03:12-05:00",
"EmdUser": "ARCORO",
"EmdOutOfAreaFlag": "N",
"EmdOthInsurFlag": "N",
"EmdVUuid": ""
}EmdPloNamestring Required
Plan Optional Name
Max length30
EmdEffStartDatestring Required
💻 UI Fieldname: *Effective Date
EmdStartDatestring Required
Effective Starting Date
💻 UI Fieldname: Start Date
EmdPlanNamestring Required
Plan Name
Max length30
EmdOutOfAreaFlagstring Required
💻 UI Fieldname: *Out Of Area
Max length1
EmdDedCodestring Required
Identify the Deduction
💻 UI Fieldname: Deduction Code
Max length4
EmdVUuidstring Required
Unique uuid of row. Leave Empty
Max length64
EmdPloCodestring Required
Plan Optional Code
💻 UI Fieldname: Plan Option
Max length10
EmdLastUpdDatestring Required
Date and Time of the last update
EmdCompCodestring Required
Company Code
Max length8
EmdPlanCodestring Required
Plan Code
💻 UI Fieldname: Plan Code
Max length10
EmdDedTypestring Required
Deduction Type
💻 UI Fieldname: Deduction Type
Max length2
EmdPrnCodestring Required
Identify the Pay Run Code
Max length4
EmdUserstring Required
The name of the user who made the last update
Max length30
EmdEmpNostring Required
The unique identifier of an employee
Max length16
EmdOthInsurFlagstring RequiredMax length1
EmdVendorstring
Vendor
💻 UI Fieldname: Vendor
Max length8
EmdOthInsurVendorstring Max length10
EmdBaseCodestring
Base Code
Max length4
EmdVenNamestring
Vendor Name
Max length200
EmdOthPolicyNostring Max length16
EmdOthInsurEffDatestring
EmdMinMaxstring Max length1
EmdDefaultAmountnumber
EmdVendorAddCodestring Max length5
EmdContrAmtnumber
Contract Amount
💻 UI Fieldname: Employer Contribution
Max length18
EmdCompRefOraseqnumber Max length11
EmdCommentstring
Election or loan ID number
💻 UI Fieldname: Comment
Max length60
EmdOthPolicyNamestring Max length30
EmdEndDatestring
Effective Ending Date of the Deduction
💻 UI Fieldname: End Date
EmdStartDateDisplaystring Max length10
EmdLtdTotalAmtnumber
Life-to-date total deduction amount allowed since the effective start date.
💻 UI Fieldname: Life-To-Date Total Amount
Max length18
EmdBaseAmtnumber
Base Amount
💻 UI Fieldname: Base Amount
Max length18
EmdIuCreateUserstring
User who created record, Leave Blank
Max length30
EmdDeductionSeqnumber
Identify the deduction record for the employee to thread user extensions through
EmdTotalAmtnumber
Total Amount
💻 UI Fieldname: Yearly Total Amount
Max length18
EmdDedNamestring
Deduction Name
Max length30
EmdMinMaxAmtnumber
💻 UI Fieldname: Minimum Take Home
Max length18
EmdContrMaxAmtnumber
Contract Maximum Amount
💻 UI Fieldname: Maximum Contribution
Max length18
EmdEmplrContrEffectiveDatestring
💻 UI Fieldname: Employer Effective Date
EmdDedAmountnumber
The value of the deduction in line with its type
💻 UI Fieldname: Deduction Amount
Max length18
Responses201
Created
HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json
```json
{
"EmdCompCode": "001",
"EmdPrnCode": "WK",
"EmdEmpNo": "006",
"EmdDedCode": "401K",
"EmdDedName": null,
"EmdStartDate": "2015-01-01",
"EmdEffStartDate": "2022-01-01",
"EmdEndDate": null,
"EmdDedAmount": null,
"EmdDedType": "L",
"EmdBaseCode": null,
"EmdContrAmt": null,
"EmdContrMaxAmt": null,
"EmdBaseAmt": null,
"EmdPlanCode": "401K",
"EmdPlanName": "401K",
"EmdPloCode": "401K 1%",
"EmdPloName": "401K 1%",
"EmdVendor": null,
"EmdVenName": null,
"EmdOutOfAreaFlag": "N",
"EmdOthInsurFlag": "N",
"EmdOthInsurVendor": null,
"EmdOthPolicyNo": null,
"EmdOthPolicyName": null,
"EmdOthInsurEffDate": null,
"EmdComment": null,
"EmdDeductionSeq": null,
"EmdVendorAddCode": null,
"EmdDefaultAmount": null,
"EmdMinMax": null,
"EmdMinMaxAmt": null,
"EmdTotalAmt": null,
"EmdEmplrContrEffectiveDate": null,
"EmdLtdTotalAmt": null,
"EmdUser": "ARCORO",
"EmdStartDateDisplay": null,
"EmdLastUpdDate": "2022-12-15T17:03:12Z",
"EmdVUuid": "F29E92DB91174021E05316821FAC099D",
"links": [
{
"rel": "self",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempded/F29E92DB91174021E05316821FAC099D",
"name": "pyempded",
"kind": "item"
},
{
"rel": "canonical",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempded/F29E92DB91174021E05316821FAC099D",
"name": "pyempded",
"kind": "item"
}
]
}
```
object