金蝶云星空和聚水潭集成接口设计
接入系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
写入目标:聚水潭
聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。
数据接口配置
使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的组装拆卸单查询(成品)作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭,并且选择对应连接器（关于聚水潭的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的新建其它出入库（新）接口作为数据写入动作，既可以完成第一步的数据对接配置。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：组装拆卸单查询(成品)
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FStockOrgId_FNumber | 库存组织 | string | FStockOrgId.FNumber |
| FDate | 日期 | string | FDate |
| FBillTypeID | 单据类型 | string | FBillTypeID |
| FOwnerTypeIdHead | 成品货主类型 | string | FOwnerTypeIdHead |
| FOwnerIdHead_FNumber | 成品货主 | string | FOwnerIdHead.FNumber |
| FAffairType | 事务类型 | string | FAffairType |
| FEE | 费用 | string | FEE |
| FDeptID_FNumber | 部门 | string | FDeptID.FNumber |
| FNote | 备注 | string | FNote |
| FCreateDate | 创建日期 | string | FCreateDate |
| FModifyDate | 最后修改日期 | string | FModifyDate |
| FAPPROVEDATE | 审核日期 | string | FAPPROVEDATE |
| FCANCELDATE | 作废日期 | string | FCANCELDATE |
| FCANCELSTATUS | 作废状态 | string | FCANCELSTATUS |
| FSubProOwnTypeIdH | 子件货主类型 | string | FSubProOwnTypeIdH |
| FSubProOwnerIdH_FNumber | 子件货主 | string | FSubProOwnerIdH.FNumber |
| FRowType | 行类型 | string | FRowType |
| FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
| FMaterialID_FBARCODE | 物料编码 | string | FMaterialID.FBARCODE |
| FUnitID_FNumber | 单位 | string | FUnitID.FNumber |
| FQty | 数量 | string | FQty |
| Fee_ETY | 费用 | string | Fee_ETY |
| FStockID_FNumber | 仓库 | string | FStockID.FNumber |
| FStockStatusID | 库存状态 | string | FStockStatusID |
| FDescription | 备注 | string | FDescription |
| FMTONO | 计划跟踪号 | string | FMTONO |
| FOwnerTypeID | 货主类型 | string | FOwnerTypeID |
| FOwnerID_FNumber | 货主 | string | FOwnerID.FNumber |
| FKeeperTypeID | 保管者类型 | string | FKeeperTypeID |
| FKeeperID_FNumber | 保管者 | string | FKeeperID.FNumber |
| FBomID | BOM版本 | string | FBomID |
| FProduceDate | 生产日期 | string | FProduceDate |
| FEXPIRYDATE | 有效期至 | string | FEXPIRYDATE |
| FLOT_FNumber | 批号 | string | FLOT.FNumber |
| FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FEntity_FEntryID | FEntity_FEntryID | string | FEntity_FEntryID |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FMaterialID.FIsSalseByNet=1 and FAFFAIRTYPE = 'Dassembly' AND FStockID.FNumber IN ('11084916') |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | STK_AssembledApp |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FOwnerTypeIdHead | 成品货主类型 | string | |
| FOwnerIdHead_FNumber | 成品货主 | string | |
| FAffairType | 事务类型 | string | |
| FEE | 费用 | string | |
| FDeptID_FNumber | 部门 | string | |
| FNote | 备注 | string | |
| FCreateDate | 创建日期 | string | |
| FModifyDate | 最后修改日期 | string | |
| FAPPROVEDATE | 审核日期 | string | |
| FCANCELDATE | 作废日期 | string | |
| FCANCELSTATUS | 作废状态 | string | |
| FSubProOwnTypeIdH | 子件货主类型 | string | |
| FSubProOwnerIdH_FNumber | 子件货主 | string | |
| FRowType | 行类型 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FMaterialID_FBARCODE | 物料编码 | string | |
| FUnitID_FNumber | 单位 | string | |
| FQty | 数量 | string | |
| Fee_ETY | 费用 | string | |
| FStockID_FNumber | 仓库 | string | |
| FStockStatusID | 库存状态 | string | |
| FDescription | 备注 | string | |
| FMTONO | 计划跟踪号 | string | |
| FOwnerTypeID | 货主类型 | string | |
| FOwnerID_FNumber | 货主 | string | |
| FKeeperTypeID | 保管者类型 | string | |
| FKeeperID_FNumber | 保管者 | string | |
| FBomID | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FEXPIRYDATE | 有效期至 | string | |
| FLOT_FNumber | 批号 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FEntity_FEntryID | FEntity_FEntryID | string | |
聚水潭接口明细
- 接口：jushuitan.otherinout.upload
- 接口名称：新建其它出入库（新）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| receiver_state | 收件地址省 | string |
| receiver_district | 收件地址区 | 县 | string |
| items | 商品列表 | array |
| receiver_mobile | 收件人手机号 | string |
| items.expiration_date | 有效期至，系统中需开启相关配置 | string |
| items.batch_id | 批次单号，系统中需开启相关配置 | string |
| type | 出入库类型: in是入库 out是出库 | string |
| items.produced_date | 生产日期，系统中需开启相关配置 | string |
| drp_co_name | 出库类型 | string |
| is_confirm | 是否自动确认单据 | string |
| items.sku_id | 商品编码 | string |
| receiver_name | 收件人姓名 | string |
| items.remark | 备注 | string |
| external_id | 外部单号 | string |
| receiver_city | 收件地址市 | string |
| items.qty | 数量 | string |
| warehouse | 主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 | string |
| receiver_address | 收件详细地址 | string |
| wms_co_id | 分仓编号 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| code | 非0失败 | string | 非0失败 |
| msg | 错误描述 | string | 错误描述 |
| data | 返回内容 | array | 返回内容 |
| data.external_id | 外部单号 | string | 外部单号 |
| data.io_id | 系统内部单号 | string | 系统内部单号 |
系统打通概况
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到聚水潭之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
