# 按工单获取工单相关信息 - SearchWoInfo #### 功能介绍 获取工单相关信息 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-craftartsipdcenter/ipdcenter_06_0034.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /wom/openapi/v1/wos/wo-info #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | \[数组元素\] | 否 | Array of [OpenWoInfo] objects | 工单信息 | 表2OpenWoInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | rdmExtensionType | 否 | String | 实体名称 | | extendDimension | 否 | String | 扩展维度 | | extAttrs | 否 | Array of [ExtendValueParamOpenDto] objects | 扩展字段列表 | | wo_id | 否 | String | 工单ID | | wo_order | 否 | String | 工单号 | | erp_wo_id | 否 | String | ERP工单ID | | erp_wo_order | 否 | String | ERP工单号 | | parent_wo_id | 否 | String | 父项工单ID | | parent_wo_order | 否 | String | 父项工单号 | | wo_type | 否 | String | 工单类型 - 10：生产工单 - 20：返工工单 - 30：预加工工单 | | part_id | 否 | String | 产品编码ID | | part_no | 否 | String | 产品编码 | | part_desc | 否 | String | 产品描述 | | part_revision | 否 | String | 版本 | | lot_unit | 否 | Integer | 产品单LOT批量 | | wo_qty | 否 | Integer | 工单批量 | | site_id | 否 | String | 加工区域ID | | site_no | 否 | String | 加工区域代码 | | completed_qty | 否 | Integer | 完工数量 | | wo_status | 否 | String | 工单状态 - 10：初始化 - 20：已排产 - 30：已下发 - 40：开始生产 - 50：工单完工 - 60：工单关闭 - 10000：已取消 | | hold_flag | 否 | String | 冻结标识（默认为0） - 0：正常 - 1：冻结 | | split_flag | 否 | String | 预加工单拆分标识（默认为0） - 0：初始化 - 1：拆分成功 - 2：拆分失败 | | solution_flag | 否 | String | 工单方案生成标识（默认为0） - 0：初始化 - 1：生成成功 - 2：生成失败 - 3：实例化成功 - 4：实例化失败 - 8：生成中 - 9：实例化中 | | sn_generate_flag | 否 | String | SN展开标识（默认为0） - 0：初始化 - 1：生成成功 - 2：生成失败 | | erp_plan_start_date | 否 | String | ERP计划开工时间 | | erp_plan_end_date | 否 | String | ERP计划完工时间 | | data_source | 否 | String | 数据来源 | | actual_wo_start_date | 否 | String | 工单实际开工时间 | | actual_wo_complete_date | 否 | String | 工单实际完工时间 | | org_id | 否 | String | 组织号ID | | customer_id | 否 | String | 客户ID | | customer_code | 否 | String | 客户编码 | | customer_name | 否 | String | 客户名称 | 表3ExtendValueParamOpenDto | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | 字段名称 | | value | 否 | Object | 字段值 | | type | 否 | String | 字段类型 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | \[数组元素\] | Array of [OpenWoInfo] objects | 工单信息 | 表5OpenWoInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rdmExtensionType | String | 实体名称 | | extendDimension | String | 扩展维度 | | extAttrs | Array of [ExtendValueParamOpenDto] objects | 扩展字段列表 | | wo_id | String | 工单ID | | wo_order | String | 工单号 | | erp_wo_id | String | ERP工单ID | | erp_wo_order | String | ERP工单号 | | parent_wo_id | String | 父项工单ID | | parent_wo_order | String | 父项工单号 | | wo_type | String | 工单类型 - 10：生产工单 - 20：返工工单 - 30：预加工工单 | | part_id | String | 产品编码ID | | part_no | String | 产品编码 | | part_desc | String | 产品描述 | | part_revision | String | 版本 | | lot_unit | Integer | 产品单LOT批量 | | wo_qty | Integer | 工单批量 | | site_id | String | 加工区域ID | | site_no | String | 加工区域代码 | | completed_qty | Integer | 完工数量 | | wo_status | String | 工单状态 - 10：初始化 - 20：已排产 - 30：已下发 - 40：开始生产 - 50：工单完工 - 60：工单关闭 - 10000：已取消 | | hold_flag | String | 冻结标识（默认为0） - 0：正常 - 1：冻结 | | split_flag | String | 预加工单拆分标识（默认为0） - 0：初始化 - 1：拆分成功 - 2：拆分失败 | | solution_flag | String | 工单方案生成标识（默认为0） - 0：初始化 - 1：生成成功 - 2：生成失败 - 3：实例化成功 - 4：实例化失败 - 8：生成中 - 9：实例化中 | | sn_generate_flag | String | SN展开标识（默认为0） - 0：初始化 - 1：生成成功 - 2：生成失败 | | erp_plan_start_date | String | ERP计划开工时间 | | erp_plan_end_date | String | ERP计划完工时间 | | data_source | String | 数据来源 | | actual_wo_start_date | String | 工单实际开工时间 | | actual_wo_complete_date | String | 工单实际完工时间 | | org_id | String | 组织号ID | | customer_id | String | 客户ID | | customer_code | String | 客户编码 | | customer_name | String | 客户名称 | 表6ExtendValueParamOpenDto | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 字段名称 | | value | Object | 字段值 | | type | String | 字段类型 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码 | | error_msg | String | 错误信息 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码 | | error_msg | String | 错误信息 | #### 请求示例 ``` /openapi/v1/wos/wo-info [ { "wo_id" : "1574698325467510369", "wo_order" : "WOP123456" } ] ``` #### 响应示例 **状态码：200** 请求成功 ``` { "status" : "200", "message" : "success", "i18n" : null, "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" } ] } ``` **状态码：400** 参数校验异常 ``` { "error_code" : "IDT.0604xxxx", "error_msg" : "xxx does not exist" } ``` **状态码：500** API执行异常 ``` { "error_code" : "IDT.0604xxxx", "error_msg" : "xxx does not exist" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 请求成功 | | 400 | 参数校验异常 | | 500 | API执行异常 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-craftartsipdcenter/ErrorCode.html)。