金蝶云星空和管易云集成接口设计
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统：管易云
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。
接口方案配置
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
金蝶云星空接口明细
- 调用接口：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 FAFFAIRTYPE = 'Assembly' |
| 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 | |
管易云接口明细
- 接口：gy.erp.stock.other.in.add
- 接口名称：其他入库单新增完结接口
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| details.stockDate | 入库日期 | string |
| details.batchNumber | 批次号 | string |
| note | 备注 | string |
| warehouse_code | 仓库代码 | string |
| details.uniqueCode | 唯一码 | string |
| details | 入库明细 | array |
| details.manufacturingDate | 生产日期 | string |
| details.qty | 数量 | string |
| details.sku_code | 规格代码 | string |
| details.barcode | 商品条码 | string |
| details.wms_bizcode | 第三方系统单号 | string |
| details.item_code | 商品代码 | string |
| type | 入库类型代码 | string |
| details.shelfLife | 有效期 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| success | 成功与否 | string | |
| errorCode | 错误代码 | string | |
| subErrorCode | 子错误代码 | string | |
| errorDesc | 错误描述 | string | |
| subErrorDesc | 子错误描述 | string | |
| requestMethod | 请求方法 | string | |
| code | 其他入库单单据编号 | string | |
数据对接效果
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
