EAS供应链WebService接口说明文档二次开发用.docx
《EAS供应链WebService接口说明文档二次开发用.docx》由会员分享,可在线阅读,更多相关《EAS供应链WebService接口说明文档二次开发用.docx(61页珍藏版)》请在冰豆网上搜索。
EAS供应链WebService接口说明文档二次开发用
EAS供应链WebService接口说明文档
描述
本文档针对开发人员,描述了EAS供应链WebService的单据导入接口。
通过该接口可以从外部系统的数据导入为EAS供应链单据。
目前支持EAS供应链11个单据的导入:
采购申请、采购订单、销售订单、调拨订单、库存调拨单、采购入库、销售出库、其他入库、其他出库、应收单、应付单。
单据导入接口支持导入(通过EASDEP/BIM工具)动态新增的属性(字段)。
单据导入接口支持通过二次开发导入新的单据。
本文档详细描述了,单据导入接口,及各个单据的属性说明
支持的版本
本接口只支持EAS7.5版本及后期版本。
接口部署
WebService的URI出厂配置为:
http:
//localhost:
6888/ormrpc/services/WSSCMWebServiceFacade
单据导入接口
StringimportBill(StringbillType,StringbillDataJSON,intbillStatus)
参数说明
StringbillType单据类型,目前标准支持的单据类型如下:
001采购申请单002采购订单003销售订单004调拨订单005库存调拨单
006采购入库007销售出库008其他入库009其他出库010应收单
011应付单
StringbillDataJSONJSON单据数据集合,支持多个单据同时导入。
JSON格式为[{单据对象},{单据对象},..]
intbillStatus导入单据的状态
1:
保存态,2:
提交态3:
审核态
下面是单据支持的状态,支持的√。
单据类型
保存态
提交态
审核态
001采购申请单
√
002采购订单
√
003销售订单
√
004调拨订单
√
005库存调拨单
√
006采购入库
√
007销售出库
√
008其他入库
√
009其他出库
√
010应收单
√
√
011应付单
√
√
返回值为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,下面的表格描述了每种数据类型的格式要求,传入的数据请严格遵照以下的格式。
数据类型
说明
格式要求
ID
最大长度为44为的字符串
“id”:
”A093893DF”
数值
小数值,金额类的小数位最多为4位,数量、单价的精度最多为8位。
“qty”,23.9099
整数
整数值。
“year”:
2013
日期
日期,要求为yyyy-mm-dd
“bizDate”:
”2013-06-19”
时间
日期,时间类型,要求为yyyy-mm-ddHH:
MM:
SS
“createTime”:
”2013-06-1914:
58:
23”
字符串
字符串
“name”:
”nokia手机”
枚举
枚举项
“status”:
2
基础数据
EAS系统中的基础数据,采用对象形式表示,需要传入其编码。
“material”:
{“number”:
”W002893”}
布尔型
值为true/false。
“isTax”:
true
采购订单
单头
属性
中文
描述
必录
数据类型
creator
创建者
创建者
否
基础资料
createTime
创建时间
创建时间
否
时间
number
单据编号
单据编号
是
字符串
bizDate
业务日期
业务日期
是
日期
description
摘要
摘要
否
字符串
bizType
业务类型
参考基础资料“业务类型”
是
基础资料
purchaseOrgUnit
采购组织
采购组织
是
基础资料
purchaseGroup
采购组
采购组
否
基础资料
purchasePerson
采购员
采购员
否
基础资料
supplier
供应商
供应商
是
基础资料
supplierAddress
供应商地址
供应商地址
否
字符串
supplierOrderNumber
供应商订单号
供应商订单号
否
字符串
saleOrgUnit
销售组织
销售组织
否
基础资料
saleOrder
销售订单号
销售订单号
否
基础资料
isDirectSend
直运
直运
否
布尔型
paymentType
付款方式
付款方式
是
基础资料
settlementType
结算方式
结算方式
否
基础资料
cashDiscount
现金折扣
现金折扣
否
基础资料
currency
币别
币别
是
基础资料
exchangeRate
汇率
汇率
是
数值
prepaymentRate
预付款比率
预付款比率
否
数值
prepayment
预付款
预付款
否
数值
prepaid
已付预付款
已付预付款
否
数值
prepaymentDate
预付日期
预付日期
否
日期
supplierConfirm
供应商确认
供应商确认
是
布尔型
isInnerSale
内部采购
内部采购
是
布尔型
adminOrgUnit
部门
部门
否
基础资料
totalAmount
金额
金额
否
数值
totalTax
税额
税额
否
数值
totalTaxAmount
价税合计
价税合计
否
数值
entries
采购订单分录
采购订单分录
unPrepaidAmount
未付预付款
未付预付款
否
数值
localTotalAmount
金额本位币合计
金额本位币合计
否
数值
localTotalTaxAmount
价税合计本位币
价税合计本位币
否
数值
isCentralBalance
是否集中结算
是否集中结算
是
布尔型
storageOrgUnit
库存组织
库存组织
否
基础资料
warehouse
仓库
仓库
基础资料
isInTax
是否含税
是否含税
是
布尔型
isQuicken
加急
加急
是
布尔型
isPriceInTax
是否价外税
是否价外税
是
布尔型
paymentCondition
付款条件
付款条件
否
基础资料
isApprovedMaterial
按照货源清单过滤物料
按照货源清单过滤物料
是
布尔型
isMatched
已匹配预付
已匹配预付
否
布尔型
采购订单分录
属性
中文
描述
必录
数据类型
material
物料
物料
是
基础资料
assistProperty
辅助属性
辅助属性
否
基础资料
unit
计量单位
计量单位
是
基础资料
remark
备注
备注
否
字符串
reasonCode
原因代码
冻结原因、作废原因、关闭原因统一为原因代码,单据头上不维护原因代码,只在单据体上放置原因代码
否
基础资料
isPresent
赠品
赠品
是
布尔型
qty
订货数量
订货数量
是
数值
storageOrgUnit
收货组织
收货组织
是
基础资料
adminOrgUnit
行政组织
行政组织(非物料采购必录)
否
基础资料
assistQty
辅助单位数量
辅助单位数量
否
数值
price
单价
单价
是
数值
discountRate
折扣率
折扣率
是
数值
actualPrice
实际单价
实际单价
是
数值
taxRate
税率
税率
是
数值
taxPrice
含税单价
含税单价
是
数值
actualTaxPrice
实际含税单价
实际含税单价
是
数值
amount
金额
金额
是
数值
tax
税额
税额
是
数值
taxAmount
价税合计
价税合计
是
数值
discountAmount
折扣额
折扣额
是
数值
deliveryDate
交货日期
交货日期
是
日期
receiveOverRate
收货超收比率
收货超收比率
否
数值
receiveOwingRate
收货欠收比率
收货欠收比率
否
数值
deliverAdvanceDay
交货可提前天数
交货可提前天数
否
数值
deliverDeferralDay
交货可推后天数
交货可推后天数
否
数值
trackNumber
追踪号
追踪号
否
字符串
totalExpense
应计费用本位币
应计费用本位币
数值
entries
费用明细
费用明细
quantityUnCtrl
不控制数量
不控制数量
是
布尔型
timeUnCtrl
不控制时间
不控制时间
是
布尔型
deliveryAddress
交货地址
交货地址
否
字符串
isSupInfo
是否从供应商信息带过来的
是否从供应商信息带过来的
否
布尔型
curSeOrderQty
当前销售订单下推的数量
当前销售订单下推的数量,做为严格以销定购的参数最大值。
否
数值
saleOrderNumber
销售订单号
销售订单号
否
字符串
prepaidAmount
已付预款金额
已付预款金额
是
数值
requestOrgUnit
申请组织
申请组织
否
基础资料
reason
原因
原因
否
字符串
isRequestToReceived
申请组织等于收货组织
申请组织等于收货组织
否
布尔型
prepayment
预付款金额
预付款金额
否
数值
preReceived
已付预付款
已付预付款
否
数值
unPrereceivedAm
未付预付款金额
未付预付款金额
否
数值
isBetweenCompanyRec
跨公司收货
跨公司收货
是
布尔型
rowType
行类型
行类型
是
基础资料
wareHouse
仓库
仓库
否
基础资料
materialName
物料名称
冗余物料名称,作为非生产采购时输入物料(非物料采购必录)
是
字符串
isReqComEqlRecCom
收货公司是否等于申请公司
收货公司是否等于申请公司
是
布尔型
planReceiveQty
安排提货数量
安排提货数量
否
数值
noNumMaterialModel
规格型号
新增规格型号,主要用于非录入物料编码时记录手工录入物料的规格型号(非物料采购必录)
否
字符串
project
项目号
项目号
否
基础资料
trackNo
跟踪号
跟踪号
否
基础资料
采购订单费用明细
属性
中文
描述
必录
数据类型
remark
备注
备注
否
字符串
exchangeRate
汇率
汇率
是
数值
unitExpense
单位费用
单位费用
是
数值
expenseAmount
费用金额
费用金额
是
数值
taxRate
税率
税率
是
数值
tax
税额
税额
是
数值
expenseItem
费用项目
费用项目
是
基础资料
currency
币别
币别
是
基础资料
supplier
供应商
供应商
是
基础资料
采购申请单
采购申请单单头
属性
中文
描述
必录
数据类型
creator
创建者
创建者
否
基础资料
createTime
创建时间
创建时间
否
时间
number
单据编号
单据编号
是
字符串
bizDate
业务日期
业务日期
是
日期
description
摘要
摘要
否
字符串
bizType
业务类型
用于控制业务流程,在单据的BOTP转换流程中,单据上的业务类型从源头一直带到尾,库存单据通过携带下来的业务类型来过滤相应的事务类型
是
基础资料
entries
申请单分录
申请单分录
companyOrgUnit
财务组织
财务组织
是
基础资料
person
申请人
申请人
是
基础资料
isUrgent
是否加急
是否加急
是
布尔型
isMergeBill
是否为合并单
是否为合并单
是
布尔型
isApprovedSupplier
是否按照货源清单过滤供应商
是否按照货源清单过滤供应商
是
布尔型
adminOrg
部门
申请人所属部门
否
基础资料
采购申请单分录
属性
中文
描述
必录
数据类型
material
物料
物料
是
基础资料
assistProperty
辅助属性
辅助属性
否
基础资料
unit
计量单位
计量单位
是
基础资料
remark
备注
备注
否
字符串
reasonCode
原因代码
冻结原因、作废原因、关闭原因统一为原因代码,单据头上不维护原因代码,只在单据体上放置原因代码
否
基础资料
supplier
供应商
供应商
否
基础资料
currency
币别
币别
是
基础资料
exchangeRate
汇率
汇率
是
数值
purchaseOrgUnit
采购组织
采购组织
是
基础资料
requirementDate
需求日期
需求日期
是
日期
proposeDeliveryDate
建议交货日期
建议交货日期
是
日期
proposePurchaseDate
建议采购日期
建议采购日期
是
日期
purpose
用途
用途
否
字符串
price
单价
单价
否
数值
qty
审批数量
审批数量
是
数值
assistQty
辅助数量
辅助数量
否
数值
amount
金额
金额
否
数值
trackNumber
追踪号
追踪号
否
字符串
reason
原因
原因
否
字符串
mergeBillNumber
合并单号
合并单号
否
字符串
useAdminOrgUnit
使用部门
使用部门
否
基础资料
rowType
行类型
行类型
是
基础资料
receivedOrgUnit
收货组织
收货组织
是
基础资料
warehosue
仓库
仓库
否
基础资料
deliveryAddress
收货地址
收货地址
否
字符串
storageOrgUnit
申请组织
申请组织
是
基础资料
adminOrgUnit
申请部门
申请部门(非原材料采购必录)
是
基础资料
materialName
物料名称
冗余物料名称,作为非生产采购时输入物料
字符串
mergeBillSeq
合并单行号
合并单行号
否
整型
purchasePerson
采购员
采购员
否
基础资料
isQuantityUnCtrl
不控制数量
不控制数量
否
布尔型
materialGroup1
物料组
物料组
否
基础资料
requestQty
申请数量
申请数量
否
数值
noNumMaterialModel
规格型号
新增规格型号,主要用于非录入物料编码时记录手工录入物料的规格型号(非原材料采购必录)
否
字符串
purchaseGroup
采购组
申请分录采购组
否
基础资料
project
项目号
项目号
否
基础资料
trackNo
跟踪号
跟踪号
否
基础资料
销售订单
销售订单单头
属性
中文
描述
必录
数据类型
creator
创建者
创建者
否
基础资料
createTime
创建时间
创建时间
否
时间
number
单据编号
单据编号
是
字符串
bizDate
业务日期
业务日期
是
日期
description
摘要
摘要
否
字符串
bizType
业务类型
用于控制业务流程,在单据的BOTP转换流程中,单据上的业务类型从源头一直带到尾,库存单据通过携带下来的业务类型来过滤相应的事务类型
是
基础资料
isInnerSale
内部销售
内部销售
是
布尔型
customerOrderNumber
客户订单号
客户订单号
否
字符串
orderCustomer
订货客户
订货客户
是
基础资料
directSupplier
直运供应商
直运供应商
否
基础资料
purchaseOrgUnit
采购组织
采购组织
否
基础资料
deliveryType
交货方式
交货方式
是
基础资料
transLeadTime
运输提前期
运输提前期
否
整型
currency
币别
币别
是
基础资料
exchangeRate
汇率
汇率
是
数值
paymentType
付款方式
付款方式
是
基础资料
cashDiscount
现金折扣
现金折扣
否
基础资料
settlementType
结算方式
结算方式
否
基础资料
prepayment
预收金额
预收金额
否
数值
prepaymentRate
预收比率
预收比率
否
数值
saleOrgUnit
销售组织
销售组织
是
基础资料
saleGroup
销售组
销售组
否
基础资料
salePerson
销售员
销售员
是
基础资料
adminOrgUnit
部门
部门
否
基础资料
totalAmount
金额
金额
否
数值
totalTax
税额
税额
否
数值
totalTaxAmount
价税合计
价税合计
否
数值
entries
分录
分录
preReceived
已收应收款
已收应收款
否
数值
unPrereceivedAmount
未预收款金额
未预收款金额
否
数值
sendAddress
送货地址
送货地址
否
字符串
localTotalAmount
金额本位币合计
金额本位币合计
否
数值
localTotalTaxAmount
价税合计本位币
价税合计本位币
否
数值
isInTax
是否含税
是否含税
是
布尔型
customerPhone
联系电话
联系电话
否
字符串
linkMan
联系人
联系人
否
字符串
isCentralBalance
集中结算
集中结算
是
布尔型
storageOrgUnit
销售方库存组织
销售方库存组织
否
基础资料
receiveCondition
收款条件
收款条件
否
基础资料
warehouse
销售方仓库
销售方仓库
否
基础资料
isMatched
是否匹配收款
是否匹配收款
否
布尔型
isSquareBalance
四方结算
四方结算
否
布尔型
balanceCompanyOrgUnit
结算方财务组织
结算方财务组织
否
基础资料
balanceSaleOrgUnit
结算方销售组织
结算方销售组织
否
基础资料
balanceStorageOrgUnit
结算方库存组织
结算方库存组织
否
基础资料
balanceWarehouse
结算方仓库
结算方仓库
否
基础资料
销售订单分录
属性
中文
描述
必录
数据类型
materia