openapi: 3.2.0
info:
  contact:
    name: Lavanya Appa
    email: LAVANYA.APPA@ADP.COM
  description: The ADP Workforce Now U.S. Tax Withholdings Application Programming Interface (API) enables users to add or change a worker's state tax withholding information. For more information refer U.S. State Tax Withholdings Guide for ADP Workforce Now.
  title: US Tax Profiles US State Tax Profile - Change State Income…
  version: 2.0.2
  x-apievangelist-source: https://api-library-marketplace.adp.com/hcm-offrg-wfn/payroll/us-tax-profiles/v2/us-tax-profiles-swagger_v2-merged.json
  x-apievangelist-product: ADP Workforce Now (hcm-offrg-wfn)
  x-apievangelist-resource-path: payroll/us-tax-profiles/v2/us-tax-profiles
servers:
- url: https://api.adp.com
  description: 'ADP production API gateway (mutual-TLS). Source: https://developers.adp.com/getting-started/key-concepts/access-tokens'
- url: https://api.eu.adp.com
  description: ADP European API gateway
- url: https://uat-api.adp.com
  description: ADP UAT / sandbox gateway
tags:
- name: US State Tax Profile - Change State Income Tax Instruction
  description: APIs to manage the change of a US tax profile state income tax instruction
paths:
  /events/payroll/v2/us-tax-profile.state-income-tax-instruction.change:
    x-adpPathData:
      uriTranslationIndicator: false
      featureCode: payrollInstructionManagement
      functionCode: taxProfileManagement
      serviceCode: payrollManagement
      serviceCategoryCode: payroll
      canonicalName: Change US Tax Profile State Income Tax Instruction
    post:
      summary: US State Tax Profile - Change State Income Tax Instruction
      x-adpOperationData:
        operationStateCode: active
        grantTypes:
        - authorization_code
        - urn:ietf:params:oauth:grant-type:saml2-bearer
        - urn:ietf:params:oauth:grant-type:jwt-bearer
        - client_credential
        asaFeatureCodes:
        - MobileESSUSTaxProfiles
        - MobilePSSUSTaxProfiles
        sorRequestTimeoutPolicies:
          cachedTimeout: 3
          notCachedTimeout: 10
        canonicalUri: payroll/payrollManagement/payrollInstructionManagement/taxProfileManagement/usTaxProfileStateIncomeTaxInstruction.change
        operationCode: usTaxProfileStateIncomeTaxInstruction.change
        operationId: 9b9b30c2-6c4d-4294-b428-d2f48d9840ae
        performAuthIndicator: true
        roleCodes:
        - employee
        - practitioner
        scenarios:
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 19. Illinois - Change number of basic allowance
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/19._Illinois_-_Change_number_of_basic_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494610.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/19._Illinois_-_Change_number_of_basic_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46051.json
        - summary: <div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 32. Unsuccessfull - Virginia - additionalTaxPercentage less than 1
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: "We will get error below message\n\"userMessage\": {\n                            \"messageTxt\": \"If the Additional Tax Type is Percentage, then the Additional Tax Amount value must be a percentage value of 1 to 99.\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/32._Unsuccessfull_-_Virginia_-_additionalTaxPercentage_less_than_1_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494623.json
          description: <div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/32._Unsuccessfull_-_Virginia_-_additionalTaxPercentage_less_than_1_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46064.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 18. Georgia - change additional allowance
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changes a new US tax profile state income tax instruction.
            content:
              application/json:
                externalValue: ./examples/18._Georgia_-_change_additional_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494609.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/18._Georgia_-_change_additional_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46050.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 15. Georgia - Successful response when all information is valid.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Change a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/15._Georgia_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494606.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/15._Georgia_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46047.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 12. Unsuccessful California when the additionalTax amount is empty.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: "We will get below error,\n\n\"userMessage\": {\n                            \"messageTxt\": \"Label not found, missing following key: No event data\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/12._Unsuccessful_California_when_the_additionalTax_amount_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494603.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/12._Unsuccessful_California_when_the_additionalTax_amount_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46044.json
        - summary: <p><span></span></p><div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div><p></p><div><button><i></i></button><br></div>
          name: 31. Virginia - Successful response when all information is valid.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/31._Virginia_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494622.json
          description: <p><span></span></p><div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div><p></p><div><button><i></i></button><br></div>
          content:
            application/json:
              externalValue: ./examples/31._Virginia_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46063.json
        - summary: This use case is to describe updating state tax profiles for all US state
          name: 08. Succesfull - California - Filing Status T
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/08._Succesfull_-_California_-_Filing_Status_T_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494599.json
          description: This use case is to describe updating state tax profiles for all US state
          content:
            application/json:
              externalValue: ./examples/08._Succesfull_-_California_-_Filing_Status_T_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46040.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 11. Successfull - California - change additional tax type to percentage
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/11._Successfull_-_California_-_change_additional_tax_type_to_percentage_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494602.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/11._Successfull_-_California_-_change_additional_tax_type_to_percentage_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46043.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 30. Ohio - change number of exemptions for dependents
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/30._Ohio_-_change_number_of_exemptions_for_dependents_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494621.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/30._Ohio_-_change_number_of_exemptions_for_dependents_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46062.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 26. New York - Successful response when all information is valid.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/26._New_York_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494617.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/26._New_York_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46058.json
        - summary: <p><span></span></p><div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div><p></p><div><button><i></i></button><br></div>
          name: 28. Ohio - change number of personal exemptions
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Change a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/28._Ohio_-_change_number_of_personal_exemptions_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494619.json
          description: <p><span></span></p><div><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div><p></p><div><button><i></i></button><br></div>
          content:
            application/json:
              externalValue: ./examples/28._Ohio_-_change_number_of_personal_exemptions_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46060.json
        - summary: <p><span><span>This use case is to describe updating state tax profiles for all US state.</span></span></p>
          name: 24. New Jersey - Successful response when all information is valid
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Change a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/24._New_Jersey_-_Successful_response_when_all_information_is_valid_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494615.json
          description: <p><span><span>This use case is to describe updating state tax profiles for all US state.</span></span></p>
          content:
            application/json:
              externalValue: ./examples/24._New_Jersey_-_Successful_response_when_all_information_is_valid_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46056.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 10. Successfull - California - change additional tax type to dollars
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/10._Successfull_-_California_-_change_additional_tax_type_to_dollars_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494601.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/10._Successfull_-_California_-_change_additional_tax_type_to_dollars_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46042.json
        - summary: This use case is to describe updating state tax profiles for all US state
          name: 06. Successfull - California - Filing Status S Single
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/06._Successfull_-_California_-_Filing_Status_S_Single_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494597.json
          description: This use case is to describe updating state tax profiles for all US state
          content:
            application/json:
              externalValue: ./examples/06._Successfull_-_California_-_Filing_Status_S_Single_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46038.json
        - summary: <span>Successful &ndash; Update Lived and Worked In States</span>
          name: 04. Successful – Update Lived and Worked In States
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Successful response when changing the LivedIn to workedIn
            content:
              application/json:
                externalValue: ./examples/04._Successful_–_Update_Lived_and_Worked_In_States_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494594.json
          description: <span>Successful &ndash; Update Lived and Worked In States</span>
          content:
            application/json:
              externalValue: ./examples/04._Successful_–_Update_Lived_and_Worked_In_States_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46035.json
        - summary: Unsuccessful response when the taxWithholdingStatus code is Invalid while adding sui state
          name: 03. Unsuccessful response when the taxWithholdingStatus code is Invalid while adding sui state
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: Unsuccessful response when the taxWithholdingStatus code is Invalid while adding sui state
            content:
              application/json:
                externalValue: ./examples/03._Unsuccessful_response_when_the_taxWithholdingStatus_code_is_Invalid_while_adding_sui_state_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494593.json
          description: Unsuccessful response when the taxWithholdingStatus code is Invalid while adding sui state
          content:
            application/json:
              externalValue: ./examples/03._Unsuccessful_response_when_the_taxWithholdingStatus_code_is_Invalid_while_adding_sui_state_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46034.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 29. Ohio - change number of personal exemptions for spouse
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/29._Ohio_-_change_number_of_personal_exemptions_for_spouse_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494620.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/29._Ohio_-_change_number_of_personal_exemptions_for_spouse_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46061.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 17. Georgia - changing dependent allowance
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Change a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/17._Georgia_-_changing_dependent_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494608.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/17._Georgia_-_changing_dependent_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46049.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 27. NorthCarolina - Successful response when all information is valid.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/27._NorthCarolina_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494618.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/27._NorthCarolina_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46059.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 16. Georgia - changing marital status allowance
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changes a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/16._Georgia_-_changing_marital_status_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494607.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/16._Georgia_-_changing_marital_status_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46048.json
        - summary: <span>Unsuccessful response when the&nbsp;</span><strong>associateID</strong><span>&nbsp;is Invalid while adding sui state</span>
          name: 02. Unsuccessful response when the associateID is Invalid while adding sui state
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: Unsuccessful response when the associateID is Invalid while adding sui state.
            content:
              application/json:
                externalValue: ./examples/02._Unsuccessful_response_when_the_associateID_is_Invalid_while_adding_sui_state_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494592.json
          description: <span>Unsuccessful response when the&nbsp;</span><strong>associateID</strong><span>&nbsp;is Invalid while adding sui state</span>
          content:
            application/json:
              externalValue: ./examples/02._Unsuccessful_response_when_the_associateID_is_Invalid_while_adding_sui_state_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46033.json
        - summary: <span>Successful response when the new&nbsp;</span><strong>SUI</strong><span>&nbsp;state is added.</span>
          name: 01. Successful response when the new SUI state is added.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Successful response when the new SUI state is added.
            content:
              application/json:
                externalValue: ./examples/01._Successful_response_when_the_new_SUI_state_is_added._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494591.json
          description: <span>Successful response when the new&nbsp;</span><strong>SUI</strong><span>&nbsp;state is added.</span>
          content:
            application/json:
              externalValue: ./examples/01._Successful_response_when_the_new_SUI_state_is_added._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46032.json
        - summary: This use case is to describe updating state tax profiles for all US state
          name: 09. Successfull - California - valid tax allowance
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/09._Successfull_-_California_-_valid_tax_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494600.json
          description: This use case is to describe updating state tax profiles for all US state
          content:
            application/json:
              externalValue: ./examples/09._Successfull_-_California_-_valid_tax_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46041.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 14. Unsuccessful response when the negativeValue passed in the taxAllowance field.
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: "We will get below error,\n\n\"userMessage\": {\n                            \"messageTxt\": \"Exemptions/Allowances is invalid.\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/14._Unsuccessful_response_when_the_negativeValue_passed_in_the_taxAllowance_field._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494605.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/14._Unsuccessful_response_when_the_negativeValue_passed_in_the_taxAllowance_field._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46046.json
        - summary: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          name: 13. Unsuccessful response when the filingStatus is empty.
          responses:
          - headers:
              ADP-Acting-Session-Expires: ''
              Cache-Control: ''
              sm_transactionid: ''
              ETag: ''
              ADP-Acting-SessionID: ''
              Content-Type: ''
            code: '400'
            description: "We will get below error for it,\n\n\"userMessage\": {\n                            \"messageTxt\": \"Code is invalid.\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/13._Unsuccessful_response_when_the_filingStatus_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494604.json
          description: <div data-hasbody="true" data-macro-name="note"><div><p>This use case is to describe updating state tax profiles for all US state.</p></div></div>
          content:
            application/json:
              externalValue: ./examples/13._Unsuccessful_response_when_the_filingStatus_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46045.json
        - summary: <p><span><span>This use case is to describe updating state tax profiles for all US state.</span></span></p><div><button><i></i></button><br></div>
          name: 23. Unsuccessfull - Michigan - taxAllowanceQuantity blank
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: "We are getting below error,\n\n\"userMessage\": {\n                            \"messageTxt\": \"Label not found, missing following key: No event data\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/23._Unsuccessfull_-_Michigan_-_taxAllowanceQuantity_blank_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494614.json
          description: <p><span><span>This use case is to describe updating state tax profiles for all US state.</span></span></p><div><button><i></i></button><br></div>
          content:
            application/json:
              externalValue: ./examples/23._Unsuccessfull_-_Michigan_-_taxAllowanceQuantity_blank_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46055.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 21. Unsuccessfull - Massachusetts - dollarTaxAmount:over999
          responses:
          - headers:
              ADP-Acting-Session-Expires: ''
              Cache-Control: ''
              sm_transactionid: ''
              ETag: ''
              ADP-Acting-SessionID: ''
              Content-Type: ''
            code: '400'
            description: "We will get below error ,\n\"userMessage\": {\n                            \"messageTxt\": \"If the Additional Tax Type is Dollars, then the Additional Tax Amount value must be a dollar amount of 1 to 999.\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/21._Unsuccessfull_-_Massachusetts_-_dollarTaxAmount:over999_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494612.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/21._Unsuccessfull_-_Massachusetts_-_dollarTaxAmount:over999_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46053.json
        - summary: <p><span></span></p><p><span><span>This use case is to describe updating state tax profiles for all US state</span></span></p><p></p>
          name: 25. Unsuccessfull - NewJersey - additionalTaxAmount - decimalValue
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: "We will get below message,\n\n\"userMessage\": {\n                            \"messageTxt\": \"Amount is invalid.\"\n                        }"
            content:
              application/json:
                externalValue: ./examples/25._Unsuccessfull_-_NewJersey_-_additionalTaxAmount_-_decimalValue_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494616.json
          description: <p><span></span></p><p><span><span>This use case is to describe updating state tax profiles for all US state</span></span></p><p></p>
          content:
            application/json:
              externalValue: ./examples/25._Unsuccessfull_-_NewJersey_-_additionalTaxAmount_-_decimalValue_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46057.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 20. Massachusetts- filingStatus-Married/Head of Household
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/20._Massachusetts-_filingStatus-Married/Head_of_Household_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494611.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/20._Massachusetts-_filingStatus-Married/Head_of_Household_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46052.json
        - summary: <span>This use case is to describe updating state tax profiles for all US state.</span>
          name: 22. Michigan - valid taxAllowanceQuantity
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Change a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/22._Michigan_-_valid_taxAllowanceQuantity_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494613.json
          description: <span>This use case is to describe updating state tax profiles for all US state.</span>
          content:
            application/json:
              externalValue: ./examples/22._Michigan_-_valid_taxAllowanceQuantity_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46054.json
        - summary: This use case is to describe updating state tax profiles for all US state
          name: 07. Successful - California - Filing Status M Married
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Changing a new US tax profile state income tax instruction
            content:
              application/json:
                externalValue: ./examples/07._Successful_-_California_-_Filing_Status_M_Married_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494598.json
          description: This use case is to describe updating state tax profiles for all US state
          content:
            application/json:
              externalValue: ./examples/07._Successful_-_California_-_Filing_Status_M_Married_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46039.json
        visibilityCodes:
        - internal
        - external
        globalViewDevPortalIndicator: true
      requestBody:
        description: posted contents
        content:
          application/json:
            schema:
              $ref: ./schemas/events_payroll.worker.usTaxProfile.stateIncomeTaxInstruction.change_schema_v02_00_rev001.json
        required: true
      responses:
        '200':
          headers:
            ADP-Acting-Session-Expires:
              schema:
                type: string
              description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            Cache-Control:
              schema:
                type: string
              description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
            sm_transactionid:
              schema:
                type: string
              description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            ETag:
              schema:
                type: string
              description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
            ADP-Acting-SessionID:
              schema:
                type: string
              description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            Content-Type:
              schema:
                type: string
              description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
          description: Change a new US tax profile state income tax instruction
          content:
            application/json:
              schema:
                $ref: ./schemas/events_payroll.worker.usTaxProfile.stateIncomeTaxInstruction.change_schema_v02_00_rev001.json
        '400':
          $ref: '#/components/responses/400'
        '412':
          $ref: '#/components/responses/412'
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
        '403':
          $ref: '#/components/responses/403'
        '503':
          $ref: '#/components/responses/503'
        '405':
          $ref: '#/components/responses/405'
        '504':
          $ref: '#/components/responses/504'
        '406':
          $ref: '#/components/responses/406'
        '429':
          $ref: '#/components/responses/429'
      description: Change a new US tax profile state income tax instruction
      operationId: 9b9b30c2-6c4d-4294-b428-d2f48d9840ae
      parameters:
      - schema:
          default: ''
          type: string
        in: header
        name: ConsumerAppOID
        description: Identifier for the service consumer application.  This header is required, if the actor (Service Consumer) is an application or the actor is internal to ADP
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SOR
        description: SOR where the call is routed to - usuall injected by the API proxy, with few exceptions
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: orgoid
        description: Organization OID of the requestor as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Act-As-AssociateOID
        description: Associate OID of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: employee
          type: string
          enum:
          - employee
          - ' manager'
          - ' practitioner'
          - ' administrator'
          - ' supervisor'
        in: header
        name: roleCode
        description: 'The role the user is playing during the transaction.  Possible values: employee,manager,practitioner,administrator,supervisor.  The roleCode header should be passed in all calls.'
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: true
      - schema:
          default: en-US
          type: string
        in: header
        name: Accept-Language
        description: 'Accept-Language'' '': '' ( language | ''*'' ) ['';'' ''q'' ''=''qvalue]. Specifies the language(s) that are acceptable for the response. The optional qvalue represents a quality level for acceptable languages.'
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Act-As-OrgOID
        description: Org OID for organization of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: Authorization
        description: Provides the client's authorization token to access the resource representation at a URI
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SORContext
        description: Context within an SOR that the call should be routed to
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Acting-SessionID
        description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: G4O73G9Z62SL2NFM
          type: string
        in: header
        name: associateoid
        description: Associate OID of the requestor as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: sm_user
        description: 'SiteMinder user ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_user: JJohns@Abc'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Consumer-ApplicationID
        description: Identifier of the application sending a request - not intended to be used as a correlation id for messages across systems participating in a collaboration
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_userdn
        description: 'SiteMinder user LDAP distinguished name.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_userdn: uid=JJohns@Abc,ou=Users,o=Abc'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-On-Behalf-Of-AssociateOID
        description: Associate OID for the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_auth_level
        description: 'SiteMinder autorization level.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_auth_level: 10'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_transactionid
        description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_serversessionid
        description: 'SiteMinder session ID.   Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_serversessionid: SoFpy8UMyhtXY6YsEumvXJbznFA='
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-On-Behalf-Of-OrgOID
        description: Org OID for organization of the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SORUri
        description: Actual Uri within the SOR
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Context-ExpressionID
        description: Geopolitical context, typically country, region, e.g. country=CA;subdivision=Quebec
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ISI
          type: string
        in: header
        name: realm
        description: The identity management realm, e.g. ISI
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      tags:
      - US State Tax Profile - Change State Income Tax Instruction
  /events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta:
    x-adpPathData:
      uriTranslationIndicator: false
      featureCode: payrollInstructionManagement
      functionCode: taxProfileManagement
      serviceCode: payrollManagement
      serviceCategoryCode: payroll
      canonicalName: Change US Tax Profile State Income Tax Instruction
    get:
      summary: US State Tax Profile - Change State Income Tax Instruction Meta
      x-adpOperationData:
        operationStateCode: active
        grantTypes:
        - authorization_code
        - urn:ietf:params:oauth:grant-type:saml2-bearer
        - urn:ietf:params:oauth:grant-type:jwt-bearer
        - client_credential
        asaFeatureCodes:
        - MobilePSSUSTaxProfiles
        - MobileESSUSTaxProfiles
        sorRequestTimeoutPolicies:
          cachedTimeout: 3
          notCachedTimeout: 10
        canonicalUri: payroll/payrollManagement/payrollInstructionManagement/taxProfileManagement/usTaxProfileStateIncomeTaxInstruction.change
        operationCode: usTaxProfileStateIncomeTaxInstruction.change
        operationId: 01f58827-dcf8-481b-9f73-1177c1610553
        performAuthIndicator: true
        roleCodes:
        - practitioner
        - employee
        scenarios:
        - summary: <p>Retrieving state income tax instruction change API meta. We can use below filter criteria to fetch meta response.</p><p><span data-offset-key="493tm-1-0"><span data-text="true">/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-2-0"><span data-text="true">{{pfID}}</span></span></span><span data-offset-key="493tm-3-0"><span data-text="true">&amp;state=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-4-0"><span data-text="true">{{stateCode}}</span></span></span></p><p><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-4-0"><span data-text="true"><span data-offset-key="cv5la-1-0"><span data-text="true">/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-2-0"><span data-text="true">{{pfID}}</span></span></span><span data-offset-key="cv5la-3-0"><span data-text="true">&amp;aoid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-4-0"><span data-text="true">{{employeeAOID}}</span></span></span><span data-offset-key="cv5la-5-0"><span data-text="true">&amp;state=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-6-0"><span data-text="true">{{stateCode}}</span></span></span></span></span></span></p>
          name: 01. Retrieving state income tax instruction change API meta
          responses:
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '200'
            description: Returns state income tax instruction change API meta
            content:
              application/json:
                externalValue: ./examples/01._Retrieving_state_income_tax_instruction_change_API_meta_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_200_494589.json
          - headers:
              ADP-Acting-Session-Expires: unset
              Cache-Control: unset
              sm_transactionid: unset
              ETag: unset
              ADP-Acting-SessionID: unset
              Content-Type: unset
            code: '400'
            description: 'Bad meta response when passing without state code


              /events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid={{pfID}}&aoid={{employeeAOID}}'
            content:
              application/json:
                externalValue: ./examples/01._Retrieving_state_income_tax_instruction_change_API_meta_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_400_494590.json
          description: <p>Retrieving state income tax instruction change API meta. We can use below filter criteria to fetch meta response.</p><p><span data-offset-key="493tm-1-0"><span data-text="true">/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-2-0"><span data-text="true">{{pfID}}</span></span></span><span data-offset-key="493tm-3-0"><span data-text="true">&amp;state=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-4-0"><span data-text="true">{{stateCode}}</span></span></span></p><p><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="493tm-4-0"><span data-text="true"><span data-offset-key="cv5la-1-0"><span data-text="true">/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-2-0"><span data-text="true">{{pfID}}</span></span></span><span data-offset-key="cv5la-3-0"><span data-text="true">&amp;aoid=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-4-0"><span data-text="true">{{employeeAOID}}</span></span></span><span data-offset-key="cv5la-5-0"><span data-text="true">&amp;state=</span></span><span data-testid="resolvedVariable" spellcheck="false"><span data-offset-key="cv5la-6-0"><span data-text="true">{{stateCode}}</span></span></span></span></span></span></p>
        visibilityCodes:
        - internal
        - external
        globalViewDevPortalIndicator: true
      responses:
        '200':
          headers:
            ADP-Acting-Session-Expires:
              schema:
                type: string
              description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            Cache-Control:
              schema:
                type: string
              description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
            sm_transactionid:
              schema:
                type: string
              description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            ETag:
              schema:
                type: string
              description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
            ADP-Acting-SessionID:
              schema:
                type: string
              description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
              x-adpParameterData:
                visibilityCodes:
                - internal
              required: false
            Content-Type:
              schema:
                type: string
              description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
              x-adpParameterData:
                visibilityCodes:
                - internal
                - external
              required: false
          description: Returns an event metadata
          content:
            application/json:
              schema:
                $ref: ./schemas/events_payroll.worker.usTaxProfile.stateIncomeTaxInstruction.change_meta_schema_v02_00_rev001.json
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '500':
          $ref: '#/components/responses/500'
        '412':
          $ref: '#/components/responses/412'
        '413':
          $ref: '#/components/responses/413'
        '304':
          $ref: '#/components/responses/304'
        '403':
          $ref: '#/components/responses/403'
        '503':
          $ref: '#/components/responses/503'
        '404':
          $ref: '#/components/responses/404'
        '504':
          $ref: '#/components/responses/504'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '429':
          $ref: '#/components/responses/429'
      description: Returns an event metadata
      operationId: 01f58827-dcf8-481b-9f73-1177c1610553
      parameters:
      - schema:
          default: ''
          type: string
        in: header
        name: ConsumerAppOID
        description: Identifier for the service consumer application.  This header is required, if the actor (Service Consumer) is an application or the actor is internal to ADP
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SOR
        description: SOR where the call is routed to - usuall injected by the API proxy, with few exceptions
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: orgoid
        description: Organization OID of the requestor as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Act-As-AssociateOID
        description: Associate OID of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: query
        name: $filter
        description: The OData $filter parameter MUST be used to specify the filter criterion.  Please refer RESTful Web API Design Standard document for this query parameter specification details.
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: false
      - schema:
          default: employee
          type: string
          enum:
          - employee
          - ' manager'
          - ' practitioner'
          - ' administrator'
          - ' supervisor'
        in: header
        name: roleCode
        description: 'The role the user is playing during the transaction.  Possible values: employee,manager,practitioner,administrator,supervisor.  The roleCode header should be passed in all calls.'
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: true
      - schema:
          default: en-US
          type: string
        in: header
        name: Accept-Language
        description: 'Accept-Language'' '': '' ( language | ''*'' ) ['';'' ''q'' ''=''qvalue]. Specifies the language(s) that are acceptable for the response. The optional qvalue represents a quality level for acceptable languages.'
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Act-As-OrgOID
        description: Org OID for organization of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: Authorization
        description: Provides the client's authorization token to access the resource representation at a URI
        x-adpParameterData:
          visibilityCodes:
          - internal
          - external
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SORContext
        description: Context within an SOR that the call should be routed to
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Acting-SessionID
        description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: G4O73G9Z62SL2NFM
          type: string
        in: header
        name: associateoid
        description: Associate OID of the requestor as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      - schema:
          default: ''
          type: string
        in: header
        name: sm_user
        description: 'SiteMinder user ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_user: JJohns@Abc'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Consumer-ApplicationID
        description: Identifier of the application sending a request - not intended to be used as a correlation id for messages across systems participating in a collaboration
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_userdn
        description: 'SiteMinder user LDAP distinguished name.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_userdn: uid=JJohns@Abc,ou=Users,o=Abc'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-On-Behalf-Of-AssociateOID
        description: Associate OID for the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_auth_level
        description: 'SiteMinder autorization level.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_auth_level: 10'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_transactionid
        description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: sm_serversessionid
        description: 'SiteMinder session ID.   Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_serversessionid: SoFpy8UMyhtXY6YsEumvXJbznFA='
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-On-Behalf-Of-OrgOID
        description: Org OID for organization of the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: SORUri
        description: Actual Uri within the SOR
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ''
          type: string
        in: header
        name: ADP-Context-ExpressionID
        description: Geopolitical context, typically country, region, e.g. country=CA;subdivision=Quebec
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: false
      - schema:
          default: ISI
          type: string
        in: header
        name: realm
        description: The identity management realm, e.g. ISI
        x-adpParameterData:
          visibilityCodes:
          - internal
        required: true
      tags:
      - US State Tax Profile - Change State Income Tax Instruction
