EAS供应链Web Service接口说明文档 描述本文档针对开发人员,描述了EAS供应链WebService的单据导入接口。通过该接口可以从外部系统的数据导入为EAS供应链单据。目前支持EAS供应链11个单据的导入:采购申请、采购订单、销售订单、调拨订单、库存调拨单、采购入库、销售出库、其他入库、其他出库、应收单、应付单。单据导入接口支持导入(通过EAS DEP/BIM工具)动态新增的属性(字段)。 单据导入接口支持通过二次开发导入新的单据。 本文档详细描述了,单据导入接口,及各个单据的属性说明支持的版本本接口只支持EAS7.5版本及后期版本。接口部署Web Service的URI出厂配置为:http://localhost:6888/ormrpc/services/WSSCMWebServiceFacade 单据导入接口String importBill( String billType , StringbillDataJSON , int billStatus ) 参数说明String billType 单据类型,目前标准支持的单据类型如下:001 采购申请单 002 采购订单 003 销售订单 004 调拨订单 005 库存调拨单006 采购入库 007 销售出库 008 其他入库 009 其他出库 010 应收单011 应付单 String billDataJSON JSON单据数据集合,支持多个单据同时导入。JSON 格式为 [{单据对象},{单据对象},..] int billStatus 导入单据的状态1:保存态, 2:提交态 3:审核态下面是单据支持的状态,支持的√。[table]
[tr] [td=114] 单据类型 [td=114]保存态 [td=114]提交态 [td=114]审核态
[tr] [td=114]001 采购申请单 [td=114]√ [td=114] [td=114]
[tr] [td=114]002 采购订单 [td=114]√ [td=114] [td=114]
[tr] [td=114]003 销售订单 [td=114]√ [td=114] [td=114]
[tr] [td=114]004 调拨订单 [td=114]√ [td=114] [td=114]
[tr] [td=114]005 库存调拨单 [td=114]√ [td=114] [td=114]
[tr] [td=114]006 采购入库 [td=114]√ [td=114] [td=114]
[tr] [td=114]007 销售出库 [td=114]√ [td=114] [td=114]
[tr] [td=114]008 其他入库 [td=114]√ [td=114] [td=114]
[tr] [td=114]009 其他出库 [td=114]√ [td=114] [td=114]
[tr] [td=114]010 应收单 [td=114]√ [td=114]√ [td=114]
[tr] [td=114]011 应付单 [td=114]√ [td=114]√ [td=114]
返回值为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.IBillSupport3、 将二次开发支持的单据类,注册在这个文件中,格式如下:单据类型=Class10000=com.kingdee.eas.wg.manufactureOrderSupport4、 单据类型必须从10000开始。 完成以上操作后,调用标准接口importBill,实现新增单据的导入。
单据字段说明数据类型的格式说明单据的数据格式为JSON,下面的表格描述了每种数据类型的格式要求,传入的数据请严格遵照以下的格式。[table]
[tr] [td=92] 数据类型 [td=286]说明 [td=189]格式要求
[tr] [td=92]ID [td=286]最大长度为44为的字符串 [td=189]“id”:”A093893DF”
[tr] [td=92]数值 [td=286]小数值,金额类的小数位最多为4位,数量、单价的精度最多为8位。 [td=189]“qty”,23.9099
[tr] [td=92]整数 [td=286]整数值。 [td=189]“year”:2013
[tr] [td=92]日期 [td=286]日期,要求为yyyy-mm-dd [td=189]“bizDate”:”2013-06-19”
[tr] [td=92]时间 [td=286]日期,时间类型,要求为 yyyy-mm-dd HH:MM:SS [td=189]“createTime”:”2013-06-19 14:58:23”
[tr] [td=92]字符串 [td=286]字符串 [td=189]“name”:”nokia 手机”
[tr] [td=92]枚举 [td=286]枚举项 [td=189]“status”:2
[tr] [td=92]基础数据 [td=286]EAS系统中的基础数据,采用对象形式表示,需要传入其编码。 [td=189]“material”:{“number”:”W002893”}
[tr] [td=92]布尔型 [td=286]值为true/false。 [td=189]“isTax”:true
采购订单单头
[tr] [td=143] 属性 [td=123] 中文 [td=170] 描述 [td=66]必录 [td=85]数据类型
[tr] [td=143]creator [td=123] 创建者 [td=170] 创建者 [td=66]否 [td=85]基础资料
[tr] [td=143]createTime [td=123] 创建时间 [td=170] 创建时间 [td=66]否 [td=85]时间
[tr] [td=143]number [td=123] 单据编号 [td=170] 单据编号 [td=66]是 [td=85]字符串
[tr] [td=143]bizDate [td=123] 业务日期 [td=170] 业务日期 [td=66]是 [td=85]日期
[tr] [td=143]description [td=123] 摘要 [td=170]摘要 [td=66]否 [td=85]字符串
[tr] [td=143]bizType [td=123] 业务类型 [td=170]参考基础资料“业务类型” [td=66]是 [td=85]基础资料
[tr] [td=143]purchaseOrgUnit [td=123] 采购组织 [td=170] 采购组织 [td=66]是 [td=85]基础资料
[tr] [td=143]purchaseGroup [td=123] 采购组 [td=170] 采购组 [td=66]否 [td=85]基础资料
[tr] [td=143]purchasePerson [td=123] 采购员 [td=170] 采购员 [td=66]否 [td=85]基础资料
[tr] [td=143]supplier [td=123] 供应商 [td=170] 供应商 [td=66]是 [td=85]基础资料
[tr] [td=143]supplierAddress [td=123] 供应商地址 [td=170] 供应商地址 [td=66]否 [td=85]字符串
[tr] [td=143]supplierOrderNumber [td=123] 供应商订单号 [td=170] 供应商订单号 [td=66]否 [td=85]字符串
[tr] [td=143]saleOrgUnit [td=123] 销售组织 [td=170] 销售组织 [td=66]否 [td=85]基础资料
[tr] [td=143]saleOrder [td=123] 销售订单号 [td=170] 销售订单号 [td=66]否 [td=85]基础资料
[tr] [td=143]isDirectSend [td=123] 直运 [td=170] 直运 [td=66]否 [td=85]布尔型
[tr] [td=143]paymentType [td=123] 付款方式 [td=170] 付款方式 [td=66]是 [td=85]基础资料
[tr] [td=143]settlementType [td=123] 结算方式 [td=170] 结算方式 [td=66]否 [td=85]基础资料
[tr] [td=143]cashDiscount [td=123] 现金折扣 [td=170] 现金折扣 [td=66]否 [td=85]基础资料
[tr] [td=143]currency [td=123] 币别 [td=170] 币别 [td=66]是 [td=85]基础资料
[tr] [td=143]exchangeRate [td=123] 汇率 [td=170] 汇率 [td=66]是 [td=85]数值
[tr] [td=143]prepaymentRate [td=123] 预付款比率 [td=170] 预付款比率 [td=66]否 [td=85]数值
[tr] [td=143]prepayment [td=123] 预付款 [td=170] 预付款 [td=66]否 [td=85]数值
[tr] [td=143]prepaid [td=123] 已付预付款 [td=170] 已付预付款 [td=66]否 [td=85]数值
[tr] [td=143]prepaymentDate [td=123] 预付日期 [td=170] 预付日期 [td=66]否 [td=85]日期
[tr] [td=143]supplierConfirm [td=123] 供应商确认 [td=170] 供应商确认 [td=66]是 [td=85]布尔型
[tr] [td=143]isInnerSale [td=123] 内部采购 [td=170] 内部采购 [td=66]是 [td=85]布尔型
[tr] [td=143]adminOrgUnit [td=123] 部门 [td=170] 部门 [td=66]否 [td=85]基础资料
[tr] [td=143]totalAmount [td=123] 金额 [td=170] 金额 [td=66]否 [td=85]数值
[tr] [td=143]totalTax [td=123] 税额 [td=170] 税额 [td=66]否 [td=85]数值
[tr] [td=143]totalTaxAmount [td=123] 价税合计 [td=170] 价税合计 [td=66]否 [td=85]数值
[tr] [td=143]entries [td=123] 采购订单分录 [td=170] 采购订单分录 [td=66] [td=85]
[tr] [td=143]unPrepaidAmount [td=123] 未付预付款 [td=170] 未付预付款 [td=66]否 [td=85]数值
[tr] [td=143]localTotalAmount [td=123] 金额本位币合计 [td=170] 金额本位币合计 [td=66]否 [td=85]数值
[tr] [td=143]localTotalTaxAmount [td=123] 价税合计本位币 [td=170] 价税合计本位币 [td=66]否 [td=85]数值
[tr] [td=143]isCentralBalance [td=123] 是否集中结算 [td=170] 是否集中结算 [td=66]是 [td=85]布尔型
[tr] [td=143]storageOrgUnit [td=123] 库存组织 [td=170] 库存组织 [td=66]否 [td=85]基础资料
[tr] [td=143]warehouse [td=123] 仓库 [td=170] 仓库 [td=66] [td=85]基础资料
[tr] [td=143]isInTax [td=123] 是否含税 [td=170] 是否含税 [td=66]是 [td=85]布尔型
[tr] [td=143]isQuicken [td=123] 加急 [td=170] 加急 [td=66]是 [td=85]布尔型
[tr] [td=143]isPriceInTax [td=123] 是否价外税 [td=170] 是否价外税 [td=66]是 [td=85]布尔型
[tr] [td=143]paymentCondition [td=123] 付款条件 [td=170] 付款条件 [td=66]否 [td=85]基础资料
[tr] [td=143]isApprovedMaterial [td=123] 按照货源清单过滤物料 [td=170] 按照货源清单过滤物料 [td=66]是 [td=85]布尔型
[tr] [td=143]isMatched [td=123]已匹配预付 [td=170]已匹配预付 [td=66]否 [td=85]布尔型
采购订单分录
[tr] [td=143] 属性 [td=123] 中文 [td=170] 描述 [td=57]必录 [td=76]数据类型
[tr] [td=143]material [td=123] 物料 [td=170] 物料 [td=57]是 [td=76]基础资料
[tr] [td=143]assistProperty [td=123] 辅助属性 [td=170] 辅助属性 [td=57]否 [td=76]基础资料
[tr] [td=143]unit [td=123] 计量单位 [td=170] 计量单位 [td=57]是 [td=76]基础资料
[tr] [td=143]remark [td=123] 备注 [td=170] 备注 [td=57]否 [td=76]字符串
[tr] [td=143]reasonCode [td=123] 原因代码