生产 API 接口文档
这帮你解决什么：生产模块开放API:生产订单查询/详情接口,获取生产数据。共 2 个接口,含请求参数和响应字段。
接口概览
| 接口 | 方式 | 路径 | 说明 |
|---|---|---|---|
| 分页查询生产订单 | POST | /open/api/saas/erp/productionOrder/menuPage | 根据多种条件分页查询生产订单信息，支持按生产订单号、销售订单、商品、时间范围等多维度筛选 |
| 查询生产订单详情 | POST | /open/api/saas/erp/productionOrder/detail | 根据订单业务ID查询生产订单的详细信息 |
1. 分页查询生产订单
方式: POST ｜ 路径: /open/api/saas/erp/productionOrder/menuPage
根据多种条件分页查询生产订单信息，支持按生产订单号、销售订单、商品、时间范围等多维度筛选
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
pageNum | Integer | 是 | 当前页码，最小值为1 |
pageSize | Integer | 是 | 每页数量，最大值为1000 |
bizKeys | List<Long> | 否 | 业务主键ID列表 |
productionOrderCode | String | 否 | 生产订单编号 |
orderCode | String | 否 | 销售订单编号 |
orderName | String | 否 | 销售订单名称 |
saleOrderGoodsSaleNum | BigDecimal | 否 | 销售订单里成品/半成品的销售数量 |
statusList | List<Integer> | 否 | 状态列表（1:待下发 2:待生产 3:生产中 4:已完成 5:已挂起 6:已关闭） |
orderFulfillmentTimeStart | Date | 否 | 订单交期开始 |
orderFulfillmentTimeEnd | Date | 否 | 订单交期结束 |
planStartTimeStart | Date | 否 | 计划开工时间开始 |
planStartTimeEnd | Date | 否 | 计划开工时间结束 |
planCompletionTimeStart | Date | 否 | 计划完工时间开始 |
planCompletionTimeEnd | Date | 否 | 计划完工时间结束 |
dispatchProduceTimeStart | Date | 否 | 下发生产时间开始 |
dispatchProduceTimeEnd | Date | 否 | 下发生产时间结束 |
createTimeStart | Date | 否 | 创建时间开始 |
createTimeEnd | Date | 否 | 创建时间结束 |
goodsName | String | 否 | 商品名称 |
bomName | String | 否 | BOM名称 |
productionTechnologyName | String | 否 | 工艺路线名称 |
productionOrderNumStart | BigDecimal | 否 | 订单数量开始 |
productionOrderNumEnd | BigDecimal | 否 | 订单数量结束 |
productionPlanNumStart | BigDecimal | 否 | 计划生产数量开始 |
productionPlanNumEnd | BigDecimal | 否 | 计划生产数量结束 |
remark | String | 否 | 备注 |
createBy | Long | 否 | 创建人ID |
productionOrderSource | Integer | 否 | 生产订单来源 |
customerId | Long | 否 | 客户ID |
sortList | List<FieldSortVO> | 否 | 排序集合，详见FieldSortVO对象 |
menuId | Long | 否 | 菜单ID，导出时使用 |
fieldCategory | Integer | 否 | 自定义字段归属类型 |
fieldCode | String | 是 | 属性编码 |
sortType | Integer | 是 | 排序类型 |
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | String | 是 | 响应码 |
message | String | 是 | 响应消息 |
pageNum | Integer | 是 | 当前页码 |
pageSize | Integer | 是 | 每页数量 |
pages | Integer | 是 | 总页数 |
total | Long | 是 | 总记录数 |
bizKey | Long | 是 | 业务id |
productionOrderCode | String | 是 | 生产订单编号 |
productionOrderSource | Integer | 是 | 生产订单来源，见枚举：ProductionOrderSourceEnum |
productionOrderSourceName | String | 是 | 生产订单来源描述 |
bomId | Long | 是 | bomId |
bomCode | String | 是 | bom编号 |
bomName | String | 是 | bom名称 |
projectId | Long | 是 | 项目id |
projectCode | String | 是 | 项目编号 |
projectName | String | 是 | 项目名称 |
orderId | Long | 是 | 销售订单id |
orderCode | String | 是 | 销售订单编号 |
orderName | String | 是 | 销售订单名称 |
saleOrderGoodsSaleNum | BigDecimal | 是 | 销售订单里成品/半成品的销售数量 |
customerId | Long | 是 | 客户id |
customerName | String | 是 | 客户名称 |
goodsId | Long | 是 | 商品id |
goodsCode | String | 是 | 商品编号 |
goodsName | String | 是 | 商品名称 |
goodsSpec | String | 是 | 商品规格型号 |
goodsUnitName | String | 是 | 商品单位名称 |
goodsUnitValue | String | 是 | 商品单位值 |
goodsCategoryName | String | 是 | 商品分类名称 |
goodsCategoryValue | String | 是 | 商品分类值 |
productionTechnologyId | Long | 是 | 工艺路线id |
productionTechnologyCode | String | 是 | 工艺路线编号 |
productionTechnologyName | String | 是 | 工艺路线名称 |
status | Integer | 是 | 状态，枚举：ProductionOrderStatusEnum（1：待下发 2：待生产 3：生产中 4：已完成 5：已挂起 6：已关闭） |
statusName | String | 是 | 状态名称（1：待下发 2：待生产 3：生产中 4：已完成 5：已挂起 6：已关闭） |
productionOrderNum | BigDecimal | 是 | 订单数量 |
productionPlanNum | BigDecimal | 是 | 计划生产数量 |
productionCompleteNum | BigDecimal | 是 | 完工数量 |
inStockNum | BigDecimal | 是 | 已入库数量 |
orderFulfillmentTime | Date | 是 | 订单交期 |
planStartTime | Date | 是 | 计划开工时间 |
planCompletionTime | Date | 是 | 计划完工时间 |
dispatchProduceTime | Date | 是 | 下发生产时间 |
remark | String | 是 | 备注 |
customField | List<CustomFieldVO> | 是 | 自定义字段 |
createBy | Long | 是 | 创建人 |
createByName | String | 是 | 创建人名称 |
createTime | Date | 是 | 创建时间 |
currentProductionTaskBizKey | Long | 是 | 当前生产任务biz_key |
currentProcessName | String | 是 | 当前生产任务的工序名称 |
productionOrderPickStatusName | String | 是 | 生产订单的领料状态: 未领料、部分领料、全部领料 |
stockSufficientFlag | Boolean | 是 | 库存是否充足 |
hadPickOrderFlag | Boolean | 是 | 是否创建了领料单 |
hadPurchaseOrderFlag | Boolean | 是 | 是否创建了采购单 |
hadOutStockOrderPickOrderList | List<String> | 是 | 拥有出库单的领料单编号 |
{
"pageNum": 1,
"pageSize": 20,
"bizKeys": [123456, 123457],
"productionOrderCode": "MO202601001",
"orderCode": "SO202601001",
"orderName": "订单A",
"saleOrderGoodsSaleNum": 1000,
"statusList": [2, 3],
"orderFulfillmentTimeStart": "2026-01-01 00:00:00",
"orderFulfillmentTimeEnd": "2026-01-31 23:59:59",
"planStartTimeStart": "2026-01-10 00:00:00",
"planStartTimeEnd": "2026-01-20 23:59:59",
"planCompletionTimeStart": "2026-01-20 00:00:00",
"planCompletionTimeEnd": "2026-01-31 23:59:59",
"dispatchProduceTimeStart": "2026-01-15 00:00:00",
"dispatchProduceTimeEnd": "2026-01-25 23:59:59",
"createTimeStart": "2026-01-01 00:00:00",
"createTimeEnd": "2026-01-31 23:59:59",
"goodsName": "产品A",
"bomName": "产品A BOM",
"productionTechnologyName": "工艺路线A",
"productionOrderNumStart": 100,
"productionOrderNumEnd": 2000,
"productionPlanNumStart": 100,
"productionPlanNumEnd": 2000,
"remark": "备注",
"createBy": 10001,
"productionOrderSource": 1,
"customerId": 2001,
"sortList": [
{
"fieldCode": "createTime",
"sortType": 2
}
],
"menuId": 5001,
"fieldCategory": 1
} | { "code": "200", "message": "success", "data": { "pageNum": 1, "pageSize": 20, "pages": 5, "total": 100, "data": [ { "bizKey": 123456, "productionOrderCode": "MO202601001", "productionOrderSource": 1, "productionOrderSourceName": "销售订单", "bomId": 5001, "bomCode": "BOM001", "bomName": "产品A BOM", "projectId": 3001, "projectCode": "PROJ001", "projectName": "项目A", "orderId": 1001, "orderCode": "SO202601001", "orderName": "订单A", "saleOrderGoodsSaleNum": 1000, "customerId": 2001, "customerName": "客户A", "goodsId": 4001, "goodsCode": "GOODS001", "goodsName": "产品A", "goodsSpec": "规格A", "goodsUnitName": "个", "goodsUnitValue": "pcs", "goodsCategoryName": "电子产品", "goodsCategoryValue": "electronics", "productionTechnologyId": 6001, "productionTechnologyCode": "TECH001", "productionTechnologyName": "工艺路线A", "status": 3, "statusName": "生产中", "productionOrderNum": 1000, "productionPlanNum": 1000, "productionCompleteNum": 500, "inStockNum": 450, "orderFulfillmentTime": "2026-01-30 00:00:00", "planStartTime": "2026-01-20 08:00:00", "planCompletionTime": "2026-01-30 18:00:00", "dispatchProduceTime": "2026-01-19 10:00:00", "remark": "备注信息", "customField": [], "createBy": 10001, "createByName": "张三", "createTime": "2026-01-15 10:30:00", "currentProductionTaskBizKey": 7001, "currentProcessName": "组装工序", "productionOrderPickStatusName": "部分领料", "stockSufficientFlag": true, "hadPickOrderFlag": true, "hadPurchaseOrderFlag": false, "hadOutStockOrderPickOrderList": ["PICK001", "PICK002"] } ] } } | 成功 | - |
请求成功 | 参数错误 | - | 请求参数不合法 |
未授权 | - | 未登录或token失效 | 禁止访问 |
- | 无权限访问该接口 | 服务器错误 | - |
2. 查询生产订单详情
方式: POST ｜ 路径: /open/api/saas/erp/productionOrder/detail
根据订单业务ID查询生产订单的详细信息
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
bizKey | Long | 是 | 订单业务ID |
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | String | 是 | 响应码 |
message | String | 是 | 响应消息 |
是 | 业务ID | productionOrderCode | String |
是 | 生产订单编号 | productionOrderSource | Integer |
是 | 生产订单来源 | bomId | Long |
是 | BOM ID | bomCode | String |
是 | BOM编号 | bomName | String |
是 | BOM名称 | projectId | Long |
是 | 项目ID | projectCode | String |
是 | 项目编号 | projectName | String |
是 | 项目名称 | orderId | Long |
是 | 销售订单ID | orderCode | String |
是 | 销售订单编号 | orderName | String |
是 | 销售订单名称 | customerId | Long |
是 | 客户ID | customerName | String |
是 | 客户名称 | goodsId | Long |
是 | 商品ID | goodsCode | String |
是 | 商品编号 | goodsName | String |
是 | 商品名称 | goodsSpec | String |
是 | 商品规格型号 | goodsUnitName | String |
是 | 商品单位名称 | goodsUnitValue | String |
是 | 商品单位值 | goodsStockNum | Integer |
是 | 商品库存 | productionTechnologyId | Long |
是 | 工艺路线ID | productionTechnologyCode | String |
是 | 工艺路线编号 | productionTechnologyName | String |
是 | 工艺路线名称 | status | Integer |
是 | 状态（1:待下发 2:待生产 3:生产中 4:已完成 5:已挂起 6:已关闭） | productionOrderNum | BigDecimal |
是 | 订单数量 | productionPlanNum | BigDecimal |
是 | 计划生产数量 | orderFulfillmentTime | Date |
是 | 订单交期 | planStartTime | Date |
是 | 计划开工时间 | planCompletionTime | Date |
是 | 计划完工时间 | remark | String |
是 | 备注 | customField | List<CustomFieldVO> |
是 | 自定义字段列表 | createBy | Long |
是 | 创建人ID | createByName | String |
是 | 创建人名称 | createTime | Date |
是 | 创建时间 | productionOrderTaskList | List<ProductionOrderTaskRespVO> |
是 | productionOrderTaskBizKey | Long | 是 |
生产任务业务ID | processId | Long | 是 |
工序id | processName | String | 是 |
工序名称 | workTeamId | Long | 是 |
班组id | workTeamName | String | 是 |
班组名称 | planProductNum | BigDecimal | 是 |
任务计划生产数量 | planStartTime | Date | 是 |
任务计划开工时间 | planCompletionTime | Date | 是 |
任务计划完工时间 | productionTaskStatus | Integer | 是 |
状态，枚举：ProductionTaskStatusEnum（1：待下发 2：待生产 3：生产中 4：已完成 5：已挂起 6：已关闭） | productionCompleteNum | BigDecimal | 是 |
完工数量 | sort | Integer | 是 |
排序 | manHour | BigDecimal | 是 |
工序固定工时 | timeUnit | Integer | 是 |
时间单位，见枚举：TimeUnitEnum | preventConfusion | Boolean | 是 |
流程防呆 | { "bizKey": 123456 } | { "code": "200", "message": "success", "data": { "bizKey": 123456, "productionOrderCode": "MO202601001", "productionOrderSource": 1, "bomId": 5001, "bomCode": "BOM001", "bomName": "产品A BOM", "projectId": 3001, "projectCode": "PROJ001", "projectName": "项目A", "orderId": 1001, "orderCode": "SO202601001", "orderName": "订单A", "customerId": 2001, "customerName": "客户A", "goodsId": 4001, "goodsCode": "GOODS001", "goodsName": "产品A", "goodsSpec": "规格A", "goodsUnitName": "个", "goodsUnitValue": "pcs", "goodsStockNum": 500, "productionTechnologyId": 6001, "productionTechnologyCode": "TECH001", "productionTechnologyName": "工艺路线A", "status": 3, "productionOrderNum": 1000, "productionPlanNum": 1000, "orderFulfillmentTime": "2026-01-30 00:00:00", "planStartTime": "2026-01-20 08:00:00", "planCompletionTime": "2026-01-30 18:00:00", "remark": "备注信息", "customField": [], "createBy": 10001, "createByName": "张三", "createTime": "2026-01-15 10:30:00", "productionOrderTaskList": [ { "productionOrderTaskBizKey": 7001, "processId": 8001, "processName": "组装工序", "workTeamId": 9001, "workTeamName": "组装班组A", "planProductNum": 1000, "planStartTime": "2026-01-20 08:00:00", "planCompletionTime": "2026-01-25 18:00:00", "productionTaskStatus": 3, "productionCompleteNum": 500, "sort": 1, "manHour": 2.5, "timeUnit": 1, "preventConfusion": true }, { "productionOrderTaskBizKey": 7002, "processId": 8002, "processName": "测试工序", "workTeamId": 9002, "workTeamName": "测试班组B", "planProductNum": 1000, "planStartTime": "2026-01-26 08:00:00", "planCompletionTime": "2026-01-28 18:00:00", "productionTaskStatus": 2, "productionCompleteNum": 0, "sort": 2, "manHour": 1.5, "timeUnit": 1, "preventConfusion": false } ] } } | 成功 |
- | 请求成功 | 参数错误 | - |
请求参数不合法 | 未授权 | - | 未登录或token失效 |
禁止访问 | - | 无权限访问该接口 | 服务器错误 |