如何通过Workday SOAP API获取指定状态的项目？

Workday SOAP API筛选指定状态项目的解决方案 #

首先明确：Workday里项目状态归属于「文档状态」体系，所以API要求用Document_Status_ID或WID是正常逻辑，无需纠结命名。

1. 获取系统有效的状态ID/WID

你之前使用的ACTIVE、ACTIVE_TIME_ONLY等ID无效，是因为Workday租户的文档状态ID可能存在自定义，或你用的不是系统标准值。获取准确值的两种方式：

• 后台操作：登录Workday，打开**查看文档状态（View Document Statuses）**报告，筛选项目相关状态，即可看到对应的Document_Status_ID和WID；
• API调用：通过Get_Document_Statuses接口请求所有文档状态，从中筛选项目类的状态条目。

2. 多状态筛选的正确请求格式

要同时获取多种状态的项目，需在Request_Criteria下添加多个Project_Status_Reference节点，每个节点对应一个状态的ID或WID，Workday会按OR逻辑返回符合任一状态的项目。

以下是示例请求（假设已确认正确的Document_Status_ID为PROPOSED、ACTIVE、ACTIVE_EXPENSES_ONLY、ACTIVE_TIME_ONLY）：

<soapenv:Envelope xmlns:bsvc="urn:com.workday/bsvc" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header>
      <bsvc:Workday_Common_Header>
         <bsvc:Include_Reference_Descriptors_In_Response>true</bsvc:Include_Reference_Descriptors_In_Response>
      </bsvc:Workday_Common_Header>
   </soapenv:Header>
   <soapenv:Body>
    <bsvc:Get_Projects_Request xmlns:bsvc="urn:com.workday/bsvc" bsvc:version="v49.0">
        
        <bsvc:Request_Criteria>
            <!-- 状态：Proposed -->
            <bsvc:Project_Status_Reference>
                <bsvc:ID bsvc:type="Document_Status_ID">PROPOSED</bsvc:ID>
            </bsvc:Project_Status_Reference>
            <!-- 状态：Active -->
            <bsvc:Project_Status_Reference>
                <bsvc:ID bsvc:type="Document_Status_ID">ACTIVE</bsvc:ID>
            </bsvc:Project_Status_Reference>
            <!-- 状态：Active - Expenses Only -->
            <bsvc:Project_Status_Reference>
                <bsvc:ID bsvc:type="Document_Status_ID">ACTIVE_EXPENSES_ONLY</bsvc:ID>
            </bsvc:Project_Status_Reference>
            <!-- 状态：Active - Time Only -->
            <bsvc:Project_Status_Reference>
                <bsvc:ID bsvc:type="Document_Status_ID">ACTIVE_TIME_ONLY</bsvc:ID>
            </bsvc:Project_Status_Reference>
        </bsvc:Request_Criteria>
        <bsvc:Response_Filter>
            <bsvc:Page>1</bsvc:Page>
        </bsvc:Response_Filter>
    </bsvc:Get_Projects_Request>
   </soapenv:Body>
</soapenv:Envelope>

3. 常见问题排查

• WID报错：确认WID是文档状态的WID，而非项目本身的WID；Workday WID为32位字符串，不要输入状态名称（比如Active - Expenses Only不是WID）；
• ID无返回：检查ID和系统值完全一致（区分大小写），或确认该状态下存在项目；
• 不要留空version：指定正确的API版本号（如v49.0），避免兼容性问题。

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