供应链单据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：审核态
下面是单据支持的状态，支持的√。
单据类型 | 保存态支持版本 | 提交态支持版本 | 审核态支持版本 |
001 采购申请单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
002 采购订单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
003 销售订单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
004 调拨订单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
005 库存调拨单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
006 采购入库 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
007 销售出库 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
008 其他入库 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
009 其他出库 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
010 应收单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
011 应付单 | EAS750及以上 | EASCloud861及以上 | EASCloud861及以上 |
012 采购收货单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
013 生产入库单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
014 调拨入库单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
015 领料申请单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
016 领料出库单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
017 调拨出库单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
018 发货通知单 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
019 采购合同 | EAS850及以上 | EASCloud861及以上 | EASCloud861及以上 |
023 要货申请单 | EASCloud880及以上 | EASCloud861及以上 | EASCloud861及以上 |
025 付款申请单 | EAS820及以上 | X | X |
026 付款单 | EASCloud880及以上 | X | X |
027 收款单 | EASCloud880及以上 | X | X |
返回值为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-dd HH:MM:SS | “createTime”:”2013-06-19 14:58:23” |
字符串 | 字符串 | “name”:”nokia 手机” |
枚举 | 枚举项 | “status”:2 |
基础数据 | EAS系统中的基础数据,采用对象形式表示，需要传入其编码。 | “material”:{“number”:”W002893”} |
布尔型 | 值为true/false。 | “isTax”:true |
001采购申请单
采购申请单单头
属性 | 中文 | 描述 | 必录 | 数据类型 |
creator | 创建者 | 创建者 | 否 | 基础资料 |
createTime | 创建时间 | 创建时间 | 否 | 时间 |
number | 单据编号 | 单据编号 | 是 | 字符串 |
bizDate | 业务日期 | 业务日期 | 是 | 日期 |
description | 摘要 | 摘要 | 否 | 字符串 |
bizType | 业务类型 | 用于控制业务流程，在单据的BOTP转换流程中，单据上的业务类型从源头一直带到尾，库存单据通过携带下来的业务类型来过滤相应的事务类型 | 是 | 基础资料 |
entries | 申请单分录 | 申请单分录 | ||
companyOrgUnit | 财务组织 | 财务组织 | 是 | 基础资料 |
person | 申请人 | 申请人 | 是 | 基础资料 |
isUrgent | 是否加急 | 是否加急 | 是 | 布尔型 |
isMergeBill | 是否为合并单 | 是否为合并单 | 是 | 布尔型 |
isApprovedSupplier | 是否按照货源清单过滤供应商 | 是否按照货源清单过滤供应商 | 是 | 布尔型 |
adminOrg | 部门 | 申请人所属部门 | 否 | 基础资料 |
netBuyOfferId | 网络询价单ID | 网络询价单ID | 否 | 字符串 |
storageOrgUnit | 申请库存组织 | 申请库存组织 | 否 | 基础资料 |
reqAdminOrgUnit | 申请行政组织 | 申请行政组织 | 否 | 基础资料 |
demandType | 需求类型 | 需求类型 | 否 | 基础资料 |
isPriceInTax | 价外税 | 价外税 | 是 | 布尔型 |
isInTax | 含税 | 含税 | 是 | 布尔型 |
totalTax | 税额合计 | 税额合计 | 是 | 布尔型 |
totalTaxAmount | 价税合计 | 价税合计 | 是 | 数值 |
localTotalTaxAmount | 本位币价税合计 | 本位币价税合计 | 是 | 数值 |
changeType | 变更方式 | 变更方式 | 否 | 枚举 |
采购申请单分录
属性 | 中文 | 描述 | 必录 | 数据类型 |
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 | 跟踪号 | 跟踪号 | 否 | 基础资料 |
purContractID | 采购合同号 | 采购合同号 | 否 | 字符串 |
bizDate | 业务日期 | 业务日期 | 否 | 日期 |
companyOrgUnit | 财务组织 | 财务组织 | 否 | 基础资料 |
isManualClose | 是否手工关闭 | 是否手工关闭 | 是 | 布尔型 |
assOrderBaseQty | 关联订单基本数量 | 关联订单基本数量 | 是 | 数值 |
assOrderQty | 关联订单数量 | 关联订单数量 | 是 | 数值 |
reqAdminOrgUnit | 申请部门 | 申请部门 | 否 | 基础资料 |
person | 申请人 | 申请人 | 否 | 基础资料 |
discountRate | 折扣率 | 折扣率 | 否 | 数值 |
供应链单据web service接口说明文档EAS供应链Web Service接口说明文档 描述 本文档针对开发人员，描述了EAS供应链Web Service的单据导入接口。通过该接口可以从外部系统... 点击下载文档 上一篇：应收应付期末对账不平原因总结下一篇：应收应付期末对账新增单据科目对账方式 本文2024-09-22 19:01:20发表“eas cloud知识”栏目。 您需要登录后才可以发表评论， 登录登录 或者 注册 最新文档 热门文章 阅读排行确认删除? |
