聚水潭和金蝶云星空接口打通对接实战源系统:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。目标系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。系统对接接口配置轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：聚水潭的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。聚水潭接口明细接口： allocate.query 接口名称：调拨单查询接口方法： POST 请求参数字段名称类型描述 modified_begin 修改开始时间 string 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end 修改结束时间 string 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 so_ids 线上单号 string 指定线上订单号，和时间段不能同时为空 page_index 开始页码 string 第几页，从第一页开始，默认1 page_size 每页条数 string 每页多少条，默认30，最大50 响应参数字段名称类型描述 items 商品集合 array 商品集合 items.ioi_id 子单号 string 子单号 items.sku_id 商品编码 array 商品编码 items.qty 数量 string 数量 items.name 商品名称 string 商品名称 items.properties_value 颜色及规格 string 颜色及规格 items.io_id 调拨单号 string 调拨单号 items.wms_co_id 分仓编号，调拨出为发起方，调拨入为接收方 string 分仓编号，调拨出为发起方，调拨入为接收方 items.io_date 单据日期 string 单据日期 items.batchs 批次集合 array items.batchs.batch_no 批次号 string 批次号 items.batchs.sku_id 商品编码 string sku_id items.batchs.qty 数量 string qty items.batchs.product_date 批次日期 string 批次日期 items.batchs.supplier_id 供应商编号 string 供应商编号 items.batchs.supplier_name 供应商名称 string 供应商名称 items.batchs.modified 修改时间 string 修改时间 items.batchs.status 单据状态 string 单据状态:Creating:草拟,OuterConfirming:待审核,WaitConfirm:待发货,Confirmed:完成,Archive:归档,Cancelled:取消,Delete:作废 items.batchs.warehouse 调拨出仓库名称 string 调拨出仓库名称 items.batchs.link_warehouse 调拨入仓库名称 string 调拨入仓库名称 items.batchs.f_status 财务状态 string 财务状态 Archive:归档,modifing:变更,WaitConfirm:待审核,Confirmed:已审核,Cancelled:取消,Delete:作废 items.batchs.type 调拨类型 string 调拨类型 items.batchs.wh_id 调拨出仓库编号 string 调拨出仓库编号；主仓=1，销退仓=2，进货仓=3，次品仓 = 4 items.batchs.link_wh_id 调拨入仓库编号 string 调拨入仓库编号；主仓=1，销退仓=2，进货仓=3，次品仓 = 4 items.batchs.link_wms_co_id 调拨入分仓编号，调拨出为接收方，调拨入为发起方 string 调拨入分仓编号，调拨出为接收方，调拨入为发起方 items.batchs.link_io_id 调拨入关联单号 string 调拨入关联单号 items.batchs.so_id 线上单号 string 线上单号 items.batchs.remark 备注 string 备注 items.batchs.creator_name 创建人 string 创建人金蝶云星空接口明细调用接口： batchSave 接口名称：分布式调出单新增方法： POST 请求参数字段字段名称类型配置值 FBillNo 单据编号 string {{io_id}} FOwnerTypeIdHead 调出货主类型 string BD_OwnerOrg FBillTypeID 单据类型 string FBDC01_SYS FTransferBizType 调拨类型 string InnerOrgTransfer FOwnerIdHead 调出货主 string 102 FOwnerTypeInIdHead 调入货主类型 string BD_OwnerOrg FTransferDirect 调拨方向 string GENERAL FOwnerInIdHead 调入货主 string 102 FStockOrgID 调入库存组织 string 102 FStockInOrgID 调入库存组织 string 102 FDate 日期 string {{io_date}} FVESTONWAY 在途归属 string A FNOTE 备注 string FBizType 业务类型 string NORMAL FSTKTRSOUTENTRY 明细信息 array batchs FSTKTRSOUTENTRY.FMaterialID 物料编码 string {{batchs.sku_id}} FSTKTRSOUTENTRY.FLOT 批号 string {{batchs.batch_no}} FSTKTRSOUTENTRY.FSrcStockID 调出仓库 string {{wms_co_id}} FSTKTRSOUTENTRY.FDestStockID 调入仓库 string {{link_wms_co_id}} FSTKTRSOUTENTRY.FSrcStockStatusID 调出库存状态 string KCZT01_SYS FSTKTRSOUTENTRY.FDestStockStatusID 在途库存状态 string KCZT05_SYS FSTKTRSOUTENTRY.FProduceDate 生产日期 string {{batchs.product_date}} FSTKTRSOUTENTRY.FOwnerTypeID 调出货主类型 string BD_OwnerOrg FSTKTRSOUTENTRY.FOwnerID 调出货主 string 102 FSTKTRSOUTENTRY.FOwnerTypeInID 调入货主类型 string BD_OwnerOrg FSTKTRSOUTENTRY.FKeeperTypeInID 调入保管者类型 string BD_KeeperOrg FSTKTRSOUTENTRY.FKeeperInID 调入保管者 string 102 FSTKTRSOUTENTRY.FDestMaterialID 调入物料 string {{batchs.sku_id}} FSTKTRSOUTENTRY.FKeeperTypeID 调出保管者类型 string BD_KeeperOrg FSTKTRSOUTENTRY.FKeeperID 调出保管者 string 102 FSTKTRSOUTENTRY.FEXPIRYDATE 有效期至 string FSTKTRSOUTENTRY.FQty 数量 string {{batchs.qty}} FSTKTRSOUTENTRY.FormId 业务对象表单Id string STK_TRANSFEROUT FSTKTRSOUTENTRY.Operation 执行的操作 string BatchSave FSTKTRSOUTENTRY.IsAutoSubmitAndAudit 提交并审核 bool false FSTKTRSOUTENTRY.IsVerifyBaseDataField 验证基础资料 bool false 系统集成总览随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。

