金蝶云星空和管易云接口打通对接实战

接入系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
目标系统:管易云
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌,先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务,涵盖电商业务全流程。
数据接口配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:组装拆卸单查询(成品),目标系统:管易云,目标系统 API其他入库单新增完结接口。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。


金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:组装拆卸单查询(成品)
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FID | 实体主键 | string | FID |
| FEntity_FEntryID | 分录主键 | string | FEntity_FEntryID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FStockOrgId_FNumber | 库存组织 | string | FStockOrgId.FNumber |
| FDate | 日期 | string | FDate |
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FOwnerIdHead_FNumber | 成品货主 | string | FOwnerIdHead.FNumber |
| FAffairType | 事务类型 | string | FAffairType |
| FEE | 费用 | string | FEE |
| FDeptID_FNumber | 部门 | string | FDeptID.FNumber |
| FNote | 备注 | string | FNote |
| FSubProOwnerIdH_FNumber | 子件货主 | string | FSubProOwnerIdH.FNumber |
| FRowType | 行类型 | string | FRowType |
| FMaterialID_FNumber | 物料编码 | string | FMaterialID.FNumber |
| FUnitID | 单位 | string | FUnitID |
| FQty | 数量 | string | FQty |
| Fee_ETY | 费用 | string | Fee_ETY |
| FStockID_FNumber | 仓库 | string | FStockID.FNumber |
| FStockStatusID | 库存状态 | string | FStockStatusID |
| FDescription | 备注 | string | FDescription |
| FMTONO | 计划跟踪号 | string | FMTONO |
| FProjectNo | 项目编号 | string | FProjectNo |
| 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 |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| FStockFlag | 已更新库存 | string | FStockFlag |
| FStockLocId | 仓位 | string | FStockLocId |
| FLOT | 批号 | string | FLOT |
| FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FInstockDate | 入库日期 | string | FInstockDate |
| 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 | |
| FEntity_FEntryID | 分录主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FOwnerIdHead_FNumber | 成品货主 | string | |
| FAffairType | 事务类型 | string | |
| FEE | 费用 | string | |
| FDeptID_FNumber | 部门 | string | |
| FNote | 备注 | string | |
| FSubProOwnerIdH_FNumber | 子件货主 | string | |
| FRowType | 行类型 | string | |
| FMaterialID_FNumber | 物料编码 | string | |
| FUnitID | 单位 | string | |
| FQty | 数量 | string | |
| Fee_ETY | 费用 | string | |
| FStockID_FNumber | 仓库 | string | |
| FStockStatusID | 库存状态 | string | |
| FDescription | 备注 | string | |
| FMTONO | 计划跟踪号 | string | |
| FProjectNo | 项目编号 | string | |
| FOwnerTypeID | 货主类型 | string | |
| FOwnerID_FNumber | 货主 | string | |
| FKeeperTypeID | 保管者类型 | string | |
| FKeeperID_FNumber | 保管者 | string | |
| FBomID | BOM版本 | string | |
| FProduceDate | 生产日期 | string | |
| FEXPIRYDATE | 有效期至 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FStockFlag | 已更新库存 | string | |
| FStockLocId | 仓位 | string | |
| FLOT | 批号 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FInstockDate | 入库日期 | string | |
管易云接口明细
- API:gy.erp.stock.other.in.add
- NAME:其他入库单新增完结接口
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| warehouse_code | 仓库代码 | {{FStockID_FNumber}} | |
| type | 入库类型代码 | ZZRK | |
| note | 备注 | 金蝶组装物料入库{{FBillNo}}{{FStockID_FNumber}} | |
| details | 入库明细 | details | |
| details.item_code | 商品代码 | {{details.FMaterialID_FNumber}} | |
| details.sku_code | 规格代码 | | |
| details.barcode | 商品条码 | | |
| details.qty | 数量 | {{details.FQty}} | |
| details.uniqueCode | 唯一码 | | |
| details.batchNumber | 批次号 | | |
| details.manufacturingDate | 生产日期 | | |
| details.shelfLife | 有效期 | | |
| details.stockDate | 入库日期 | | |
| details.wms_bizcode | 第三方系统单号 | bsdl{{FBillNo}}{{FStockID_FNumber}} | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| success | 成功与否 | | |
| errorCode | 错误代码 | | |
| subErrorCode | 子错误代码 | | |
| errorDesc | 错误描述 | | |
| subErrorDesc | 子错误描述 | | |
| requestMethod | 请求方法 | | |
| code | 其他入库单单据编号 | | |
系统集成总览
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
