# 按工单获取工单相关信息
#### 操作场景
本章节指导用户通过调用API导入工单。
#### 前提条件
- 已开通数字化制造云平台（MBM Space），并根据开通区域确定调用API的Endpoint，详细信息请参见[地区与终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint)。
  ![](https://support.huaweicloud.com/api-craftartsipdcenter/public_sys-resources/note_3.0-zh-cn.png)
  假设数字化制造云平台的访问网址为https://ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx#/xxxxxx，则调用数字化制造云平台的API的Endpoint为访问网址中的ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx，即"https://"后至"#"前的内容。
  
- 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加"X-Auth-Token"到业务接口请求消息头中。Token认证，具体操作请参考[认证鉴权](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0010.html)。
  ![](https://support.huaweicloud.com/api-craftartsipdcenter/public_sys-resources/note_3.0-zh-cn.png)
  通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。
  
 
#### 操作步骤
1. 获取接口相关信息。 
   URI格式：POST /wom/openapi/v1/wos/wo-info
   详情请参见[按工单获取工单相关信息](https://support.huaweicloud.com/api-craftartsipdcenter/SearchWoInfo.html)。
   
   
2. 在Request Header中增加"X-Auth-Token"。
3. 发送"POST https://{MBM Endpoint}/wom/openapi/v1/wos/wo-info"。 
   Body
   ```
   [ {
     "wo_id" : "1574698325467510369",
     "wo_order" : "WOP123456"
   } ]
   ```
   
   
4. 查看请求响应结果。 
   请求成功时，响应参数如下：
   ```
   {
     "status" : "200",
     "message" : "success",
      "data" : [ {
       "wo_id" : "1574698325467510369",
       "wo_order" : "WOP123456",
       "erp_wo_id" : "1457698771257845",
       "erp_wo_order" : "QWERTYUI",
       "parent_wo_id" : "1478932452572618",
       "parent_wo_order" : "WOP147369",
       "wo_type" : "10",
       "part_id" : "1564789221484123",
       "part_no" : "TEST2023",
       "part_desc" : "MODEL测试",
       "part_revision" : "1",
       "lot_unit" : 1,
       "wo_qty" : 100,
       "site_id" : "22DF4572394G485KF502",
       "site_no" : "TEST210213",
       "completed_qty" : 1,
       "wo_status" : "10",
       "hold_flag" : "0",
       "split_flag" : "1",
       "solution_flag" : "2",
       "sn_generate_flag" : "0",
       "erp_plan_start_date" : "2023-08-14 00:00:00",
       "erp_plan_end_date" : "2023-08-14 00:00:00",
       "data_source" : "MANUAL",
       "actual_wo_start_date" : "2023-08-14 00:00:00",
       "actual_wo_complete_date" : "2023-08-14 00:00:00",
       "org_id" : "1"
     } ]
   }
   ```
   请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。