聚水潭和金蝶云星空集成接口设计
数据源平台:聚水潭
聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。
写入目标:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据对接方案
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：聚水潭，源系统 API：调拨单查询，目标系统：金蝶云星空，目标系统 API调拨单新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
聚水潭接口明细
- 接口：/open/allocate/query
- 接口名称：调拨单查询
- 接口方法：POST
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| items | 商品集合 | array | 商品集合 |
| items.ioi_id | 子单号 | string | 子单号 |
| items.sku_id | 商品编码 | string | 商品编码 |
| 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.sku_id | 商品编码 | string | 商品编码 |
| items.batchs.qty | 数量 | string | 数量 |
| items.batchs.product_date | 批次日期 | string | 批次日期 |
| items.batchs.supplier_id | 供应商编号 | string | 供应商编号 |
| items.batchs.supplier_name | 供应商名称 | string | 供应商名称 |
| items.batchs.batch_no | 批次号 | string | 批次号 |
| items.batchs.warehouse | 调拨出库名称 | string | 调拨出仓库名称（对应ERP仓库资料设定页面） |
| items.batchs.link_warehouse | 调拨入仓库名称 | string | 调拨入仓库名称（对应ERP仓库资料设定页面） |
| 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 | FBillNo | string | 1 |
| FBillTypeID | FBillTypeID | string | ZJDB01_SYS |
| FBizType | FBizType | string | NORMAL |
| FTransferDirect | FTransferDirect | string | GENERAL |
| FTransferBizType | FTransferBizType | string | InnerOrgTransfer |
| FSaleOrgId | FSaleOrgId | string | 1 |
| FSettleOrgId | FSettleOrgId | string | 1 |
| FStockOutOrgId | FStockOutOrgId | string | 1 |
| FOwnerTypeOutIdHead | FOwnerTypeOutIdHead | string | 1 |
| FOwnerOutIdHead | FOwnerOutIdHead | string | 1 |
| FStockOrgId | FStockOrgId | string | 1 |
| FSETTLECURRID | FSETTLECURRID | string | 1 |
| FDate | FDate | string | 1 |
| FNote | FNote | string | 1 |
| FBillEntry | FBillEntry | array | 1 |
| FMaterialId | FMaterialId | string | 1 |
| FCMKBarCode | FCMKBarCode | string | 1 |
| FQty | FQty | string | 1 |
| FLot | FLot | string | 1 |
| FSrcStockId | FSrcStockId | string | 1 |
| FSrcStockLocId | FSrcStockLocId | string | 1 |
| FDestStockId | FDestStockId | string | 1 |
| FDestStockLocId | FDestStockLocId | string | 1 |
| FNoteEntry | FNoteEntry | string | 1 |
| FISFREE | FISFREE | string | 1 |
| FormId | FormId | string | STK_TransferDirect |
| IsAutoSubmitAndAudit | IsAutoSubmitAndAudit | bool | true |
| IsVerifyBaseDataField | IsVerifyBaseDataField | bool | false |
| Operation | Operation | string | Save |
数据对接效果
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
