EAS供应链WebService接口说明文档二次开发用.docx

1、EAS供应链WebService接口说明文档二次开发用EAS供应链Web Service接口说明文档描述本文档针对开发人员，描述了EAS供应链Web Service的单据导入接口。通过该接口可以从外部系统的数据导入为EAS供应链单据。目前支持EAS供应链11个单据的导入：采购申请、采购订单、销售订单、调拨订单、库存调拨单、采购入库、销售出库、其他入库、其他出库、应收单、应付单。单据导入接口支持导入（通过EAS DEP /BIM工具）动态新增的属性（字段）。 单据导入接口支持通过二次开发导入新的单据。 本文档详细描述了，单据导入接口，及各个单据的属性说明支持的版本本接口只支持EAS7.5版本及后

2、期版本。接口部署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

3、应付单String billDataJSON JSON单据数据集合，支持多个单据同时导入。JSON 格式为 单据对象,单据对象,.int billStatus 导入单据的状态1：保存态， 2：提交态 3：审核态下面是单据支持的状态，支持的。单据类型保存态提交态审核态001 采购申请单002 采购订单003 销售订单004 调拨订单005 库存调拨单006 采购入库007 销售出库008 其他入库009 其他出库010 应收单011 应付单返回值为String , JSON格式。JSON格式如下：“status” : 0,“msg” : “信息”“billErrors”:“id”:”,”numb

4、er”:”,errorMsgs:“”,”,结构同前面的,值说明：status：处理结果：0：全部成功 1：全部失败 2:部分成功msg : 描述信息billErrors : 单据错误清单，描述不能导入的原因。 Id : 单据ID值，number：单据编码， errorMsgs：错误信息集。导入动态新增的属性过程描述1、 通过DEP工具（或BIM工具），推荐使用DEP新增单据属性。2、 将新增的属性插入到标准JSON中。3、 接口会自动将新增属性保存到数据库对应的字段。举例例如在采购订单中新增两个属性，totalPrice 数值类型，parentMaterial 关联物料字段。只需要在JSON中

5、插入如下值即可将外部系统数据保存到数据库中“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.m

6、anufactureOrderSupport4、 单据类型必须从10000开始。完成以上操作后，调用标准接口importBill，实现新增单据的导入。单据字段说明数据类型的格式说明单据的数据格式为JSON，下面的表格描述了每种数据类型的格式要求，传入的数据请严格遵照以下的格式。数据类型说明格式要求ID最大长度为44为的字符串“id”:”A093893DF”数值小数值，金额类的小数位最多为4位，数量、单价的精度最多为8位。“qty”,23.9099整数整数值。“year”:2013日期日期，要求为yyyy-mm-dd“bizDate”:”2013-06-19”时间日期，时间类型，要求为 yyyy

7、-mm-dd HH:MM:SS“createTime”:”2013-06-19 14:58:23”字符串字符串“name”:”nokia 手机”枚举枚举项“status”:2基础数据EAS系统中的基础数据,采用对象形式表示，需要传入其编码。“material”:“number”:”W002893”布尔型值为true/false。“isTax”:true采购订单单头属性中文描述必录数据类型creator 创建者 创建者否基础资料createTime 创建时间 创建时间否时间number 单据编号 单据编号是字符串bizDate 业务日期 业务日期是日期description 摘要摘要否字符串bi

8、zType 业务类型参考基础资料“业务类型”是基础资料purchaseOrgUnit 采购组织 采购组织是基础资料purchaseGroup 采购组 采购组否基础资料purchasePerson 采购员 采购员否基础资料supplier 供应商 供应商是基础资料supplierAddress 供应商地址 供应商地址否字符串supplierOrderNumber 供应商订单号 供应商订单号否字符串saleOrgUnit 销售组织 销售组织否基础资料saleOrder 销售订单号 销售订单号否基础资料isDirectSend 直运 直运否布尔型paymentType 付款方式 付款方式是基础资料s

9、ettlementType 结算方式 结算方式否基础资料cashDiscount 现金折扣 现金折扣否基础资料currency 币别 币别是基础资料exchangeRate 汇率 汇率是数值prepaymentRate 预付款比率 预付款比率否数值prepayment 预付款 预付款否数值prepaid 已付预付款 已付预付款否数值prepaymentDate 预付日期 预付日期否日期supplierConfirm 供应商确认 供应商确认是布尔型isInnerSale 内部采购 内部采购是布尔型adminOrgUnit 部门 部门否基础资料totalAmount 金额 金额否数值totalTa

10、x 税额 税额否数值totalTaxAmount 价税合计 价税合计否数值entries 采购订单分录 采购订单分录 unPrepaidAmount 未付预付款 未付预付款否数值localTotalAmount 金额本位币合计 金额本位币合计否数值localTotalTaxAmount 价税合计本位币 价税合计本位币否数值isCentralBalance 是否集中结算 是否集中结算是布尔型storageOrgUnit 库存组织 库存组织否基础资料warehouse 仓库 仓库基础资料isInTax 是否含税 是否含税是布尔型isQuicken 加急 加急是布尔型isPriceInTax 是否价

