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

接入系统:金蝶云星空
金蝶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治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
