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

数据源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
目标系统:管易云
管易云是上海管易云计算软件有限公司旗下的专注提供电商企业管理软件服务的品牌,总部位于中国上海张江高科技产业园区。管易云旗下拥有管易云C-ERP、EC-OMS、EC-WMS、B2C/B2B/BBC/微商城开发、PDA无纸化仓储解决方案、新零售一体化解决方案等产品
配置集成方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:管易云,把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细
- 调用接口: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 |
| FStockID_FNumber | 仓库编码 | string | FStockID.FNumber |
| FBeizhu | 备注 | string | FBeizhu |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | PUR_PurchaseOrder |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FPOOrderEntry_FEntryId | id | string | |
| FBillNo | 单据编号 | string | |
| FSourceBillNo | 源单编号 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FBusinessType | 业务类型 | string | |
| FSupplierId_FNumber | 供应商 | string | |
| FSettleModeId_FNumber | 结算方式 | string | |
| FPayConditionId_FNumber | 付款条件 | string | |
| FDate | 采购日期 | string | |
| FDocumentStatus | 单据状态 | string | |
| FPreMatchAmountFor | 预付已核销金额 | string | |
| FPayAdvanceBillId_FNumber | 预付单号 | string | |
| FPurchaseOrgId_FNumber | 采购组织 | string | |
| FPurchaseDeptId_FNumber | 采购部门 | string | |
| FPurchaserGroupId_FNumber | 采购组 | string | |
| FPurchaserId_FNumber | 采购员 | string | |
| FProviderId_FNumber | 供货方 | string | |
| FSettleId_FNumber | 结算方 | string | |
| FChargeId_FNumber | 收款方 | string | |
| FCorrespondOrgId_FNumber | 对应组织 | string | |
| FAssignSupplierId_FNumber | 指定供应商 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FBarcode | 零售条形码 | string | |
| FQty | 采购数量 | string | |
| FDeliveryDate | 交货日期 | string | |
| FLocation | 交货地点 | string | |
| FLocationAddress | 交货地址 | string | |
| FPrice | 单价 | string | |
| FTaxPrice | 含税单价 | string | |
| FEntryDiscountRate | 折扣率% | string | |
| FEntryDiscount | 折扣额 | string | |
| FEntryTaxRate | 税率% | string | |
| FEntryTaxAmount | 税额 | string | |
| FAllAmount | 价税合计 | string | |
| FEntryAmount | 金额 | string | |
| FRequireOrgId_FNumber | 需求组织 | string | |
| FRequireDeptId_FNumber | 需求部门 | string | |
| FRequireStaffId_FNumber | 需求人 | string | |
| FReceiveOrgId_FNumber | 收料组织 | string | |
| FBranchId_FNumber | 收货门店 | string | |
| FReceiveDeptId_FNumber | 收料部门 | string | |
| FEntrySettleOrgId_FNumber | 结算组织 | string | |
| FGiveAway | 是否赠品 | string | |
| FEntryNote | 备注 | string | |
| FSupMatId | 供应商物料编码 | string | |
| FSupMatName | 供应商物料名称 | string | |
| FLot | 批号 | string | |
| FSupplierLot | 供应商批号 | string | |
| FReceiveQty | 累计收料数量 | string | |
| FRemainReceiveQty | 剩余收料数量 | string | |
| FStockInQty | 累计入库数量 | string | |
| FRemainStockINQty | 剩余入库数量 | string | |
| FMrbQty | 累计退料数量 | string | |
| FCHECKRETQTY | 收料可退数量 | string | |
| FSTOCKRETQTY | 库存可退数量 | string | |
| FConsumeSumQty | 消耗汇总数量 | string | |
| FSrcBillTypeId | 源单类型 | string | |
| FSrcBillNo | 源单编号 | string | |
| FReqTraceNo | 需求跟踪号 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FDEMANDTYPE | 需求来源 | string | |
| FDEMANDBILLNO | 需求单据编号 | string | |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | string | |
| FDEMANDBILLENTRYID | 需求单据分录内码 | string | |
| FID | FID | string | |
| FStockID_FNumber | 仓库编码 | string | |
| FBeizhu | 备注 | string | |
管易云接口明细
- API:gy.erp.purchase.add
- NAME:采购订单新增
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| warehouse_code | 仓库代码 | {{FStockID_FNumber}} | |
| supplier_code | 供应商代码 | {{FSupplierId_FNumber}} | |
| order_type | 单据类型代码 | | |
| plan_date | 预计到货时间 | | |
| note | 备注 | {{FBeizhu}} | |
| detail_list | 采购明细 | goods_list | |
| detail_list.barcode | 商品条码 | | |
| detail_list.qty | 数量 | {{goods_list.FQty}} | |
| detail_list.price | 实际进价 | {{goods_list.FTaxPrice}} | |
| detail_list.item_code | 商品代码 | {{goods_list.FMaterialId_FNumber}} | |
| detail_list.sku_code | SKU | {{goods_list.FMaterialId_FNumber}} | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| primaryWriteback | 回写参数 | | |
| primaryWriteback.code | code | {{code}} | |
| primaryWriteback.callBackStrategy | 回写方案 | | |
| primaryWriteback.callBackStrategy.strategyId | 方案ID | ac553632-b644-32c5-8dc4-d477745a3034 | |
| primaryWriteback.callBackStrategy.FID | FID | {{FID}} | |
| primaryWriteback.callBackStrategy.code | code | {{primaryWriteback.code}} | |
| primaryWriteback.callBackStrategy.FBillNo | FBillNo | {{FBillNo}} | |
| primaryWriteback.callBackStrategy.FEntity_FEntryID | FEntity_FEntryID | {{FPOOrderEntry_FEntryId}} | |
| primaryWriteback.callBackStrategy.FMaterialID_FNumber | FMaterialID_FNumber | {{FMaterialId_FNumber}} | |
系统数据集成价值
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。