11、外税 是否价外税是布尔型paymentCondition 付款条件 付款条件否基础资料isApprovedMaterial 按照货源清单过滤物料 按照货源清单过滤物料是布尔型isMatched已匹配预付已匹配预付否布尔型采购订单分录属性中文描述必录数据类型material 物料 物料是基础资料assistProperty 辅助属性 辅助属性否基础资料unit 计量单位 计量单位是基础资料remark 备注 备注否字符串reasonCode 原因代码 冻结原因、作废原因、关闭原因统一为原因代码，单据头上不维护原因代码，只在单据体上放置原因代码否基础资料isPresent 赠品 赠品是布尔型qty

12、 订货数量 订货数量是数值storageOrgUnit 收货组织 收货组织是基础资料adminOrgUnit 行政组织 行政组织（非物料采购必录）否基础资料assistQty 辅助单位数量 辅助单位数量否数值price 单价 单价是数值discountRate 折扣率 折扣率是数值actualPrice 实际单价 实际单价是数值taxRate 税率 税率是数值taxPrice 含税单价 含税单价是数值actualTaxPrice 实际含税单价 实际含税单价是数值amount 金额 金额是数值tax 税额 税额是数值taxAmount 价税合计 价税合计是数值discountAmount 折扣额

13、 折扣额是数值deliveryDate 交货日期 交货日期是日期receiveOverRate 收货超收比率 收货超收比率否数值receiveOwingRate 收货欠收比率 收货欠收比率否数值deliverAdvanceDay 交货可提前天数 交货可提前天数否数值deliverDeferralDay 交货可推后天数 交货可推后天数否数值trackNumber 追踪号 追踪号否字符串totalExpense 应计费用本位币 应计费用本位币数值entries 费用明细 费用明细quantityUnCtrl 不控制数量 不控制数量是布尔型timeUnCtrl 不控制时间 不控制时间是布尔型deli

14、veryAddress 交货地址 交货地址否字符串isSupInfo 是否从供应商信息带过来的 是否从供应商信息带过来的否布尔型curSeOrderQty 当前销售订单下推的数量 当前销售订单下推的数量，做为严格以销定购的参数最大值。否数值saleOrderNumber 销售订单号 销售订单号否字符串prepaidAmount 已付预款金额 已付预款金额是数值requestOrgUnit 申请组织 申请组织否基础资料reason 原因 原因否字符串isRequestToReceived 申请组织等于收货组织 申请组织等于收货组织否布尔型prepayment 预付款金额 预付款金额否数值preR

15、eceived 已付预付款 已付预付款否数值unPrereceivedAm 未付预付款金额 未付预付款金额否数值isBetweenCompanyRec 跨公司收货 跨公司收货是布尔型rowType 行类型 行类型是基础资料wareHouse 仓库 仓库否基础资料materialName 物料名称 冗余物料名称，作为非生产采购时输入物料（非物料采购必录）是字符串isReqComEqlRecCom 收货公司是否等于申请公司 收货公司是否等于申请公司是布尔型planReceiveQty 安排提货数量 安排提货数量否数值noNumMaterialModel 规格型号 新增规格型号,主要用于非录入物料编

16、码时记录手工录入物料的规格型号（非物料采购必录）否字符串project 项目号 项目号否基础资料trackNo 跟踪号 跟踪号否基础资料采购订单费用明细属性中文描述必录数据类型remark 备注备注否字符串exchangeRate 汇率 汇率是数值unitExpense 单位费用 单位费用是数值expenseAmount 费用金额 费用金额是数值taxRate 税率 税率是数值tax 税额 税额是数值expenseItem 费用项目 费用项目是基础资料currency 币别 币别是基础资料supplier 供应商 供应商是基础资料采购申请单采购申请单单头属性中文描述必录数据类型creator

17、创建者 创建者否基础资料createTime 创建时间 创建时间否时间number 单据编号 单据编号是字符串bizDate 业务日期 业务日期是日期description 摘要摘要否字符串bizType 业务类型 用于控制业务流程，在单据的BOTP转换流程中，单据上的业务类型从源头一直带到尾，库存单据通过携带下来的业务类型来过滤相应的事务类型是基础资料entries 申请单分录 申请单分录companyOrgUnit 财务组织 财务组织是基础资料person 申请人 申请人是基础资料isUrgent 是否加急 是否加急是布尔型isMergeBill 是否为合并单 是否为合并单是布尔型isAp

