### EAS供应链WebService接口知识点详解
#### 一、概述
EAS供应链WebService接口主要用于实现从外部系统向EAS系统中导入供应链相关单据的功能。此接口不仅支持标准单据的导入,还支持通过动态新增属性的方式扩展单据,并且允许进行二次开发以支持新的单据类型。
#### 二、接口基本信息
- **接口名称**:EAS供应链WebService接口
- **支持版本**:EAS 7.5及以上版本
- **接口部署**:默认部署地址为`http://localhost:6888/ormrpc/services/WSSCMWebServiceFacade`
- **主要功能**:支持EAS供应链中11种单据的导入,包括采购申请、采购订单、销售订单等。
#### 三、接口调用方法
- **接口调用格式**:`String importBill(String billType, String billDataJSON, int billStatus)`
- **参数说明**:
- `billType`:单据类型,例如`001`表示采购申请单。
- `billDataJSON`:包含待导入单据数据的JSON格式字符串。
- `billStatus`:单据导入后的状态,如1表示保存态,2表示提交态,3表示审核态。
#### 四、返回值格式
- **返回值类型**:JSON格式字符串
- **格式说明**:
- `"status"`:处理结果,0表示全部成功,1表示全部失败,2表示部分成功。
- `"msg"`:描述信息。
- `"billErrors"`:单据错误清单,用于描述不能导入的原因,包括单据ID、单据编码以及错误信息集。
#### 五、支持的单据类型及其状态
- **单据类型**:
- 001:采购申请单
- 002:采购订单
- 003:销售订单
- 004:调拨订单
- 005:库存调拨单
- 006:采购入库
- 007:销售出库
- 008:其他入库
- 009:其他出库
- 010:应收单
- 011:应付单
- **支持的状态**:
- 保存态(1)
- 提交态(2)
- 审核态(3)
#### 六、导入动态新增的属性
- **过程描述**:
- 使用DEP工具(或BIM工具)新增单据属性。
- 将新增的属性插入到标准JSON格式的单据数据中。
- 接口自动将这些属性保存到数据库对应的字段中。
- **示例**:
- 在采购订单中新增`totalPrice`(数值类型)和`parentMaterial`(关联物料字段)属性。
- JSON数据示例:`{"totalPrice":23.0900,"parentMaterial":{"number":"2003099N909"}}`
#### 七、二次开发导入新的单据
- **步骤说明**:
1. 在类路径`com/kingdee/eas/scm/ws`下增加`WSimportclasses_l1.properties`文件。
2. 开发新单据导入类,此类必须实现接口`com.kingdee.eas.scm.ws.app.importbill.IBillSupport`。
3. 在`WSimportclasses_l1.properties`文件中注册二次开发支持的单据类,格式为:单据类型=Class。
- 单据类型必须从10000开始。
4. 调用标准接口`importBill`实现新增单据的导入。
#### 八、单据字段说明
- **数据类型的格式说明**:
- `ID`:最大长度为44位的字符串。
- `数值`:小数值,金额类的小数位最多为4位,数量、单价的精度最多为8位。
- `整数`:整数值。
- **各单据字段详细说明**:
- **采购订单**
- 单头
- 分录
- 费用明细
- **采购申请单**
- 单头
- 分录
- **销售订单**
- 单头
- 分录
- **调拨订单**
- 单头
- 分录
- **库存调拨单**
- 单头
- 分录
- **采购入库单**
- 单头
- 分录
- **销售出库单**
- 单头
- 分录
- **其他入库单**
- 单头
- 分录
- **其他出库单**
- 单头
- 分录
- **应收单**
- 单头
- 收款计划
- 分录
- **应付单**
- 单头
- 付款计划
- 分录
通过上述详细介绍,我们可以看到EAS供应链WebService接口为开发人员提供了强大的功能支持,不仅可以实现标准单据的导入,还可以灵活地扩展单据属性,甚至通过二次开发支持更多定制化的单据类型。这对于提高企业的供应链管理效率具有重要意义。
1