供应链单据web service接口说明文档

EAS供应链Web Service接口说明文档

描述

    本文档针对开发人员，描述了EAS供应链Web Service的单据导入接口。通过该接口可以从外部系统的数据导入为EAS供应链单据。目前支持EAS供应链导入的单据：采购申请单，采购订单，销售订单，调拨订单，库存调拨单，采购入库，销售出库，其他入库，其他出库，应收单，应付单，采购收货单，生产入库单，调拨入库单，领料申请单，领料出库单，调拨出库单，发货通知单，采购合同，要货申请单，付款申请单，付款单，收款单。

单据导入接口支持导入（通过EAS DEP /BIM工具）动态新增的属性（字段）。

    单据导入接口支持通过二次开发导入新的单据。

     本文档详细描述了，单据导入接口，及各个单据的属性说明

支持的版本

本接口只支持EAS7.5版本及后期版本。

接口部署

Web Service的URI出厂配置为：http://localhost:6888/ormrpc/services/WSSCMWebServiceFacade

单据导入接口

String importBill( String billType , String billDataJSON , int billStatus )

参数说明

String billType 单据类型，目前标准支持的单据类型如下：

001 采购申请单  002 采购订单  003 销售订单  004 调拨订单   005  库存调拨单

006 采购入库    007 销售出库  008 其他入库  009 其他出库   010  应收单

011 应付单   012 采购收货单  013 生产入库单  014 调拨入库单  015 领料申请单   016 领料出库单 017 调拨出库单  018 发货通知单 019 采购合同 023 要货申请单  025 付款申请单  026 付款单  027 收款单

String billDataJSON JSON单据数据集合，支持多个单据同时导入。

JSON 格式为 [{单据对象},{单据对象},..]

int billStatus 导入单据的状态

1：保存态， 2：提交态  3：审核态

下面是单据支持的状态，支持的√。

返回值为String , JSON格式。JSON格式如下：

{

“status” :  0,

“msg” : “信息”

“billErrors”:[{“id”:””,”number”:””,errorMsgs:[“”,””]},{结构同前面的},…]

}

值说明：

status：处理结果：0：全部成功 1：全部失败  2:部分成功

msg : 描述信息

billErrors : 单据错误清单，描述不能导入的原因。

    Id : 单据ID值，number：单据编码， errorMsgs：错误信息集。

导入动态新增的属性

过程描述

1、  通过DEP工具（或BIM工具），推荐使用DEP新增单据属性。

2、  将新增的属性插入到标准JSON中。

3、  接口会自动将新增属性保存到数据库对应的字段。

举例

例如在采购订单中新增两个属性，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、  将二次开发支持的单据类，注册在这个文件中，格式如下：单据类型=Class

10000=com.kingdee.eas.wg.manufactureOrderSupport

4、  单据类型必须从10000开始。

完成以上操作后，调用标准接口importBill，实现新增单据的导入。

单据字段说明

数据类型的格式说明

单据的数据格式为JSON，下面的表格描述了每种数据类型的格式要求，传入的数据请严格遵照以下的格式。