Create a PY Tax Exemption
    • 27 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