接口配置打通聚水潭和金蝶云星空数据对接源系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。对接目标系统:聚水潭聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。数据对接方案数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。金蝶云星空接口明细 API： executeBillQuery NAME：组装拆卸单查询 METHOD： POST 请求参数接口字段名称预设值 FID 实体主键 FID FBillNo 单据编号 FBillNo FDocumentStatus 单据状态 FDocumentStatus FStockOrgId_FNumber 库存组织 FStockOrgId.FNumber FDate 日期 FDate FBillTypeID 单据类型 FBillTypeID FOwnerTypeIdHead 成品货主类型 FOwnerTypeIdHead FOwnerIdHead_FNumber 成品货主 FOwnerIdHead.FNumber FAffairType 事务类型 FAffairType FEE 费用 FEE FDeptID_FNumber 部门 FDeptID.FNumber FNote 备注 FNote FCreateDate 创建日期 FCreateDate FModifyDate 最后修改日期 FModifyDate FAPPROVEDATE 审核日期 FAPPROVEDATE FCANCELDATE 作废日期 FCANCELDATE FCANCELSTATUS 作废状态 FCANCELSTATUS FSubProOwnTypeIdH 子件货主类型 FSubProOwnTypeIdH FSubProOwnerIdH_FNumber 子件货主 FSubProOwnerIdH.FNumber FEntity 成品表 FSubEntity 子件表 FEntryID 实体主键 FEntryID FRowType 行类型 FRowType FMaterialID_FNumber 物料编码 FMaterialID.FNumber FUnitID_FNumber 单位 FUnitID.FNumber FQty 数量 FQty FBaseQty_FNumber 基本单位数量 FBaseQty.FNumber Fee_ETY 费用 Fee_ETY FStockID_FNumber 仓库 FStockID.FNumber FStockStatusID 库存状态 FStockStatusID FDescription 备注 FDescription FMTONO 计划跟踪号 FMTONO FOwnerTypeID 货主类型 FOwnerTypeID FOwnerID_FNumber 货主 FOwnerID.FNumber FKeeperTypeID 保管者类型 FKeeperTypeID FKeeperID_FNumber 保管者 FKeeperID.FNumber FBomID BOM版本 FBomID FProduceDate 生产日期 FProduceDate FStockLocId_FNumber 仓位 FStockLocId.FNumber FLOT 批号 FLOT FSrcBillTypeId 源单类型 FSrcBillTypeId FSrcBillNo 源单编号 FSrcBillNo FDetailID 实体主键 FDetailID FRowTypeSETY 行类型 FRowTypeSETY FMaterialIDSETY_FNumber 物料编码 FMaterialIDSETY.FNumber FUnitIDSETY_FNumber 单位 FUnitIDSETY.FNumber FQtySETY 数量 FQtySETY FCostProportion 成本拆分比例 FCostProportion FStockIDSETY_FNumber 仓库 FStockIDSETY.FNumber FStockStatusIDSETY 库存状态 FStockStatusIDSETY FDescriptionSETY 备注 FDescriptionSETY FMTONOSETY 计划跟踪号 FMTONOSETY FProjectNoSETY 项目编号 FProjectNoSETY FOwnerTypeIDSETY 货主类型 FOwnerTypeIDSETY FOwnerIDSETY_FNumber 货主 FOwnerIDSETY.FNumber FKeeperTypeIDSETY 保管者类型 FKeeperTypeIDSETY FKeeperIDSETY 保管者 FKeeperIDSETY FPriceSETY 成本价 FPriceSETY FAmountSETY 总成本 FAmountSETY FStockLocIdSETY_FNumber 仓位 FStockLocIdSETY.FNumber FLOTSETY 批号 FLOTSETY Limit 最大行数 {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 {{PAGINATION_START_ROW}} TopRowCount 返回总行数 FilterString 过滤条件 FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys 需查询的字段key集合 FormId 业务对象表单Id 响应参数接口字段名称预设值 FID 实体主键 FBillNo 单据编号 FDocumentStatus 单据状态 FStockOrgId_FNumber 库存组织 FDate 日期 FBillTypeID 单据类型 FOwnerTypeIdHead 成品货主类型 FOwnerIdHead_FNumber 成品货主 FAffairType 事务类型 FEE 费用 FDeptID_FNumber 部门 FNote 备注 FCreateDate 创建日期 FModifyDate 最后修改日期 FAPPROVEDATE 审核日期 FCANCELDATE 作废日期 FCANCELSTATUS 作废状态 FSubProOwnTypeIdH 子件货主类型 FSubProOwnerIdH_FNumber 子件货主 FEntity 成品表 FEntity.FEntryID 实体主键 FEntity.FRowType 行类型 FEntity.FMaterialID_FNumber 物料编码 FEntity.FUnitID_FNumber 单位 FEntity.FQty 数量 FEntity.FBaseQty_FNumber 基本单位数量 FEntity.Fee_ETY 费用 FEntity.FStockID_FNumber 仓库 FEntity.FStockStatusID 库存状态 FEntity.FDescription 备注 FEntity.FMTONO 计划跟踪号 FEntity.FOwnerTypeID 货主类型 FEntity.FOwnerID_FNumber 货主 FEntity.FKeeperTypeID 保管者类型 FEntity.FKeeperID_FNumber 保管者 FEntity.FBomID BOM版本 FEntity.FProduceDate 生产日期 FEntity.FStockLocId_FNumber 仓位 FEntity.FLOT 批号 FEntity.FSrcBillTypeId 源单类型 FEntity.FSrcBillNo 源单编号 FEntity.FSubEntity 子件表 FEntity.FSubEntity.FDetailID 实体主键 FEntity.FSubEntity.FRowTypeSETY 行类型 FEntity.FSubEntity.FMaterialIDSETY_FNumber 物料编码 FEntity.FSubEntity.FUnitIDSETY_FNumber 单位 FEntity.FSubEntity.FQtySETY 数量 FEntity.FSubEntity.FCostProportion 成本拆分比例 FEntity.FSubEntity.FStockIDSETY_FNumber 仓库 FEntity.FSubEntity.FStockStatusIDSETY 库存状态 FEntity.FSubEntity.FDescriptionSETY 备注 FEntity.FSubEntity.FMTONOSETY 计划跟踪号 FEntity.FSubEntity.FProjectNoSETY 项目编号 FEntity.FSubEntity.FOwnerTypeIDSETY 货主类型 FEntity.FSubEntity.FOwnerIDSETY_FNumber 货主 FEntity.FSubEntity.FKeeperTypeIDSETY 保管者类型 FEntity.FSubEntity.FKeeperIDSETY 保管者 FEntity.FSubEntity.FPriceSETY 成本价 FEntity.FSubEntity.FAmountSETY 总成本 FEntity.FSubEntity.FStockLocIdSETY_FNumber 仓位 FEntity.FSubEntity.FLOTSETY 批号聚水潭接口明细 API： jushuitan.otherinout.upload NAME：新建其它出入库（新） METHOD： POST 请求参数接口字段名称预设值 is_confirm 是否自动确认单据 1 wms_co_id 分仓编号 type 出入库类型: in是入库 out是出库 external_id 外部单号 warehouse 主仓=1，销退仓=2，进货仓=3，次品仓 = 4 remark 备注 drp_co_name 出库类型 receiver_name 收件人姓名 receiver_mobile 收件人手机号 receiver_state 收件地址省 receiver_city 收件地址市 receiver_district 收件地址区县 receiver_address 收件详细地址 items 商品列表 items.sku_id 商品编码 items.qty 数量 items.batch_id 批次单号，系统中需开启相关配置 items.produced_date 生产日期，系统中需开启相关配置 items.expiration_date 有效期至，系统中需开启相关配置 items.remark 备注响应参数接口字段名称预设值 code 非0失败 msg 错误描述 data 返回内容 data.external_id 外部单号 data.io_id 系统内部单号数据对接效果通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和聚水潭，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

接口配置打通聚水潭和金蝶云星空数据对接

刘培强qeasy

接口配置打通聚水潭和金蝶云星空数据对接

源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标系统:聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

数据对接方案

数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

金蝶云星空接口明细

API：executeBillQuery
NAME：组装拆卸单查询
METHOD：POST

请求参数

接口字段	名称	预设值
FID	实体主键	FID
FBillNo	单据编号	FBillNo
FDocumentStatus	单据状态	FDocumentStatus
FStockOrgId_FNumber	库存组织	FStockOrgId.FNumber
FDate	日期	FDate
FBillTypeID	单据类型	FBillTypeID
FOwnerTypeIdHead	成品货主类型	FOwnerTypeIdHead
FOwnerIdHead_FNumber	成品货主	FOwnerIdHead.FNumber
FAffairType	事务类型	FAffairType
FEE	费用	FEE
FDeptID_FNumber	部门	FDeptID.FNumber
FNote	备注	FNote
FCreateDate	创建日期	FCreateDate
FModifyDate	最后修改日期	FModifyDate
FAPPROVEDATE	审核日期	FAPPROVEDATE
FCANCELDATE	作废日期	FCANCELDATE
FCANCELSTATUS	作废状态	FCANCELSTATUS
FSubProOwnTypeIdH	子件货主类型	FSubProOwnTypeIdH
FSubProOwnerIdH_FNumber	子件货主	FSubProOwnerIdH.FNumber
FEntity	成品表
FSubEntity	子件表
FEntryID	实体主键	FEntryID
FRowType	行类型	FRowType
FMaterialID_FNumber	物料编码	FMaterialID.FNumber
FUnitID_FNumber	单位	FUnitID.FNumber
FQty	数量	FQty
FBaseQty_FNumber	基本单位数量	FBaseQty.FNumber
Fee_ETY	费用	Fee_ETY
FStockID_FNumber	仓库	FStockID.FNumber
FStockStatusID	库存状态	FStockStatusID
FDescription	备注	FDescription
FMTONO	计划跟踪号	FMTONO
FOwnerTypeID	货主类型	FOwnerTypeID
FOwnerID_FNumber	货主	FOwnerID.FNumber
FKeeperTypeID	保管者类型	FKeeperTypeID
FKeeperID_FNumber	保管者	FKeeperID.FNumber
FBomID	BOM版本	FBomID
FProduceDate	生产日期	FProduceDate
FStockLocId_FNumber	仓位	FStockLocId.FNumber
FLOT	批号	FLOT
FSrcBillTypeId	源单类型	FSrcBillTypeId
FSrcBillNo	源单编号	FSrcBillNo
FDetailID	实体主键	FDetailID
FRowTypeSETY	行类型	FRowTypeSETY
FMaterialIDSETY_FNumber	物料编码	FMaterialIDSETY.FNumber
FUnitIDSETY_FNumber	单位	FUnitIDSETY.FNumber
FQtySETY	数量	FQtySETY
FCostProportion	成本拆分比例	FCostProportion
FStockIDSETY_FNumber	仓库	FStockIDSETY.FNumber
FStockStatusIDSETY	库存状态	FStockStatusIDSETY
FDescriptionSETY	备注	FDescriptionSETY
FMTONOSETY	计划跟踪号	FMTONOSETY
FProjectNoSETY	项目编号	FProjectNoSETY
FOwnerTypeIDSETY	货主类型	FOwnerTypeIDSETY
FOwnerIDSETY_FNumber	货主	FOwnerIDSETY.FNumber
FKeeperTypeIDSETY	保管者类型	FKeeperTypeIDSETY
FKeeperIDSETY	保管者	FKeeperIDSETY
FPriceSETY	成本价	FPriceSETY
FAmountSETY	总成本	FAmountSETY
FStockLocIdSETY_FNumber	仓位	FStockLocIdSETY.FNumber
FLOTSETY	批号	FLOTSETY
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}
StartRow	开始行索引	{{PAGINATION_START_ROW}}
TopRowCount	返回总行数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}'
FieldKeys	需查询的字段key集合
FormId	业务对象表单Id

