---
title: "Create a PY Tax Exemption"
slug: "create-a-py-tax-exemption"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/create-a-py-tax-exemption"
---
> ## 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 Tax Exemption
Post/hcm-rest-api/rest/1/pytaxexm
## Create Tax Exemptions
###
SecurityHTTPType basic
Basic authentication
Header parametersContent-TypestringExampleapplication/vnd.oracle.adf.resourceItem+json
Body parametersobject Example{
"TxxEmpNo": "805",
"TxxStateCode": "ALL",
"TxxEffectiveDate": "2022-01-19",
"TxxWrlCode": "ALL",
"TxxLastUpdDate": "2022-01-19T12:42:15-05:00",
"TxxFilingStatus": "01",
"TxxUser": "ARCORO",
"TxxVUuid": ""
}TxxEffectiveDatestring Required
TxxWrlCodestring Required
Work location code. (ALL for state level tax)
Max length15
TxxFilingStatusstring Required
Filing Status of employee for Taxation purpose
Max length2
TxxVUuidstring Required
Unique uuid of row
Max length64
TxxEmpNostring Required
The unique identifier of an employee
Max length16
TxxLastUpdDatestring Required
Date and Time stamp of the last update
TxxStateCodestring RequiredMax length4
TxxUserstring Required
The name of the user who made the last update
Max length30
TxxOtherDeductionAmtnumber
Federal W4-form field introduced in 2020 indicating other deductions amount for the year.
Max length11
TxxNrCertificatestring
NR Certificate provided Y/N
Max length1
TxxPrimWorkLocCodestring
Currently only used by Indiana state to specify Indiana primary work location. Primary work county effective January 1 determines work county tax for the whole year.
Max length15
TxxSuplExpAmountnumber
Supplementary Exemption amount
Max length18
TxxTenantIdstring
Tenant ID, Leave Blank
Max length30
TxxDepTaxCreditAmtnumber
Federal W4-form field introduced in 2020 indicating dependents and other tax credits for the year.
Max length11
TxxOtherIncomeAmtnumber
Federal W4-form field introduced in 2020 indicating other non-wage income for the year.
Max length11
TxxSecnExempnumber
Number of Secondry Exemptions
Max length2
TxxMultiJobsFlagstring
Federal W4-form field introduced in 2020 indicating if employee work multiple jobs (Y/N/null).
Max length1
TxxExempAmountnumber
Exemption Amount
Max length18
TxxPrimExempnumber
Number of Primary Exemptions
Max length2
TxxTertExempnumber
Number of Tertairy Exemptions
Max length2
TxxResidenceLocCodestring
Currently only used by Indiana state to specify Indiana residence location. Residence county effective January 1 determines residence county tax for the whole year.
Max length15
Responses201
Created
HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourceitem+json
```json
{
"TxxEmpNo": "805",
"TxxStateCode": "ALL",
"TxxEffectiveDate": "2022-01-19",
"TxxFilingStatus": "01",
"TxxNrCertificate": null,
"TxxExempAmount": null,
"TxxSuplExpAmount": null,
"TxxPrimExemp": null,
"TxxSecnExemp": null,
"TxxTertExemp": null,
"TxxUser": "ARCORO",
"TxxLastUpdDate": "2022-01-19T17:42:15Z",
"TxxWrlCode": "ALL",
"TxxResidenceLocCode": null,
"TxxPrimWorkLocCode": null,
"TxxMultiJobsFlag": null,
"TxxDepTaxCreditAmt": null,
"TxxOtherIncomeAmt": null,
"TxxOtherDeductionAmt": null,
"TxxVUuid": "F2A4A14B8AB07A24E05316821FACC292",
"links": [
{
"rel": "self",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pytaxexm/F2A4A14B8AB07A24E05316821FACC292",
"name": "pytaxexm",
"kind": "item"
},
{
"rel": "canonical",
"href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pytaxexm/F2A4A14B8AB07A24E05316821FACC292",
"name": "pytaxexm",
"kind": "item"
}
]
}
```
object