咨询Workday用于获取/设置员工直接存款信息的SOAP API端点

Hey there! I’ve worked with Workday’s payroll-related APIs before, so let me break down the endpoints you need for managing direct deposit info:

Retrieving Direct Deposit Details #

To fetch a worker’s direct deposit information, use the Get_Worker SOAP operation. The critical step here is specifying the Payment_Information_Response_Group in your request — this tells Workday to include all payment-related data (including direct deposit accounts) in the response.

You’ll need to pass the worker’s unique reference (like their Employee ID or Worker ID) and explicitly include this response group in the request body. A simplified SOAP payload example looks like:

<wd:Get_Worker_Request>
  <wd:Worker_Reference>
    <wd:ID wd:type="Employee_ID">12345</wd:ID>
  </wd:Worker_Reference>
  <wd:Response_Group>
    <wd:Payment_Information_Response_Group/>
  </wd:Response_Group>
</wd:Get_Worker_Request>

Creating/Updating Direct Deposit Info #

To set or modify a worker’s direct deposit details, use the Maintain_Worker_Payment_Information SOAP operation. This endpoint supports all core direct deposit actions:

• Adding new direct deposit accounts
• Updating existing account details (routing number, account type, allocation percentage, etc.)
• Setting account priority (for split deposit scenarios)
• Removing direct deposit accounts

Your request will need the worker reference plus the payment information structure with your desired changes. Here’s a basic example for adding a new checking account:

<wd:Maintain_Worker_Payment_Information_Request>
  <wd:Worker_Reference>
    <wd:ID wd:type="Employee_ID">12345</wd:ID>
  </wd:Worker_Reference>
  <wd:Payment_Information_Data>
    <wd:Direct_Deposit_Account_Data>
      <wd:Account_Type_Reference>
        <wd:ID wd:type="Account_Type_Code">CHECKING</wd:ID>
      </wd:Account_Type_Reference>
      <wd:Routing_Number>123456789</wd:Routing_Number>
      <wd:Account_Number>987654321</wd:Account_Number>
      <wd:Allocation_Type_Reference>
        <wd:ID wd:type="Allocation_Type_Code">PERCENTAGE</wd:ID>
      </wd:Allocation_Type_Reference>
      <wd:Allocation_Percentage>100.0</wd:Allocation_Percentage>
      <wd:Priority>1</wd:Priority>
    </wd:Direct_Deposit_Account_Data>
  </wd:Payment_Information_Data>
</wd:Maintain_Worker_Payment_Information_Request>

Why You Might Have Missed These #

These operations aren’t labeled with "Direct Deposit" directly in the API directory, which is why they’re easy to overlook:

• Get_Worker is grouped under the Worker Management section
• Maintain_Worker_Payment_Information lives in the Payroll section

Also, double-check that your API service user has the required security permissions (like View Worker Payment Information or Maintain Worker Payment Information) to access these endpoints.

内容的提问来源于stack exchange，提问作者Osama Ejaz