18、provedSupplier 是否按照货源清单过滤供应商 是否按照货源清单过滤供应商是布尔型adminOrg 部门 申请人所属部门否基础资料采购申请单分录属性中文描述必录数据类型material 物料 物料是基础资料assistProperty 辅助属性 辅助属性否基础资料unit 计量单位 计量单位是基础资料remark 备注 备注否字符串reasonCode 原因代码 冻结原因、作废原因、关闭原因统一为原因代码，单据头上不维护原因代码，只在单据体上放置原因代码否基础资料supplier 供应商 供应商否基础资料currency 币别 币别是基础资料exchangeRate 汇率 汇率是数值

19、purchaseOrgUnit 采购组织 采购组织是基础资料requirementDate 需求日期 需求日期是日期proposeDeliveryDate 建议交货日期 建议交货日期是日期proposePurchaseDate 建议采购日期 建议采购日期是日期purpose 用途 用途否字符串price 单价 单价否数值qty 审批数量 审批数量是数值assistQty 辅助数量 辅助数量否数值amount 金额 金额否数值trackNumber 追踪号 追踪号否字符串reason 原因 原因否字符串mergeBillNumber 合并单号 合并单号否字符串useAdminOrgUnit 使用

20、部门 使用部门否基础资料rowType 行类型行类型是基础资料receivedOrgUnit 收货组织 收货组织是基础资料warehosue 仓库 仓库否基础资料deliveryAddress 收货地址 收货地址否字符串storageOrgUnit 申请组织 申请组织是基础资料adminOrgUnit 申请部门 申请部门（非原材料采购必录）是基础资料materialName 物料名称 冗余物料名称，作为非生产采购时输入物料字符串mergeBillSeq 合并单行号 合并单行号 否整型purchasePerson 采购员 采购员否基础资料isQuantityUnCtrl 不控制数量 不控制数量否

21、布尔型materialGroup1 物料组 物料组否基础资料requestQty 申请数量 申请数量否数值noNumMaterialModel 规格型号 新增规格型号,主要用于非录入物料编码时记录手工录入物料的规格型号（非原材料采购必录）否字符串purchaseGroup 采购组 申请分录采购组否基础资料project 项目号 项目号否 基础资料trackNo 跟踪号 跟踪号否 基础资料销售订单销售订单单头属性中文描述必录数据类型creator 创建者 创建者否基础资料createTime 创建时间 创建时间否时间number 单据编号 单据编号是字符串bizDate 业务日期 业务日期是日期

22、description 摘要摘要否字符串bizType 业务类型 用于控制业务流程，在单据的BOTP转换流程中，单据上的业务类型从源头一直带到尾，库存单据通过携带下来的业务类型来过滤相应的事务类型是基础资料isInnerSale 内部销售 内部销售是布尔型customerOrderNumber 客户订单号 客户订单号否字符串orderCustomer 订货客户 订货客户是基础资料directSupplier 直运供应商 直运供应商否基础资料purchaseOrgUnit 采购组织 采购组织否基础资料deliveryType 交货方式 交货方式是基础资料transLeadTime 运输提前期 运

23、输提前期否整型currency 币别 币别是基础资料exchangeRate 汇率 汇率是数值paymentType 付款方式 付款方式是基础资料cashDiscount 现金折扣 现金折扣否基础资料settlementType 结算方式 结算方式否基础资料prepayment 预收金额 预收金额否数值prepaymentRate 预收比率 预收比率否数值saleOrgUnit 销售组织 销售组织是基础资料saleGroup 销售组 销售组否基础资料salePerson 销售员 销售员是基础资料adminOrgUnit 部门 部门否基础资料totalAmount 金额 金额否数值totalTa

24、x 税额 税额否数值totalTaxAmount 价税合计 价税合计否数值entries 分录 分录 preReceived 已收应收款 已收应收款否数值unPrereceivedAmount 未预收款金额 未预收款金额否数值sendAddress 送货地址 送货地址否字符串localTotalAmount 金额本位币合计 金额本位币合计否数值localTotalTaxAmount 价税合计本位币 价税合计本位币否数值isInTax 是否含税 是否含税是布尔型customerPhone 联系电话 联系电话否字符串linkMan 联系人 联系人否字符串isCentralBalance 集中结算

25、集中结算是布尔型storageOrgUnit 销售方库存组织 销售方库存组织否基础资料receiveCondition 收款条件 收款条件否基础资料warehouse 销售方仓库 销售方仓库否基础资料isMatched 是否匹配收款 是否匹配收款否布尔型isSquareBalance 四方结算 四方结算否布尔型balanceCompanyOrgUnit 结算方财务组织 结算方财务组织否基础资料balanceSaleOrgUnit 结算方销售组织 结算方销售组织否基础资料balanceStorageOrgUnit 结算方库存组织 结算方库存组织否基础资料balanceWarehouse 结算方仓库 结算方仓库否基础资料销售订单分录属性中文描述必录数据类型materia