金蝶云星空对接打通轻易云集成平台物料查询接口与物料新增接口
对接系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
写入目标:轻易云集成平台
从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成
数据对接方案
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：物料查询，目标系统：轻易云集成平台，目标系统 API物料新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：物料查询
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FMasterId | id | string | FMasterId |
| FNumber | 编码 | string | FNumber |
| FName | 名称 | string | FName |
| FSpecification | 规格型号 | string | FSpecification |
| FMnemonicCode | 助记码 | string | FMnemonicCode |
| FOldNumber | 旧物料编码 | string | FOldNumber |
| FBARCODE | 条码 | string | FBARCODE |
| FDescription | 描述 | string | FDescription |
| FMaterialGroup_FNumber | 物料分组 | string | FMaterialGroup.FNumber |
| FErpClsID | 物料属性 | string | FErpClsID |
| FDocumentStatus | 数据状态 | string | FDocumentStatus |
| FForbidStatus | 禁用状态 | string | FForbidStatus |
| FBaseUnitId_FNumber | 基本单位.编码 | string | FBaseUnitId.FNumber |
| FCreateOrgId_FNumber | 创建组织 | string | FCreateOrgId.FNumber |
| FUseOrgId_FNumber | 使用组织 | string | FUseOrgId.FNumber |
| FIsInventory | 允许库存 | string | FIsInventory |
| FIsSale | 允许销售 | string | FIsSale |
| FIsAsset | 允许资产 | string | FIsAsset |
| FIsSubContract | 允许委外 | string | FIsSubContract |
| FIsProduce | 允许生产 | string | FIsProduce |
| FIsPurchase | 允许采购 | string | FIsPurchase |
| FStockId_FNumber | 仓库 | string | FStockId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织.编码 | string | FPurchaseOrgId.FNumber |
| FPurchaseOrgId_FName | 采购组织 | string | FPurchaseOrgId.FName |
| FIsBatchManage | 启用批号管理 | string | FIsBatchManage |
| FIsKFPeriod | 启用保质期管理 | string | FIsKFPeriod |
| FIsSNManage | 启用序列号管理 | string | FIsSNManage |
| FSafeStock | 安全库存 | string | FSafeStock |
| FCategoryID | 存货类别 | string | FCategoryID |
| FExpPeriod | 保质期 | string | FExpPeriod |
| FOrderQty | 起订量 | string | FOrderQty |
| FMinQty | 最小批量 | string | FMinQty |
| FMaxQty | 最大批量 | string | FMaxQty |
| FDefaultVendor_FNumber | 默认供应商 | string | FDefaultVendor.FNumber |
| FMaxPOQty | 最大订货量 | string | FMaxPOQty |
| FMinPOQty | 最小订货量 | string | FMinPOQty |
| FIncreaseQty | 最小包装量 | string | FIncreaseQty |
| FFixLeadTime | 固定提前期 | string | FFixLeadTime |
| FVarLeadTime | 变动提前期 | string | FVarLeadTime |
| FPlanBatchSplitQty | 拆分批量 | string | FPlanBatchSplitQty |
| FProduceBillType_FNumber | 生产类型 | string | FProduceBillType.FNumber |
| FPOBillTypeId_FNumber | 采购类型 | string | FPOBillTypeId.FNumber |
| FSubBillType_FNumber | 委外类型 | string | FSubBillType.FNumber |
| FGROSSWEIGHT | 毛重 | string | FGROSSWEIGHT |
| FNETWEIGHT | 净重 | string | FNETWEIGHT |
| FWEIGHTUNITID_FNumber | 重量单位 | string | FWEIGHTUNITID.FNumber |
| FLENGTH | 长 | string | FLENGTH |
| FWIDTH | 宽 | string | FWIDTH |
| FHEIGHT | 高 | string | FHEIGHT |
| FVOLUME | 体积 | string | FVOLUME |
| FWARRANTY | 保修期 | string | FWARRANTY |
| FSalePrice_CMK | 零售价 | string | FSalePrice_CMK |
| FVIPPrice_CMK | 会员价 | string | FVIPPrice_CMK |
| FPurPrice_CMK | 采购单价 | string | FPurPrice_CMK |
| FComBrandId_CMK_FNumber | 品牌 | string | FComBrandId_CMK.FNumber |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FCreateOrgId.FNumber = '100' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | BD_MATERIAL |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FMasterId | id | string | |
| FNumber | 编码 | string | |
| FName | 名称 | string | |
| FSpecification | 规格型号 | string | |
| FMnemonicCode | 助记码 | string | |
| FOldNumber | 旧物料编码 | string | |
| FBARCODE | 条码 | string | |
| FDescription | 描述 | string | |
| FMaterialGroup_FNumber | 物料分组 | string | |
| FErpClsID | 物料属性 | string | |
| FDocumentStatus | 数据状态 | string | |
| FForbidStatus | 禁用状态 | string | |
| FBaseUnitId_FNumber | 基本单位.编码 | string | |
| FCreateOrgId_FNumber | 创建组织 | string | |
| FUseOrgId_FNumber | 使用组织 | string | |
| FIsInventory | 允许库存 | string | |
| FIsSale | 允许销售 | string | |
| FIsAsset | 允许资产 | string | |
| FIsSubContract | 允许委外 | string | |
| FIsProduce | 允许生产 | string | |
| FIsPurchase | 允许采购 | string | |
| FStockId_FNumber | 仓库 | string | |
| FPurchaseOrgId_FNumber | 采购组织.编码 | string | |
| FPurchaseOrgId_FName | 采购组织 | string | |
| FIsBatchManage | 启用批号管理 | string | |
| FIsKFPeriod | 启用保质期管理 | string | |
| FIsSNManage | 启用序列号管理 | string | |
| FSafeStock | 安全库存 | string | |
| FCategoryID | 存货类别 | string | |
| FExpPeriod | 保质期 | string | |
| FOrderQty | 起订量 | string | |
| FMinQty | 最小批量 | string | |
| FMaxQty | 最大批量 | string | |
| FDefaultVendor_FNumber | 默认供应商 | string | |
| FMaxPOQty | 最大订货量 | string | |
| FMinPOQty | 最小订货量 | string | |
| FIncreaseQty | 最小包装量 | string | |
| FFixLeadTime | 固定提前期 | string | |
| FVarLeadTime | 变动提前期 | string | |
| FPlanBatchSplitQty | 拆分批量 | string | |
| FProduceBillType_FNumber | 生产类型 | string | |
| FPOBillTypeId_FNumber | 采购类型 | string | |
| FSubBillType_FNumber | 委外类型 | string | |
| FGROSSWEIGHT | 毛重 | string | |
| FNETWEIGHT | 净重 | string | |
| FWEIGHTUNITID_FNumber | 重量单位 | string | |
| FLENGTH | 长 | string | |
| FWIDTH | 宽 | string | |
| FHEIGHT | 高 | string | |
| FVOLUME | 体积 | string | |
| FWARRANTY | 保修期 | string | |
| FSalePrice_CMK | 零售价 | string | |
| FVIPPrice_CMK | 会员价 | string | |
| FPurPrice_CMK | 采购单价 | string | |
| FComBrandId_CMK_FNumber | 品牌 | string | |
轻易云集成平台接口明细
- 调用接口：batchSave
- 接口名称：物料新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FName | 名称 | string | |
| FNumber | 编码 | string | |
| FDescription | 描述 | string | |
| FCreateOrgId | 创建组织 | string | |
| FUseOrgId | 使用组织 | string | |
| FSpecification | 规格型号 | string | |
| FMnemonicCode | 助记码 | string | |
| FMaterialGroup | 物料分组 | string | |
| SubHeadEntity | 基本 | object | |
| SubHeadEntity.FErpClsID | 物料属性 | string | |
| SubHeadEntity.FBaseUnitId | 基本单位 | string | |
| SubHeadEntity.FCategoryID | 存货类别 | string | |
| SubHeadEntity.FBARCODE | 条形码 | string | |
| SubHeadEntity.SubHeadEntity1 | 库存 | object | |
| SubHeadEntity.SubHeadEntity1.FStockId | 仓库 | string | |
| SubHeadEntity.SubHeadEntity1.FSafeStock | 安全库存 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2 | 销售 | object | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMaxQty | 最大批量 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.FMinQty | 最小批量 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3 | 采购 | object | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FDefaultVendor | 默认供应商 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FPurchaseOrgId | 采购组织 | string | |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.FormId | 业务对象表单Id | string | BD_MATERIAL |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.Operation | 执行的操作 | string | Save |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| SubHeadEntity.SubHeadEntity1.SubHeadEntity2.SubHeadEntity3.IsVerifyBaseDataField | 验证基础资料 | bool | false |
数据对接效果
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与轻易云集成平台之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
