openapi: 3.0.1 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 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 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 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: '' tags: - name: US State Tax Profile - Add State Income Tax Instruction description: APIs to manage the addition of a US tax profile state income tax instruction - 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.add: x-adpPathData: uriTranslationIndicator: false featureCode: payrollInstructionManagement functionCode: taxProfileManagement serviceCode: payrollManagement serviceCategoryCode: payroll canonicalName: Add US Tax Profile State Income Tax Instruction post: summary: US State Tax Profile - Add 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.add operationCode: usTaxProfileStateIncomeTaxInstruction.add operationId: e9e17835-005b-4555-91e7-e5f03838cb9c performAuthIndicator: true roleCodes: - employee - practitioner scenarios: - summary: Adding New Jersey as the workedIn state. name: 15. Add New Jersey as the workedIn state. 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: Response of Adding New Jersey as the workedIn state. content: application/json: externalValue: ./examples/15._Add_New_Jersey_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494580.json description: Adding New Jersey as the workedIn state. content: application/json: externalValue: ./examples/15._Add_New_Jersey_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46024.json - summary: Adding California as the workedIn state. name: 01.Add California as the workedIn state. 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 adding California as the workedIn state. content: application/json: externalValue: ./examples/01.Add_California_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494566.json description: Adding California as the workedIn state. content: application/json: externalValue: ./examples/01.Add_California_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46010.json - summary: Adding Massachusetts as the livedIn state. name: 20. Add Massachusetts as the livedIn state. 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: Response of Adding Massachusetts as the livedIn state. content: application/json: externalValue: ./examples/20._Add_Massachusetts_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494585.json description: Adding Massachusetts as the livedIn state. content: application/json: externalValue: ./examples/20._Add_Massachusetts_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46029.json - summary: Adding California as the LivedIn state. name: 02. Add California as the livedIn state. 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 adding California as the LivedIn state. content: application/json: externalValue: ./examples/02._Add_California_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494567.json description: Adding California as the LivedIn state. content: application/json: externalValue: ./examples/02._Add_California_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46011.json - summary: Adding Massachusetts as the workedIn state. name: 19. Add Massachusetts as the workedIn state. 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: Response of Adding Massachusetts as the workedIn state. content: application/json: externalValue: ./examples/19._Add_Massachusetts_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494584.json description: Adding Massachusetts as the workedIn state. content: application/json: externalValue: ./examples/19._Add_Massachusetts_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46028.json - summary: Add Illinois as the workedIn state. name: 07. Add Illinois as the workedIn state. 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: Response of adding Illinois as the workedIn state. content: application/json: externalValue: ./examples/07._Add_Illinois_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494572.json description: Add Illinois as the workedIn state. content: application/json: externalValue: ./examples/07._Add_Illinois_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46016.json - summary: Adding Michigan as the livedIn state. name: 22. Add Michigan as the livedIn state. 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: Response of Adding Michigan as the livedIn state. content: application/json: externalValue: ./examples/22._Add_Michigan_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494587.json description: Adding Michigan as the livedIn state. content: application/json: externalValue: ./examples/22._Add_Michigan_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46031.json - summary: Adding NewYork as the workedIn state. name: 05. Add NewYork as the workedIn state. 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: Response of Adding NewYork as the workedIn state. content: application/json: externalValue: ./examples/05._Add_NewYork_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494570.json description: Adding NewYork as the workedIn state. content: application/json: externalValue: ./examples/05._Add_NewYork_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46014.json - summary: Adding Virginia as the livedIn state. name: 18. Add Virginia as the livedIn state. 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: Response of Adding Virginia as the livedIn state. content: application/json: externalValue: ./examples/18._Add_Virginia_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494583.json description: Adding Virginia as the livedIn state. content: application/json: externalValue: ./examples/18._Add_Virginia_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46027.json - summary: Adding Invalid state code name: 03. Add Invalid state code 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 of adding invalid state code content: application/json: externalValue: ./examples/03._Add_Invalid_state_code_Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_400_494568.json description: Adding Invalid state code content: application/json: externalValue: ./examples/03._Add_Invalid_state_code_Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46012.json - summary: Adding NewYork as the livedIn state. name: 06. Add NewYork as the livedIn state. 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: Response of Adding NewYork as the livedIn state. content: application/json: externalValue: ./examples/06._Add_NewYork_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494571.json description: Adding NewYork as the livedIn state. content: application/json: externalValue: ./examples/06._Add_NewYork_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46015.json - summary: Add Illinois as the livedIn state. name: 08. Add Illinois as the livedIn state. 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: Response of Adding Illinois as the livedIn state. content: application/json: externalValue: ./examples/08._Add_Illinois_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494573.json description: Add Illinois as the livedIn state. content: application/json: externalValue: ./examples/08._Add_Illinois_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46017.json - summary: Adding invalid itemid name: 04. Add invalid itemID 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 of adding invalid itemId content: application/json: externalValue: ./examples/04._Add_invalid_itemID_Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_400_494569.json description: Adding invalid itemid content: application/json: externalValue: ./examples/04._Add_invalid_itemID_Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46013.json - summary: Adding North Carolina as the workedIn state. name: 13. Add North Carolina as the workedIn state. 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: Response of Adding North Carolina as the workedIn state. content: application/json: externalValue: ./examples/13._Add_North_Carolina_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494578.json description: Adding North Carolina as the workedIn state. content: application/json: externalValue: ./examples/13._Add_North_Carolina_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46022.json - summary: Adding Ohio as the workedIn state. name: 09. Add Ohio as the workedIn state. 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: Response of Adding Ohio as the workedIn state. content: application/json: externalValue: ./examples/09._Add_Ohio_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494574.json description: Adding Ohio as the workedIn state. content: application/json: externalValue: ./examples/09._Add_Ohio_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46018.json - summary: Adding Michigan as the workedIn state. name: 21.Add Michigan as the workedIn state. 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: Response of Adding Michigan as the workedIn state. content: application/json: externalValue: ./examples/21.Add_Michigan_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494586.json description: Adding Michigan as the workedIn state. content: application/json: externalValue: ./examples/21.Add_Michigan_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46030.json - summary: Adding North Carolina as the livedIn state. name: 14. Add North Carolina as the livedIn state. 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: Response of Adding North Carolina as the livedIn state. content: application/json: externalValue: ./examples/14._Add_North_Carolina_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494579.json description: Adding North Carolina as the livedIn state. content: application/json: externalValue: ./examples/14._Add_North_Carolina_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46023.json - summary: New description scenario for the consumer of this API to better understand this example. name: 12. Add Georgia as the livedIn state. 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: Response of Adding Georgia as the livedIn state. content: application/json: externalValue: ./examples/12._Add_Georgia_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494577.json description: New description scenario for the consumer of this API to better understand this example. content: application/json: externalValue: ./examples/12._Add_Georgia_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46021.json - summary: Add any state as livedin and workedin. name: 23. Add any state as livedin and workedin. 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: Response of Adding any state as livedin and workedin. content: application/json: externalValue: ./examples/23._Add_any_state_as_livedin_and_workedin._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494595.json description: Add any state as livedin and workedin. content: application/json: externalValue: ./examples/23._Add_any_state_as_livedin_and_workedin._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46036.json - summary: Adding Virginia as the workedIn state. name: 17. Add Virginia as the workedIn state. 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: Response of Adding Virginia as the workedIn state. content: application/json: externalValue: ./examples/17._Add_Virginia_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494582.json description: Adding Virginia as the workedIn state. content: application/json: externalValue: ./examples/17._Add_Virginia_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46026.json - summary: Adding Ohio as the livedIn state. name: 10. Add Ohio as the livedIn state. 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: Response of Adding Ohio as the livedIn state. content: application/json: externalValue: ./examples/10._Add_Ohio_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494575.json description: Adding Ohio as the livedIn state. content: application/json: externalValue: ./examples/10._Add_Ohio_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46019.json - summary: Adding Georgia as the workedIn state. name: 11. Add Georgia as the workedIn state. 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: Response of Adding Georgia as the workedIn state. content: application/json: externalValue: ./examples/11._Add_Georgia_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494576.json description: Adding Georgia as the workedIn state. content: application/json: externalValue: ./examples/11._Add_Georgia_as_the_workedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46020.json - summary: Adding New Jersey as the livedIn state. name: 16. Adding New Jersey as the livedIn state. 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: Response of Adding New Jersey as the livedIn state. content: application/json: externalValue: ./examples/16._Adding_New_Jersey_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494581.json description: Adding New Jersey as the livedIn state. content: application/json: externalValue: ./examples/16._Adding_New_Jersey_as_the_livedIn_state._Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_request_46025.json visibilityCodes: - internal - external globalViewDevPortalIndicator: true requestBody: description: posted contents content: application/json: schema: $ref: ./schemas/events_payroll.worker.usTaxProfile.stateIncomeTaxInstruction.add_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: Add a new US tax profile state income tax instruction content: application/json: schema: $ref: ./schemas/events_payroll.worker.usTaxProfile.stateIncomeTaxInstruction.add_schema_v02_00_rev001.json '201': description: accepted content: application/json: {} '400': $ref: '#/components/responses/400' '500': $ref: '#/components/responses/500' '401': $ref: '#/components/responses/401' '412': $ref: '#/components/responses/412' '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: Add a new US tax profile state income tax instruction operationId: e9e17835-005b-4555-91e7-e5f03838cb9c 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 - Add State Income Tax Instruction /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: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/19._Illinois_-_Change_number_of_basic_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46051.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/32._Unsuccessfull_-_Virginia_-_additionalTaxPercentage_less_than_1_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46064.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/18._Georgia_-_change_additional_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46050.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/15._Georgia_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46047.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/12._Unsuccessful_California_when_the_additionalTax_amount_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46044.json - summary:

This use case is to describe updating state tax profiles for all US state.


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:

This use case is to describe updating state tax profiles for all US state.


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: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/11._Successfull_-_California_-_change_additional_tax_type_to_percentage_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46043.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/30._Ohio_-_change_number_of_exemptions_for_dependents_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46062.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/26._New_York_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46058.json - summary:

This use case is to describe updating state tax profiles for all US state.


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:

This use case is to describe updating state tax profiles for all US state.


content: application/json: externalValue: ./examples/28._Ohio_-_change_number_of_personal_exemptions_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46060.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/24._New_Jersey_-_Successful_response_when_all_information_is_valid_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46056.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. 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: Successful – Update Lived and Worked In States 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: Successful – Update Lived and Worked In States 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:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/29._Ohio_-_change_number_of_personal_exemptions_for_spouse_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46061.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/17._Georgia_-_changing_dependent_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46049.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/27._NorthCarolina_-_Successful_response_when_all_information_is_valid._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46059.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/16._Georgia_-_changing_marital_status_allowance_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46048.json - summary: Unsuccessful response when the associateID is Invalid while adding sui state 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: 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_request_46033.json - summary: Successful response when the new SUI state is added. 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: 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_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: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/14._Unsuccessful_response_when_the_negativeValue_passed_in_the_taxAllowance_field._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46046.json - summary:

This use case is to describe updating state tax profiles for all US state.

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:

This use case is to describe updating state tax profiles for all US state.

content: application/json: externalValue: ./examples/13._Unsuccessful_response_when_the_filingStatus_is_empty._Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46045.json - summary:

This use case is to describe updating state tax profiles for all US state.


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:

This use case is to describe updating state tax profiles for all US state.


content: application/json: externalValue: ./examples/23._Unsuccessfull_-_Michigan_-_taxAllowanceQuantity_blank_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46055.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/21._Unsuccessfull_-_Massachusetts_-_dollarTaxAmount:over999_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46053.json - summary:

This use case is to describe updating state tax profiles for all US state

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:

This use case is to describe updating state tax profiles for all US state

content: application/json: externalValue: ./examples/25._Unsuccessfull_-_NewJersey_-_additionalTaxAmount_-_decimalValue_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46057.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. content: application/json: externalValue: ./examples/20._Massachusetts-_filingStatus-Married/Head_of_Household_Custom_Example_usTaxProfileStateIncomeTaxInstruction.change_request_46052.json - summary: This use case is to describe updating state tax profiles for all US state. 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: This use case is to describe updating state tax profiles for all US state. 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.add/meta: x-adpPathData: uriTranslationIndicator: false featureCode: payrollInstructionManagement functionCode: taxProfileManagement serviceCode: payrollManagement serviceCategoryCode: payroll canonicalName: Add US Tax Profile State Income Tax Instruction get: summary: US State Tax Profile - Add 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: - MobileESSUSTaxProfiles - MobilePSSUSTaxProfiles sorRequestTimeoutPolicies: cachedTimeout: 3 notCachedTimeout: 10 canonicalUri: payroll/payrollManagement/payrollInstructionManagement/taxProfileManagement/usTaxProfileStateIncomeTaxInstruction.add operationCode: usTaxProfileStateIncomeTaxInstruction.add operationId: 62fc3ab7-fa4d-49d2-9fd9-07c3a0f9f9db performAuthIndicator: true roleCodes: - employee - practitioner scenarios: - summary:

Retrieving state income tax instruction add API meta. We can use below filter criteria to fetch meta response.

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&aoid={{employeeAOID}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&state={{stateCode}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&aoid={{employeeAOID}}&state={{stateCode}}

name: 01. Retrieving state income tax instruction add 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 add API meta. content: application/json: externalValue: ./examples/01._Retrieving_state_income_tax_instruction_add_API_meta_Custom_Example_usTaxProfileStateIncomeTaxInstruction.add_200_494588.json description:

Retrieving state income tax instruction add API meta. We can use below filter criteria to fetch meta response.

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&aoid={{employeeAOID}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&state={{stateCode}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.add/meta?pfid={{pfID}}&aoid={{employeeAOID}}&state={{stateCode}}

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.add_meta_schema_v02_00_rev001.json '400': $ref: '#/components/responses/400' '412': $ref: '#/components/responses/412' '500': $ref: '#/components/responses/500' '401': $ref: '#/components/responses/401' '413': $ref: '#/components/responses/413' '403': $ref: '#/components/responses/403' '304': $ref: '#/components/responses/304' '503': $ref: '#/components/responses/503' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '504': $ref: '#/components/responses/504' '406': $ref: '#/components/responses/406' '429': $ref: '#/components/responses/429' description: Returns an event metadata operationId: 62fc3ab7-fa4d-49d2-9fd9-07c3a0f9f9db 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 - Add 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:

Retrieving state income tax instruction change API meta. We can use below filter criteria to fetch meta response.

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid={{pfID}}&state={{stateCode}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid={{pfID}}&aoid={{employeeAOID}}&state={{stateCode}}

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:

Retrieving state income tax instruction change API meta. We can use below filter criteria to fetch meta response.

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid={{pfID}}&state={{stateCode}}

/events/payroll/v2/us-tax-profile.state-income-tax-instruction.change/meta?pfid={{pfID}}&aoid={{employeeAOID}}&state={{stateCode}}

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: '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 '401': description: Unauthorized 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 '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 '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 '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 '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 '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 '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 '504': description: Gateway Timeout 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 '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 '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