响应参数

接口字段	名称	预设值
FID	实体主键
FBillNo	单据编号
FDocumentStatus	单据状态
FStockOrgId_FNumber	库存组织
FDate	日期
FBillTypeID	单据类型
FOwnerTypeIdHead	成品货主类型
FOwnerIdHead_FNumber	成品货主
FAffairType	事务类型
FEE	费用
FDeptID_FNumber	部门
FNote	备注
FCreateDate	创建日期
FModifyDate	最后修改日期
FAPPROVEDATE	审核日期
FCANCELDATE	作废日期
FCANCELSTATUS	作废状态
FSubProOwnTypeIdH	子件货主类型
FSubProOwnerIdH_FNumber	子件货主
FEntity	成品表
FEntity.FEntryID	实体主键
FEntity.FRowType	行类型
FEntity.FMaterialID_FNumber	物料编码
FEntity.FUnitID_FNumber	单位
FEntity.FQty	数量
FEntity.FBaseQty_FNumber	基本单位数量
FEntity.Fee_ETY	费用
FEntity.FStockID_FNumber	仓库
FEntity.FStockStatusID	库存状态
FEntity.FDescription	备注
FEntity.FMTONO	计划跟踪号
FEntity.FOwnerTypeID	货主类型
FEntity.FOwnerID_FNumber	货主
FEntity.FKeeperTypeID	保管者类型
FEntity.FKeeperID_FNumber	保管者
FEntity.FBomID	BOM版本
FEntity.FProduceDate	生产日期
FEntity.FStockLocId_FNumber	仓位
FEntity.FLOT	批号
FEntity.FSrcBillTypeId	源单类型
FEntity.FSrcBillNo	源单编号
FEntity.FSubEntity	子件表
FEntity.FSubEntity.FDetailID	实体主键
FEntity.FSubEntity.FRowTypeSETY	行类型
FEntity.FSubEntity.FMaterialIDSETY_FNumber	物料编码
FEntity.FSubEntity.FUnitIDSETY_FNumber	单位
FEntity.FSubEntity.FQtySETY	数量
FEntity.FSubEntity.FCostProportion	成本拆分比例
FEntity.FSubEntity.FStockIDSETY_FNumber	仓库
FEntity.FSubEntity.FStockStatusIDSETY	库存状态
FEntity.FSubEntity.FDescriptionSETY	备注
FEntity.FSubEntity.FMTONOSETY	计划跟踪号
FEntity.FSubEntity.FProjectNoSETY	项目编号
FEntity.FSubEntity.FOwnerTypeIDSETY	货主类型
FEntity.FSubEntity.FOwnerIDSETY_FNumber	货主
FEntity.FSubEntity.FKeeperTypeIDSETY	保管者类型
FEntity.FSubEntity.FKeeperIDSETY	保管者
FEntity.FSubEntity.FPriceSETY	成本价
FEntity.FSubEntity.FAmountSETY	总成本
FEntity.FSubEntity.FStockLocIdSETY_FNumber	仓位
FEntity.FSubEntity.FLOTSETY	批号

聚水潭接口明细

API：jushuitan.otherinout.upload
NAME：新建其它出入库（新）
METHOD：POST

请求参数

接口字段	名称	预设值
is_confirm	是否自动确认单据	1
wms_co_id	分仓编号
type	出入库类型: in是入库 out是出库
external_id	外部单号
warehouse	主仓=1，销退仓=2，进货仓=3，次品仓 = 4
remark	备注
drp_co_name	出库类型
receiver_name	收件人姓名
receiver_mobile	收件人手机号
receiver_state	收件地址省
receiver_city	收件地址市
receiver_district	收件地址区	县
receiver_address	收件详细地址
items	商品列表
items.sku_id	商品编码
items.qty	数量
items.batch_id	批次单号，系统中需开启相关配置
items.produced_date	生产日期，系统中需开启相关配置
items.expiration_date	有效期至，系统中需开启相关配置
items.remark	备注

响应参数

接口字段	名称	预设值
code	非0失败
msg	错误描述
data	返回内容
data.external_id	外部单号
data.io_id	系统内部单号

数据对接效果

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和聚水潭，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。