Create a PY Tax Exemption
  • 12 Feb 2025
  • 1 Minute to read
  • Dark
    Light

Create a PY Tax Exemption

  • Dark
    Light

Article summary

Post
/hcm-rest-api/rest/1/pytaxexm

Create Tax Exemptions

Security
HTTP
Type basic

Basic authentication

Header parameters
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourceItem+json
Body parameters
object
Example{ "TxxEmpNo": "805", "TxxStateCode": "ALL", "TxxEffectiveDate": "2022-01-19", "TxxWrlCode": "ALL", "TxxLastUpdDate": "2022-01-19T12:42:15-05:00", "TxxFilingStatus": "01", "TxxUser": "ARCORO", "TxxVUuid": "" }
TxxEffectiveDate
string Required
TxxWrlCode
string Required

Work location code. (ALL for state level tax)

Max length15
TxxFilingStatus
string Required

Filing Status of employee for Taxation purpose

Max length2
TxxVUuid
string Required

Unique uuid of row

Max length64
TxxEmpNo
string Required

The unique identifier of an employee

Max length16
TxxLastUpdDate
string Required

Date and Time stamp of the last update

TxxStateCode
string Required
Max length4
TxxUser
string Required

The name of the user who made the last update

Max length30
TxxOtherDeductionAmt
number

Federal W4-form field introduced in 2020 indicating other deductions amount for the year.

Max length11
TxxNrCertificate
string

NR Certificate provided Y/N

Max length1
TxxPrimWorkLocCode
string

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
TxxSuplExpAmount
number

Supplementary Exemption amount

Max length18
TxxTenantId
string

Tenant ID, Leave Blank

Max length30
TxxDepTaxCreditAmt
number

Federal W4-form field introduced in 2020 indicating dependents and other tax credits for the year.

Max length11
TxxOtherIncomeAmt
number

Federal W4-form field introduced in 2020 indicating other non-wage income for the year.

Max length11
TxxSecnExemp
number

Number of Secondry Exemptions

Max length2
TxxMultiJobsFlag
string

Federal W4-form field introduced in 2020 indicating if employee work multiple jobs (Y/N/null).

Max length1
TxxExempAmount
number

Exemption Amount

Max length18
TxxPrimExemp
number

Number of Primary Exemptions

Max length2
TxxTertExemp
number

Number of Tertairy Exemptions

Max length2
TxxResidenceLocCode
string

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
Responses
201

Created

Headers
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourceitem+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