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

对接系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统:管易云
管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌,总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品
数据集成方案配置
通过系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为管易云,并且选择对应连接器。选择好对应的gy.erp.purchase.add接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:采购订单查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FPOOrderEntry_FEntryId | id | string | FPOOrderEntry_FEntryId |
| FBillNo | 单据编号 | string | FBillNo |
| FSourceBillNo | 源单编号 | string | FSourceBillNo |
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FBusinessType | 业务类型 | string | FBusinessType |
| FSupplierId_FNumber | 供应商 | string | FSupplierId.FNumber |
| FSettleModeId_FNumber | 结算方式 | string | FSettleModeId.FNumber |
| FPayConditionId_FNumber | 付款条件 | string | FPayConditionId.FNumber |
| FDate | 采购日期 | string | FDate |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FPreMatchAmountFor | 预付已核销金额 | string | FPreMatchAmountFor |
| FPayAdvanceBillId_FNumber | 预付单号 | string | FPayAdvanceBillId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织 | string | FPurchaseOrgId.FNumber |
| FPurchaseDeptId_FNumber | 采购部门 | string | FPurchaseDeptId.FNumber |
| FPurchaserGroupId_FNumber | 采购组 | string | FPurchaserGroupId.FNumber |
| FPurchaserId_FNumber | 采购员 | string | FPurchaserId.FNumber |
| FProviderId_FNumber | 供货方 | string | FProviderId.FNumber |
| FSettleId_FNumber | 结算方 | string | FSettleId.FNumber |
| FChargeId_FNumber | 收款方 | string | FChargeId.FNumber |
| FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
| FAssignSupplierId_FNumber | 指定供应商 | string | FAssignSupplierId.FNumber |
| FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
| FBarcode | 零售条形码 | string | FBarcode |
| FQty | 采购数量 | string | FQty |
| FDeliveryDate | 交货日期 | string | FDeliveryDate |
| FLocation | 交货地点 | string | FLocation |
| FLocationAddress | 交货地址 | string | FLocationAddress |
| FPrice | 单价 | string | FPrice |
| FTaxPrice | 含税单价 | string | FTaxPrice |
| FEntryDiscountRate | 折扣率% | string | FEntryDiscountRate |
| FEntryDiscount | 折扣额 | string | FEntryDiscount |
| FEntryTaxRate | 税率% | string | FEntryTaxRate |
| FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
| FAllAmount | 价税合计 | string | FAllAmount |
| FEntryAmount | 金额 | string | FEntryAmount |
| FRequireOrgId_FNumber | 需求组织 | string | FRequireOrgId.FNumber |
| FRequireDeptId_FNumber | 需求部门 | string | FRequireDeptId.FNumber |
| FRequireStaffId_FNumber | 需求人 | string | FRequireStaffId.FNumber |
| FReceiveOrgId_FNumber | 收料组织 | string | FReceiveOrgId.FNumber |
| FBranchId_FNumber | 收货门店 | string | FBranchId.FNumber |
| FReceiveDeptId_FNumber | 收料部门 | string | FReceiveDeptId.FNumber |
| FEntrySettleOrgId_FNumber | 结算组织 | string | FEntrySettleOrgId.FNumber |
| FGiveAway | 是否赠品 | string | FGiveAway |
| FEntryNote | 备注 | string | FEntryNote |
| FSupMatId | 供应商物料编码 | string | FSupMatId |
| FSupMatName | 供应商物料名称 | string | FSupMatName |
| FLot | 批号 | string | FLot |
| FSupplierLot | 供应商批号 | string | FSupplierLot |
| FReceiveQty | 累计收料数量 | string | FReceiveQty |
| FRemainReceiveQty | 剩余收料数量 | string | FRemainReceiveQty |
| FStockInQty | 累计入库数量 | string | FStockInQty |
| FRemainStockINQty | 剩余入库数量 | string | FRemainStockINQty |
| FMrbQty | 累计退料数量 | string | FMrbQty |
| FCHECKRETQTY | 收料可退数量 | string | FCHECKRETQTY |
| FSTOCKRETQTY | 库存可退数量 | string | FSTOCKRETQTY |
| FConsumeSumQty | 消耗汇总数量 | string | FConsumeSumQty |
| FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FReqTraceNo | 需求跟踪号 | string | FReqTraceNo |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FDEMANDTYPE | 需求来源 | string | FDEMANDTYPE |
| FDEMANDBILLNO | 需求单据编号 | string | FDEMANDBILLNO |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | string | FDEMANDBILLENTRYSEQ |
| FDEMANDBILLENTRYID | 需求单据分录内码 | string | FDEMANDBILLENTRYID |
| FID | FID | string | FID |
| F_mhgj_Base_FNumber | 仓库 | string | F_mhgj_Base.FNumber |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME datetime}}' and F_mhgj_Base.FNumber = 'A01' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | PUR_PurchaseOrder |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FPOOrderEntry_FEntryId | id | string | FPOOrderEntry_FEntryId |
| FBillNo | 单据编号 | string | FBillNo |
| FSourceBillNo | 源单编号 | string | FSourceBillNo |
| FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
| FBusinessType | 业务类型 | string | FBusinessType |
| FSupplierId_FNumber | 供应商 | string | |
| FSettleModeId_FNumber | 结算方式 | string | FSettleModeId.FNumber |
| FPayConditionId_FNumber | 付款条件 | string | FPayConditionId.FNumber |
| FDate | 采购日期 | string | FDate |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FPreMatchAmountFor | 预付已核销金额 | string | FPreMatchAmountFor |
| FPayAdvanceBillId_FNumber | 预付单号 | string | FPayAdvanceBillId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织 | string | FPurchaseOrgId.FNumber |
| FPurchaseDeptId_FNumber | 采购部门 | string | FPurchaseDeptId.FNumber |
| FPurchaserGroupId_FNumber | 采购组 | string | FPurchaserGroupId.FNumber |
| FPurchaserId_FNumber | 采购员 | string | FPurchaserId.FNumber |
| FProviderId_FNumber | 供货方 | string | FProviderId.FNumber |
| FSettleId_FNumber | 结算方 | string | FSettleId.FNumber |
| FChargeId_FNumber | 收款方 | string | FChargeId.FNumber |
| FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
| FAssignSupplierId_FNumber | 指定供应商 | string | FAssignSupplierId.FNumber |
| FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
| FBarcode | 零售条形码 | string | FBarcode |
| FQty | 采购数量 | string | FQty |
| FDeliveryDate | 交货日期 | string | FDeliveryDate |
| FLocation | 交货地点 | string | FLocation |
| FLocationAddress | 交货地址 | string | FLocationAddress |
| FPrice | 单价 | string | FPrice |
| FTaxPrice | 含税单价 | string | FTaxPrice |
| FEntryDiscountRate | 折扣率% | string | FEntryDiscountRate |
| FEntryDiscount | 折扣额 | string | FEntryDiscount |
| FEntryTaxRate | 税率% | string | FEntryTaxRate |
| FEntryTaxAmount | 税额 | string | FEntryTaxAmount |
| FAllAmount | 价税合计 | string | FAllAmount |
| FEntryAmount | 金额 | string | FEntryAmount |
| FRequireOrgId_FNumber | 需求组织 | string | FRequireOrgId.FNumber |
| FRequireDeptId_FNumber | 需求部门 | string | FRequireDeptId.FNumber |
| FRequireStaffId_FNumber | 需求人 | string | FRequireStaffId.FNumber |
| FReceiveOrgId_FNumber | 收料组织 | string | FReceiveOrgId.FNumber |
| FBranchId_FNumber | 收货门店 | string | FBranchId.FNumber |
| FReceiveDeptId_FNumber | 收料部门 | string | FReceiveDeptId.FNumber |
| FEntrySettleOrgId_FNumber | 结算组织 | string | FEntrySettleOrgId.FNumber |
| FGiveAway | 是否赠品 | string | FGiveAway |
| FEntryNote | 备注 | string | FEntryNote |
| FSupMatId | 供应商物料编码 | string | FSupMatId |
| FSupMatName | 供应商物料名称 | string | FSupMatName |
| FLot | 批号 | string | FLot |
| FSupplierLot | 供应商批号 | string | FSupplierLot |
| FReceiveQty | 累计收料数量 | string | FReceiveQty |
| FRemainReceiveQty | 剩余收料数量 | string | FRemainReceiveQty |
| FStockInQty | 累计入库数量 | string | FStockInQty |
| FRemainStockINQty | 剩余入库数量 | string | FRemainStockINQty |
| FMrbQty | 累计退料数量 | string | FMrbQty |
| FCHECKRETQTY | 收料可退数量 | string | FCHECKRETQTY |
| FSTOCKRETQTY | 库存可退数量 | string | FSTOCKRETQTY |
| FConsumeSumQty | 消耗汇总数量 | string | FConsumeSumQty |
| FSrcBillTypeId | 源单类型 | string | FSrcBillTypeId |
| FSrcBillNo | 源单编号 | string | FSrcBillNo |
| FReqTraceNo | 需求跟踪号 | string | FReqTraceNo |
| FMtoNo | 计划跟踪号 | string | FMtoNo |
| FDEMANDTYPE | 需求来源 | string | FDEMANDTYPE |
| FDEMANDBILLNO | 需求单据编号 | string | FDEMANDBILLNO |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | string | FDEMANDBILLENTRYSEQ |
| FDEMANDBILLENTRYID | 需求单据分录内码 | string | FDEMANDBILLENTRYID |
| FID | FID | string | |
| F_mhgj_Base_FNumber | 仓库 | string | F_mhgj_Base.FNumber |
管易云接口明细
- API:gy.erp.purchase.add
- NAME:采购订单新增
- METHOD:POST
请求参数
| 接口字段 | 名称 | 预设值 |
| warehouse_code | 仓库代码 | {{F_mhgj_Base_FNumber}} |
| supplier_code | 供应商代码 | {{FSupplierId_FNumber}} |
| order_type | 单据类型代码 | |
| plan_date | 预计到货时间 | |
| note | 备注 | {{FBillNo}} |
| wms_biz_code | 外部系统单号 | {{FBillNo}} |
| detail_list | 采购明细 | |
| detail_list.barcode | 商品条码 | |
| detail_list.qty | 数量 | {{FQty}} |
| detail_list.price | 实际进价 | {{FTaxPrice}} |
| detail_list.item_code | 商品代码 | {{FMaterialId_FNumber}} |
| detail_list.sku_code | SKU | |
响应参数
| 接口字段 | 名称 | 预设值 |
| primaryWriteback | 回写参数 | |
| primaryWriteback.code | code | {{code}} |
系统打通概况
数据集成中台设计中心Web界面以“拖拽”式交互设计,使用鼠标即可构建设计多异构系统数据集成流程,低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求,结合不同模块即可生成不同业务流程,提升流程设计效率。平台支持多种高度灵活部署,高并发、高性能、高可用,可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒,为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力,保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如:金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。


