PDS生产数据管理系统
IP说明
工厂对接上线PDS之后，由系统管理员提供IP对接
配方接口
获取配方
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：getBoms
接口使用参数
| 名称 | 类型 | 描述 |
|---|
| zkbm | String | 中控编码 |
| acckey | String | 授权密匙32位UUID，需向管理员申请 |
| matnr | String | 产品编码(物料编码) |
输出
| 字段 | 类型 | 描述 |
|---|
| data | 数组 | 配方信息数组 |
| msg | String | 返回结果信息 |
| success | boolean | true/false成功/失败 |
data数组字段说明
| 字段 | 类型 | 描述 |
|---|
| bomEntity | Json字符串 | 配方抬头信息 |
| bomItemList | 数组 | 配方项数组 |
bomEntity JSON字符串字段说明
| 字段 | 类型 | 描述 |
|---|
| id | Int | 配方ID |
| zkbm | String | 中控编码 |
| bmein | String | 产品单位 |
| bmeng | Float | 基本数量 |
| grade | String | 配料阶段 1：一次配料，2：二次配料 |
| inputSource | String | 数据来源 1：SAP,2：手工 |
| matnr | String | 产品编码 |
| status | String | 配方状态 1-未确认,2-已确认,3-换仓后待确认,4-已使用,5-停用 |
| stlal | String | 配方版本（ SAP配方的版本标识为2位数字， 01、02~~~99，到达最大的99之后会重新回到01，而之前的01版本会被覆盖掉。） |
| stlnr | String | 配方号 |
| werks | String | 工厂编码 |
| zidatetime | Date | SAP下传时间 |
| zkHhjQty | Float | 混合机容量KG |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
| ptbbh | String | 配方平台版本号 |
bomItemList JSON字符串字段说明
| 字段 | 类型 | 描述 |
|---|
| id | Int | 配方项ID |
| bomId | Int | 配方抬头ID |
| flgPlc | String | 标示是否配置仓号Y:已配置；N:未配置 |
| idnrk | String | 原料编码 |
| inputSourse | String | 配料阶段 1：一次配料，2：二次配料 |
| meins | String | 原料单位 |
| menge | Float | 原料数量 |
| posnr | String | 行项目 |
| stlal | String | 配方版本 |
| stlnr | String | 配方号 |
| idnrkName | String | 原料描述 |
确认配方
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：affirmBom
接口使用参数
| 名称 | 类型 | 描述 |
|---|
| zkbm | String | 中控编码 |
| acckey | String | 授权密匙32位UUID，需向管理员申请 |
| zkbom | 实体 | 配方配方项配方仓号等信息 |
zkbom实体
| 字段 | 类型 | 描述 |
|---|
| bomId | int | 配方抬头ID |
| zkHhjQty | String | 混合机容量 |
| status | String | 配方状态 |
| bmeng | Int | 基本数量 |
| bomItems | 实体列表 | 配方项信息 |
bomItems实体列表
| 字段 | 类型 | 描述 |
|---|
| posnr | String | 行项目 |
| idnrk | String | 原料编码 |
| menge | Float | 原料数量 |
| meins | String | 原料单位 |
| inputSourse | String | 数据来源 1：SAP,2：手工 |
| plcs | 实体列表 | 配料仓信息 |
plcs 实体列表
| 字段 | 类型 | 描述 |
|---|
| idnrk | String | 原料编码 |
| zkPlc | String | 配料仓编号 |
| zkPlcQty | Float | 配料仓分配的数量 |
输出
| 字段 | 类型 | 描述 |
|---|
| msg | String | 返回结果信息 |
| succes | boolean | true/false 成功/失败 |
判断该配方是否是最新版本
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：isLatestStlal
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| zkbm | String | 中控编码 |
| acckey | String | 授权密匙32位UUID，需向管理员申请 |
| bomId | Int | 配方ID |
输出
| 字段 | 类型 | 描述 |
|---|
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
| data | String | "0"：是最新版本；"1"：不是最新版本 |
获取配方状态
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：getBomStatus
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| zkbm | String | 中控编码 |
| acckey | String | 授权密匙32位UUID，需向管理员申请 |
| stlnr | String | 配方号 |
| stlal | String | 配方版本 |
| matnr | String | 产品编码 |
输出
| 字段 | 类型 | 描述 |
|---|
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
| data | String | 1-未确认,2-已确认,3-换仓后待确认,4-已使用,5-停用 |
更新配方状态
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：updateBomStatus
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| zkbm | String | 中控编码 |
| acckey | String | 授权密匙32位UUID，需向管理员申请 |
| stlnr | String | 配方号 |
| stlal | String | 配方版本 |
| matnr | String | 产品编码 |
| status | String | 配方状态 |
输出
| 字段 | 类型 | 描述 |
|---|
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
同步配方
地址：http://{PDS IP}/pdmis/cxf/bomWebService?wsdl
调用方法：syncBom
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| sysdate | String | 日期格式 yyyy-MM-dd HH:mm:ss |
输出
| 字段 | 类型 | 描述 |
|---|
| data | 数组 | 配方信息数组 |
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
data数组字段说明
| 字段 | 类型 | 描述 |
|---|
| bomEntity | Json字符串 | 配方抬头信息 |
| bomItemList | 数组 | 配方项数组 |
bomEntity JSON字符串字段说明
| 字段 | 类型 | 描述 |
|---|
| id | Int | 配方ID |
| zkbm | String | 中控编码 |
| bmein | String | 产品单位 |
| bmeng | Float | 基本数量 |
| grade | String | 配料阶段 1：一次配料，2：二次配料 |
| inputSource | String | 数据来源 1：SAP,2：手工 |
| matnr | String | 产品编码 |
| status | String | 配方状态 1-未确认,2-已确认,3-换仓后待确认,4-已使用,5-停用 |
| stlal | String | 配方版本 |
| stlnr | String | 配方号 |
| werks | String | 工厂编码 |
| zidatetime | Date | SAP下传时间 |
| zkHhjQty | Float | 混合机容量KG |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
| ptbbh | String | 配方平台版本号 |
bomItemList JSON字符串字段说明
| 字段 | 类型 | 描述 |
|---|
| id | Int | 配方项ID |
| bomId | Int | 配方抬头ID |
| flgPlc | String | 标示是否配置仓号Y:已配置；N:未配置 |
| idnrk | String | 原料编码 |
| inputSourse | String | 配料阶段 1：一次配料，2：二次配料 |
| meins | String | 原料单位 |
| menge | Float | 原料数量 |
| posnr | String | 行项目 |
| stlal | String | 配方版本 |
| stlnr | String | 配方号 |
| idnrkName | String | 原料描述 |
物料
获取物料
地址：http://{PDS IP}/pdmis/cxf/matnrWebService?wsdl
调用方法：getMatnr
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| acckey | String | 访问授权码 |
| zkbm | String | 中控编码 |
| mark | String | 逻辑标志: 分别是 1 2 3 三个选择 1.表示根据物料编码和物料描述在物料表中搜索2.表示在”物料类别配置”、”物料组-物料类别匹配规则”和“物料表”的关联关系中，根据配料仓号、物料编码和物料描述在物料表中搜索;3.表示在配料仓历史记录表中，根据中控编码、配料仓号、物料编码和物料描述进行搜索; |
| plch | String | 配料仓号 |
| matnr | String | 物料编码 |
| maktx | String | 物料描述 |
输出
| 字段 | 类型 | 描述 |
|---|
| data | Object | 物料编码和物料描述的集合 |
| msg | String | 返回文字信息 |
| success | boolean | true/false 成功/失败 |
data 数据
| 字段 | 类型 | 描述 |
|---|
| matnr | String | 物料编码 |
| maktx | String | 物料描述 |
| matkl | String | 物料组 |
| mtype | String | 物料类别(中文描述) |
| mmsta | String | 物料状态 X：停用 Y：可以 |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
同步物料
地址：http://{PDS IP}/pdmis/cxf/matnrWebService?wsdl
调用方法：syncMatnr
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| sysdate | String | 日期格式 yyyy-MM-dd HH:mm:ss |
输出
| 字段 | 类型 | 描述 |
|---|
| data | ARRAY | 物料编码和物料描述的集合 |
| msg | String | 返回文字信息 |
| success | boolean | true/false 成功/失败 |
data 数据
| 字段 | 类型 | 描述 |
|---|
| matnr | String | 物料编码 |
| maktx | String | 物料描述 |
| mtartId | String | 物料类别ID |
| mtartName | String | 物料类别Name |
| matklId | String | 物料组ID |
| matklName | String | 物料组名称 |
| mmsta | String | 物料状态 X：停用 Y：可以 |
| inputSource | String | 数据来源 1：SAP,2：手工 |
| packaging | String | 包装方式(01 散装， 02 包装) |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
| zyylx | String | 营运类型 |
| zscgy | String | 生产工艺 |
| zeiar | String | 粒径 |
订单
读取生产订单
地址：http://{PDS IP}/pdmis/cxf/zkOrderService?wsdl
调用方法：zkGetOrder
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| acckey | String | PDS授权码，32位UUID，需向管理员申请 |
| zflag | String | 生产订单状态（1:未开始2:进行中3:暂停5:停止） |
| zkbm | String | 中控编码 |
输出
| 字段 | 类型 | 描述 |
|---|
| data | ARRAY | 生产订单数据数组 |
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
data数组字段说明
| 字段 | 类型 | 描述 |
|---|
| AUFNR | String | 生产订单号 |
| WERKS | String | 工厂编号 |
| ZKBM | String | 中控系统编码 |
| MATNR | String | 产品编码 |
| GAMNG | Integer | 订单数量 |
| GMEIN | String | 单位 |
| GLTRP_BEGIN | Date | 计划完成日期（开始） |
| GLTRP_END | Date | 计划完成日期（结束） |
| STLNR | String | 配方号 |
| STLAL | String | 配方版本 |
| ZIDATETIME | Date | SAP写入时间 |
| zflag | Integer | 生产订单状态（1:未开始2:进行中3:暂停5:停止） |
| zdatetime1 | Date | 配料开始时间 |
| zdatetime2 | Date | 配料结束时间 |
| scpc | Integer | 当前生产批次 |
| jhscpc | Integer | 计划生产批次 |
| grade | Integer | 配料阶段(3:一次配料，4:二次配料) |
| zaufnr | String | 手工配方订单 |
| ztmp1 | String | 备用数量 |
| remark | String | 备注 |
| posnr | Integer | 配料批次 |
| endTime | Date | 截止配料时间 |
| zwcpc | Integer | 总完成批次 |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
更新生产订单状态（v2）
地址：http://{PDS IP}/pdmis/cxf/zkOrderService?wsdl
调用方法：updateZflagToPDSv2
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| acckey | String | PDS授权码，32位UUID，需向管理员申请 |
| aufnr | String | 生产订单号 |
| zflag | String | 生产订单状态（1:未开始2:进行中3:暂停5:停止） |
| scpc | String | 当前生产批次 |
| zkbm | String | 中控编码 |
| zdatetime1 | String | 配料开始时间yyyy-MM-dd HH:mm:ss |
| zdatetime2 | String | 配料结束时间yyyy-MM-dd HH:mm:ss |
| stlal | String | 配方版本 |
| zflagChangeTime | String | 中控的订单状态更改时间 |
输出
| 字段 | 类型 | 描述 |
|---|
| data | Integer | 订单总完成批次 |
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
同步订单
地址：http://{PDS IP}/pdmis/cxf/zkOrderService?wsdl
调用方法：syncOrder
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| sysdate | String | 日期格式 yyyy-MM-dd HH:mm:ss |
输出
| 字段 | 类型 | 描述 |
|---|
| data | ARRAY | 生产订单数据数组 |
| msg | String | 返回结果信息 |
| success | boolean | true/false 成功/失败 |
data数组字段说明
| 字段 | 类型 | 描述 |
|---|
| AUFNR | String | 生产订单号 |
| WERKS | String | 工厂编号 |
| ZKBM | String | 中控系统编码 |
| MATNR | String | 产品编码 |
| GAMNG | Integer | 订单数量 |
| GMEIN | String | 单位 |
| GLTRP_BEGIN | Date | 计划完成日期（开始） |
| GLTRP_END | Date | 计划完成日期（结束） |
| STLNR | String | 配方号 |
| STLAL | String | 配方版本 |
| ZIDATETIME | Date | SAP写入时间 |
| zflag | Integer | 生产订单状态（1:未开始2:进行中3:暂停5:停止） |
| zdatetime1 | Date | 配料开始时间 |
| zdatetime2 | Date | 配料结束时间 |
| scpc | Integer | 当前生产批次 |
| jhscpc | Integer | 计划生产批次 |
| grade | Integer | 配料阶段(3:一次配料，4:二次配料) |
| zaufnr | String | 手工配方订单 |
| ztmp1 | String | 备用数量 |
| remark | String | 备注 |
| posnr | Integer | 配料批次 |
| endTime | Date | 截止配料时间 |
| zwcpc | Integer | 总完成批次 |
| kunnr | String | 客户编码 |
| name1 | String | 客户名称 |
原料消耗
上传原料消耗数据
地址：http://{PDS IP}/pdmis/cxf/zkOrderService?wsdl
调用方法：syncOrder
接口使用参数
| 字段 | 类型 | 描述 |
|---|
| acckey | String | 访问授权码 |
| ylxhs | ARRAY | 原料消耗实体列表 |
ylxhs数据
| 字段 | 类型 | 描述 |
|---|
| 字段 | 字段类型 | 字段描述 |
| aufnr | String | 生产订单号 |
| idnrk | String | 原料编码 |
| matnr | String | 产品编码 |
| meins | String | 单位 |
| menge | float | 原料数量 |
| zkbm | String | 中控编码 |
| posnr | String | 配料批次 |
| stlal | int | 配方版本 |
| user | String | 操作用户 |
| werks | String | 工厂编码 |
| zbuji | String | 手工补记 |
| zidatetime | String | 中控写入时间 |
| zkch | String | 中控仓号（最多4位） |
| zkdatetime | String | 配料时间 |
| zkid | String | uuid（避免网络原因原料消耗重复传） |
| zkllsl | float | 原料理论数量 |
| ztmp1 | float | 备用数量 |
| ztmp2 | String | 超差记录字段（1:正常，0：超差） |
| ptbbh | String | 配方平台版本号 |
输出
| 字段 | 类型 | 描述 |
|---|
| data | ARRAY | 写入失败集合 |
| msg | String | 返回文字信息 |
| success | boolean | true/false 成功/失败 |