聚水潭和金蝶云星空接口打通对接实战

关一帆qeasy

聚水潭和金蝶云星空接口打通对接实战

源系统:聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

目标系统:金蝶云星空

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

系统对接接口配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：聚水潭的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

聚水潭接口明细

接口：allocate.query
接口名称：调拨单查询
接口方法：POST

请求参数

字段	名称	类型	描述
modified_begin	修改开始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	修改结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
so_ids	线上单号	string	指定线上订单号，和时间段不能同时为空
page_index	开始页码	string	第几页，从第一页开始，默认1
page_size	每页条数	string	每页多少条，默认30，最大50

响应参数

字段	名称	类型	描述
items	商品集合	array	商品集合
items.ioi_id	子单号	string	子单号
items.sku_id	商品编码	array	商品编码
items.qty	数量	string	数量
items.name	商品名称	string	商品名称
items.properties_value	颜色及规格	string	颜色及规格
items.io_id	调拨单号	string	调拨单号
items.wms_co_id	分仓编号，调拨出为发起方，调拨入为接收方	string	分仓编号，调拨出为发起方，调拨入为接收方
items.io_date	单据日期	string	单据日期
items.batchs	批次集合	array
items.batchs.batch_no	批次号	string	批次号
items.batchs.sku_id	商品编码	string	sku_id
items.batchs.qty	数量	string	qty
items.batchs.product_date	批次日期	string	批次日期
items.batchs.supplier_id	供应商编号	string	供应商编号
items.batchs.supplier_name	供应商名称	string	供应商名称
items.batchs.modified	修改时间	string	修改时间
items.batchs.status	单据状态	string	单据状态:Creating:草拟,OuterConfirming:待审核,WaitConfirm:待发货,Confirmed:完成,Archive:归档,Cancelled:取消,Delete:作废
items.batchs.warehouse	调拨出仓库名称	string	调拨出仓库名称
items.batchs.link_warehouse	调拨入仓库名称	string	调拨入仓库名称
items.batchs.f_status	财务状态	string	财务状态 Archive:归档,modifing:变更,WaitConfirm:待审核,Confirmed:已审核,Cancelled:取消,Delete:作废
items.batchs.type	调拨类型	string	调拨类型
items.batchs.wh_id	调拨出仓库编号	string	调拨出仓库编号；主仓=1，销退仓=2，进货仓=3，次品仓 = 4
items.batchs.link_wh_id	调拨入仓库编号	string	调拨入仓库编号；主仓=1，销退仓=2，进货仓=3，次品仓 = 4
items.batchs.link_wms_co_id	调拨入分仓编号，调拨出为接收方，调拨入为发起方	string	调拨入分仓编号，调拨出为接收方，调拨入为发起方
items.batchs.link_io_id	调拨入关联单号	string	调拨入关联单号
items.batchs.so_id	线上单号	string	线上单号
items.batchs.remark	备注	string	备注
items.batchs.creator_name	创建人	string	创建人