components:
  responses:
    '429':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '406':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Not Acceptable
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '403':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '405':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Method Not Allowed
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '500':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '404':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Not Found
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '304':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Not Modified
    '400':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '503':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Service Unavailable
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '412':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Precondition Failed
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '504':
      description: Gateway Timeout
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
    '413':
      headers:
        ADP-Acting-Session-Expires:
          schema:
            type: string
          description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Cache-Control:
          schema:
            type: string
          description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        sm_transactionid:
          schema:
            type: string
          description: 'SiteMinder transaction ID.  Required for requests where conversation was initiated from a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        ETag:
          schema:
            type: string
          description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
        ADP-Acting-SessionID:
          schema:
            type: string
          description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
          x-adpParameterData:
            visibilityCodes:
            - internal
          required: false
        Content-Type:
          schema:
            type: string
          description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
          x-adpParameterData:
            visibilityCodes:
            - internal
            - external
          required: false
      description: Request Entity Too Large
      content:
        application/json:
          schema:
            $ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
x-adpSpecData:
  domain: Payroll
  specId: 1b535108-b9c3-4479-83e0-f716cf05bdb9
  canonicalSpecId: 7e5e38e8-bf27-4b0f-bff4-a2e53f849ea4
  specStatusCode: publishing
  specTypeCode: REST
  specStateCode: active
  nonStandardIndicator: false
  visibilityCodes:
  - internal
  - external
  filename: us-tax-profiles-swagger_v2-merged.json
  serviceProviderId: WFN
  resourcePath: payroll/us-tax-profiles/v2
  libraryVersion: ''
  businessRules:
  - rule: R5.0
    ruleTitle: Meta returns the context rules for each data section
    visibilityCodes:
    - internal
  - rule: R2.0
    ruleTitle: creationDateTime is the date that the event is created.  If a System of Record creates the event instance then it sets the creationDateTime.
    visibilityCodes:
    - internal
  - rule: R3.3
    ruleTitle: /data/output communicates the result of the event instance.
    visibilityCodes:
    - internal
  - rule: R11.1
    ruleTitle: '''associateoid'' in the uri pattern should match the ''associateoid'' in the request header parameter'
    visibilityCodes:
    - internal
  - rule: R3.1
    ruleTitle: /data/input is optional.  Input communicates data that is needed to complete recording the event instance.  An example is a benefits.enroll event.  The input communicates the benefitOfferings (the choices) that the user has to make which are communicated in the transform.
    visibilityCodes:
    - internal
  - rule: R6.1
    ruleTitle: An event instance which is being 'worked on' has an event.status.code=inprogress
    visibilityCodes:
    - internal
  - rule: R15.1
    ruleTitle: 'An SOR may return an HTTP 503 when they are down for a scheduled maintenance or for an outage.If an SOR is planning a maintenance window then they should plan on having an end point available to return the 503 with a standard confirmMessage.  The confirmMessage will contain a message stating the date and timeframe that the maintenance window is for.The SOR should return the Retry-After response-header field with the Date and Time when they expect the system to be available.  E.g. Retry-After: Fri, 31 Dec 1999 23:59:59 GMT  This does not need to be handled dynamically.  They can set the time that their maintenance window ends.'
    visibilityCodes:
    - internal
  - rule: R5.1
    ruleTitle: The only information that must be valued in the meta for the events header are the standard codelist references for priorityCode, eventStatusCode, and serviceCategoryCode
    visibilityCodes:
    - internal
  - rule: R2.4
    ruleTitle: If there is no effective date from a business perspective then the effective date should be set equal to the record date time.
    visibilityCodes:
    - internal
  - rule: R3.0
    ruleTitle: /data/schemaContext communicates the keys and properties that relate the event instance to a concrete concept (e.g. associate).
    visibilityCodes:
    - internal
  - rule: R0.2
    ruleTitle: If request contains ADP-On-Behalf-Of-OrgOID, ADP-On-Behalf-Of-AssociateOID and ADP-Acting-SessionID header values, SOR MUST use ADP-On-Behalf-Of-AssociateOID header value to authorize the data requested, NOT associateoid header value to authorize the data.
    visibilityCodes:
    - internal
  - rule: R2.2
    ruleTitle: The recordDateTime is the date time which the event is recorded in the system of record with an event.status.code=complete
    visibilityCodes:
    - internal
  - rule: R2.1
    ruleTitle: If the event is declared by an actor then the creationDateTime is the date time when the first call is made to the System of Record.
    visibilityCodes:
    - internal
  - rule: R3.2
    ruleTitle: /data/transform is only used during the recording of the event.  The transform is the data that is provided by a user/machine to complete the recording of the event.
    visibilityCodes:
    - internal
  - rule: R1.0
    ruleTitle: event.id is generated once an event is recorded with a event.status.code=complete
    visibilityCodes:
    - internal
  - rule: R0.3
    ruleTitle: 'For Act-As or On-Behalf-Of requests, header ''Cache-Control: no-store'' MUST be set to indicate on server or on UI the response object SHOULD not be cached'
    visibilityCodes:
    - internal
  - rule: R8.1
    ruleTitle: An event notification includes the /data/eventContext and /data/output objects.
    visibilityCodes:
    - internal
  - rule: R8.2
    ruleTitle: An event notification does not include the transform or meta objects.
    visibilityCodes:
    - internal
  - rule: R4.0
    ruleTitle: All envelope data is set by the System of Record (e.g. event.ID, creationDateTime, recordDateTime, event.status.code, etc...
    visibilityCodes:
    - internal
  - rule: R3.6
    ruleTitle: An event which is being recorded includes the /data/eventContext and the /data/transform during the composition phase (i.e. recording of the event).
    visibilityCodes:
    - internal
  - rule: R6.0
    ruleTitle: An event instance may be created by a System of record for a user to complete. This event instance will have a event.status.code=created
    visibilityCodes:
    - internal
  - rule: R0.1
    ruleTitle: If request contains ADP-Act-As-OrgOID, ADP-Act-As-AssociateOID and ADP-Acting-SessionID header values, SOR MUST use ADP-Act-As-AssociateOID header value to authorize the data requested, NOT associateoid header value to authorize the data.
    visibilityCodes:
    - internal
  - rule: R8.3
    ruleTitle: 'A self link is included in the /data/links with 1 links item with the following 2 properties: rel=''self'' href=''/events-notifications/{domain}/v1/{event-name}/{eventID}'''
    visibilityCodes:
    - internal
  - rule: R2.3
    ruleTitle: effectiveDateTime is the date that the event is effective from a business perspective
    visibilityCodes:
    - internal
  - rule: R3.5
    ruleTitle: A complete event has /data/eventContext and /data/output
    visibilityCodes:
    - internal
  - rule: R6.2
    ruleTitle: An event instance which has been recorded has an event.status.code=complete
    visibilityCodes:
    - internal
  - rule: R3.4
    ruleTitle: /data/output may be provided during the recording of the event showing the intermediary results.
    visibilityCodes:
    - internal
  testCaseCollection:
    example:
      href: WFN-CG_USStateTaxProfile.postman_collection.json
    description: Us state tax profile postman collection
  publicationContext:
    products:
    - productId: hcm-offrg-wfn
      productName: workforce now
      marketplaceProductName: ADP Workforce Now®
  specCategoryCode: ''