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

源系统:聚水潭

聚水潭是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商品编码stringsku_id items.batchs.qty数量stringqty 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调出货主类型stringBD_OwnerOrg FBillTypeID单据类型stringFBDC01_SYS FTransferBizType调拨类型stringInnerOrgTransfer FOwnerIdHead调出货主string102 FOwnerTypeInIdHead调入货主类型stringBD_OwnerOrg FTransferDirect调拨方向stringGENERAL FOwnerInIdHead调入货主string102 FStockOrgID调入库存组织string102 FStockInOrgID调入库存组织string102 FDate日期string{{io_date}} FVESTONWAY在途归属stringA FNOTE备注string FBizType业务类型stringNORMAL FSTKTRSOUTENTRY明细信息arraybatchs 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调出库存状态stringKCZT01_SYS FSTKTRSOUTENTRY.FDestStockStatusID在途库存状态stringKCZT05_SYS FSTKTRSOUTENTRY.FProduceDate生产日期string{{batchs.product_date}} FSTKTRSOUTENTRY.FOwnerTypeID调出货主类型stringBD_OwnerOrg FSTKTRSOUTENTRY.FOwnerID调出货主string102 FSTKTRSOUTENTRY.FOwnerTypeInID调入货主类型stringBD_OwnerOrg FSTKTRSOUTENTRY.FKeeperTypeInID调入保管者类型stringBD_KeeperOrg FSTKTRSOUTENTRY.FKeeperInID调入保管者string102 FSTKTRSOUTENTRY.FDestMaterialID调入物料string{{batchs.sku_id}} FSTKTRSOUTENTRY.FKeeperTypeID调出保管者类型stringBD_KeeperOrg FSTKTRSOUTENTRY.FKeeperID调出保管者string102 FSTKTRSOUTENTRY.FEXPIRYDATE有效期至string FSTKTRSOUTENTRY.FQty数量string{{batchs.qty}} FSTKTRSOUTENTRY.FormId业务对象表单IdstringSTK_TRANSFEROUT FSTKTRSOUTENTRY.Operation执行的操作stringBatchSave FSTKTRSOUTENTRY.IsAutoSubmitAndAudit提交并审核boolfalse FSTKTRSOUTENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统集成总览

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

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