金蝶云星空接口明细

调用接口：batchSave
接口名称：分布式调出单新增
方法：POST

请求参数

字段	字段名称	类型	配置值
FBillNo	单据编号	string	{{io_id}}
FOwnerTypeIdHead	调出货主类型	string	BD_OwnerOrg
FBillTypeID	单据类型	string	FBDC01_SYS
FTransferBizType	调拨类型	string	InnerOrgTransfer
FOwnerIdHead	调出货主	string	102
FOwnerTypeInIdHead	调入货主类型	string	BD_OwnerOrg
FTransferDirect	调拨方向	string	GENERAL
FOwnerInIdHead	调入货主	string	102
FStockOrgID	调入库存组织	string	102
FStockInOrgID	调入库存组织	string	102
FDate	日期	string	{{io_date}}
FVESTONWAY	在途归属	string	A
FNOTE	备注	string
FBizType	业务类型	string	NORMAL
FSTKTRSOUTENTRY	明细信息	array	batchs
FSTKTRSOUTENTRY.FMaterialID	物料编码	string	{{batchs.sku_id}}
FSTKTRSOUTENTRY.FLOT	批号	string	{{batchs.batch_no}}
FSTKTRSOUTENTRY.FSrcStockID	调出仓库	string	{{wms_co_id}}
FSTKTRSOUTENTRY.FDestStockID	调入仓库	string	{{link_wms_co_id}}
FSTKTRSOUTENTRY.FSrcStockStatusID	调出库存状态	string	KCZT01_SYS
FSTKTRSOUTENTRY.FDestStockStatusID	在途库存状态	string	KCZT05_SYS
FSTKTRSOUTENTRY.FProduceDate	生产日期	string	{{batchs.product_date}}
FSTKTRSOUTENTRY.FOwnerTypeID	调出货主类型	string	BD_OwnerOrg
FSTKTRSOUTENTRY.FOwnerID	调出货主	string	102
FSTKTRSOUTENTRY.FOwnerTypeInID	调入货主类型	string	BD_OwnerOrg
FSTKTRSOUTENTRY.FKeeperTypeInID	调入保管者类型	string	BD_KeeperOrg
FSTKTRSOUTENTRY.FKeeperInID	调入保管者	string	102
FSTKTRSOUTENTRY.FDestMaterialID	调入物料	string	{{batchs.sku_id}}
FSTKTRSOUTENTRY.FKeeperTypeID	调出保管者类型	string	BD_KeeperOrg
FSTKTRSOUTENTRY.FKeeperID	调出保管者	string	102
FSTKTRSOUTENTRY.FEXPIRYDATE	有效期至	string
FSTKTRSOUTENTRY.FQty	数量	string	{{batchs.qty}}
FSTKTRSOUTENTRY.FormId	业务对象表单Id	string	STK_TRANSFEROUT
FSTKTRSOUTENTRY.Operation	执行的操作	string	BatchSave
FSTKTRSOUTENTRY.IsAutoSubmitAndAudit	提交并审核	bool	false
FSTKTRSOUTENTRY.IsVerifyBaseDataField	验证基础资料	bool	false

系统集成总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。