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

数据源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接入系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置方案
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的采购退料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器。选择对应的采购退货新增接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:采购退料查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
FPURMRBENTRY_FEntryID | 明细信息ID | string | FPURMRBENTRY_FEntryID |
FID | 实体主键 | string | FID |
FBillNo | 单据编号 | string | FBillNo |
FDocumentStatus | 单据状态 | string | FDocumentStatus |
FStockOrgId_FNumber | 退料组织 | string | FStockOrgId.FNumber |
FDate | 退料日期 | string | FDate |
FBillTypeID_FNumber | 单据类型 | string | FBillTypeID.FNumber |
FTAKEDELIVERYNO | 提货单号 | string | FTAKEDELIVERYNO |
FSupplierID_FNumber | 供应商 | string | FSupplierID.FNumber |
FDESCRIPTION | 备注 | string | FDESCRIPTION |
FCarrierID_FNumber | 承运商 | string | FCarrierID.FNumber |
FDELIVERYNO | 送货单号 | string | FDELIVERYNO |
FPurchaseOrgId_FNumber | 采购组织 | string | FPurchaseOrgId.FNumber |
FMRTYPE | 退料类型 | string | FMRTYPE |
FMRMODE | 退料方式 | string | FMRMODE |
FMRREASON | 退料原因 | string | FMRREASON |
FREPLENISHMODE | 补料方式 | string | FREPLENISHMODE |
FCreateDate | 创建日期 | string | FCreateDate |
FModifyDate | 最后修改日期 | string | FModifyDate |
FApproveDate | 审核日期 | string | FApproveDate |
FCreatorId | 创建人 | string | FCreatorId |
FApproverId | 审核人 | string | FApproverId |
FCancelerId | 作废人 | string | FCancelerId |
FCancelDate | 作废日期 | string | FCancelDate |
FCARRYNO | 运输单号 | string | FCARRYNO |
FCancelStatus | 作废状态 | string | FCancelStatus |
FACCEPTORID_FNumber | 接收方 | string | FACCEPTORID.FNumber |
FSettleId_FNumber | 结算方 | string | FSettleId.FNumber |
FBusinessType | 业务类型 | string | FBusinessType |
FAcceptAddress | 接收方地址 | string | FAcceptAddress |
FCHARGEID_FNumber | 收款方 | string | FCHARGEID.FNumber |
FAPSTATUS | 应付状态 | string | FAPSTATUS |
FTransferBizType | 跨组织业务类型 | string | FTransferBizType |
FCorrespondOrgId_FNumber | 对应组织 | string | FCorrespondOrgId.FNumber |
FSupplyOrderNo | 订单号 | string | FSupplyOrderNo |
FPayOrgId_FNumber | 付款组织 | string | FPayOrgId.FNumber |
FSettleOrgId_FNumber | 结算组织 | string | FSettleOrgId.FNumber |
FSETTLETYPEID_FNumber | 结算方式 | string | FSETTLETYPEID.FNumber |
FPAYCONDITIONID_FNumber | 付款条件 | string | FPAYCONDITIONID.FNumber |
FSettleCurrId_FNumber | 结算币别 | string | FSettleCurrId.FNumber |
FBILLTAXAMOUNT | 税额 | string | FBILLTAXAMOUNT |
FBILLCOSTAMOUNT | 总成本 | string | FBILLCOSTAMOUNT |
FBILLALLAMOUNT | 价税合计 | string | FBILLALLAMOUNT |
FEXCHANGETYPEID_FNumber | 汇率类型 | string | FEXCHANGETYPEID.FNumber |
FIsIncludedTax | 含税 | string | FIsIncludedTax |
FBillAmount | 金额 | string | FBillAmount |
FISGENFORIOS | 跨组织结算生成 | string | FISGENFORIOS |
FSettleSupplierID_FNumber | 结算组织供应商 | string | FSettleSupplierID.FNumber |
FISPRICEEXCLUDETAX | 价外税 | string | FISPRICEEXCLUDETAX |
FISINVOICEARLIER | 先到票后入库 | string | FISINVOICEARLIER |
FTHIRDSRCTYPE | 第三方来源 | string | FTHIRDSRCTYPE |
FTHIRDBILLID | 第三方单据ID | string | FTHIRDBILLID |
FTHIRDBILLNO | 第三方单据编号 | string | FTHIRDBILLNO |
FMATERIALID_FNumber | 物料编码 | string | FMATERIALID.FNumber |
FREPLENISHQTY | 补料数量 | string | FREPLENISHQTY |
FKEAPAMTQTY | 扣款数量 | string | FKEAPAMTQTY |
FSTOCKID_FNumber | 仓库 | string | FSTOCKID.FNumber |
FStockStatusId | 库存状态 | string | FStockStatusId |
FNOTE | 备注 | string | FNOTE |
FProduceDate | 生产日期 | string | FProduceDate |
FEXPIRYDATE | 到期日 | string | FEXPIRYDATE |
FCONTRACTNO | 合同单号 | string | FCONTRACTNO |
FREQTRACENO | 需求跟踪号 | string | FREQTRACENO |
FORDERNO | 订单单号 | string | FORDERNO |
FPRICEUNITQTY | 计价数量 | string | FPRICEUNITQTY |
FCostPrice | 成本价 | string | FCostPrice |
FTAXPRICE | 含税单价 | string | FTAXPRICE |
FDISCOUNTRATE | 折扣率(%) | string | FDISCOUNTRATE |
FTAXNETPRICE | 净价 | string | FTAXNETPRICE |
FENTRYCOSTAMOUNT | 总成本 | string | FENTRYCOSTAMOUNT |
FENTRYTAXRATE | 税率 | string | FENTRYTAXRATE |
FENTRYTAXAMOUNT | 税额 | string | FENTRYTAXAMOUNT |
FALLAMOUNT | 价税合计 | string | FALLAMOUNT |
FOWNERID_FNumber | 货主 | string | FOWNERID.FNumber |
FJOINQTY | 关联数量 | string | FJOINQTY |
FRMREALQTY | 实退数量 | string | FRMREALQTY |
FRMMUSTQTY | 应退数量 | string | FRMMUSTQTY |
FSTOCKLOCID | 仓位 | string | FSTOCKLOCID |
FSRCBillTypeId | 源单类型 | string | FSRCBillTypeId |
FSRCBillNo | 源单编号 | string | FSRCBillNo |
FLot | 批号 | string | FLot |
FPrice | 单价 | string | FPrice |
FAmount | 金额 | string | FAmount |
FDiscount | 折扣额 | string | FDiscount |
FBFLowId | 业务流程 | string | FBFLowId |
FSRCSeq | 源单行号 | string | FSRCSeq |
FMtoNo | 计划跟踪号 | string | FMtoNo |
FIsStock | 是否可库存 | string | FIsStock |
FGiveAway | 是否赠品 | string | FGiveAway |
FRowId | 行标识 | string | FRowId |
FParentRowId | 父行标识 | string | FParentRowId |
FBarcode | 零售条形码 | string | FBarcode |
FPRICEUNITID | 计价单位 | string | FPRICEUNITID |
FUnitID | 库存单位 | string | FUnitID |
FCarryUnitId | 采购单位 | string | FCarryUnitId |
FCarryQty | 采购数量 | string | FCarryQty |
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_MRB |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
FPURMRBENTRY_FEntryID | 明细信息ID | string | |
FID | 实体主键 | string | |
FBillNo | 单据编号 | string | |
FDocumentStatus | 单据状态 | string | |
FStockOrgId_FNumber | 退料组织 | string | |
FDate | 退料日期 | string | |
FBillTypeID_FNumber | 单据类型 | string | |
FTAKEDELIVERYNO | 提货单号 | string | |
FSupplierID_FNumber | 供应商 | string | |
FDESCRIPTION | 备注 | string | |
FCarrierID_FNumber | 承运商 | string | |
FDELIVERYNO | 送货单号 | string | |
FPurchaseOrgId_FNumber | 采购组织 | string | |
FMRTYPE | 退料类型 | string | |
FMRMODE | 退料方式 | string | |
FMRREASON | 退料原因 | string | |
FREPLENISHMODE | 补料方式 | string | |
FCreateDate | 创建日期 | string | |
FModifyDate | 最后修改日期 | string | |
FApproveDate | 审核日期 | string | |
FCreatorId | 创建人 | string | |
FApproverId | 审核人 | string | |
FCancelerId | 作废人 | string | |
FCancelDate | 作废日期 | string | |
FCARRYNO | 运输单号 | string | |
FCancelStatus | 作废状态 | string | |
FACCEPTORID_FNumber | 接收方 | string | |
FSettleId_FNumber | 结算方 | string | |
FBusinessType | 业务类型 | string | |
FAcceptAddress | 接收方地址 | string | |
FCHARGEID_FNumber | 收款方 | string | |
FAPSTATUS | 应付状态 | string | |
FTransferBizType | 跨组织业务类型 | string | |
FCorrespondOrgId_FNumber | 对应组织 | string | |
FSupplyOrderNo | 订单号 | string | |
FPayOrgId_FNumber | 付款组织 | string | |
FSettleOrgId_FNumber | 结算组织 | string | |
FSETTLETYPEID_FNumber | 结算方式 | string | |
FPAYCONDITIONID_FNumber | 付款条件 | string | |
FSettleCurrId_FNumber | 结算币别 | string | |
FBILLTAXAMOUNT | 税额 | string | |
FBILLCOSTAMOUNT | 总成本 | string | |
FBILLALLAMOUNT | 价税合计 | string | |
FEXCHANGETYPEID_FNumber | 汇率类型 | string | |
FIsIncludedTax | 含税 | string | |
FBillAmount | 金额 | string | |
FISGENFORIOS | 跨组织结算生成 | string | |
FSettleSupplierID_FNumber | 结算组织供应商 | string | |
FISPRICEEXCLUDETAX | 价外税 | string | |
FISINVOICEARLIER | 先到票后入库 | string | |
FTHIRDSRCTYPE | 第三方来源 | string | |
FTHIRDBILLID | 第三方单据ID | string | |
FTHIRDBILLNO | 第三方单据编号 | string | |
FMATERIALID_FNumber | 物料编码 | string | |
FREPLENISHQTY | 补料数量 | string | |
FKEAPAMTQTY | 扣款数量 | string | |
FSTOCKID_FNumber | 仓库 | string | |
FStockStatusId | 库存状态 | string | |
FNOTE | 备注 | string | |
FProduceDate | 生产日期 | string | |
FEXPIRYDATE | 到期日 | string | |
FCONTRACTNO | 合同单号 | string | |
FREQTRACENO | 需求跟踪号 | string | |
FORDERNO | 订单单号 | string | |
FPRICEUNITQTY | 计价数量 | string | |
FCostPrice | 成本价 | string | |
FTAXPRICE | 含税单价 | string | |
FDISCOUNTRATE | 折扣率(%) | string | |
FTAXNETPRICE | 净价 | string | |
FENTRYCOSTAMOUNT | 总成本 | string | |
FENTRYTAXRATE | 税率 | string | |
FENTRYTAXAMOUNT | 税额 | string | |
FALLAMOUNT | 价税合计 | string | |
FOWNERID_FNumber | 货主 | string | |
FJOINQTY | 关联数量 | string | |
FRMREALQTY | 实退数量 | string | |
FRMMUSTQTY | 应退数量 | string | |
FSTOCKLOCID | 仓位 | string | |
FSRCBillTypeId | 源单类型 | string | |
FSRCBillNo | 源单编号 | string | |
FLot | 批号 | string | |
FPrice | 单价 | string | |
FAmount | 金额 | string | |
FDiscount | 折扣额 | string | |
FBFLowId | 业务流程 | string | |
FSRCSeq | 源单行号 | string | |
FMtoNo | 计划跟踪号 | string | |
FIsStock | 是否可库存 | string | |
FGiveAway | 是否赠品 | string | |
FRowId | 行标识 | string | |
FParentRowId | 父行标识 | string | |
FBarcode | 零售条形码 | string | |
FPRICEUNITID | 计价单位 | string | |
FUnitID | 库存单位 | string | |
FCarryUnitId | 采购单位 | string | |
FCarryQty | 采购数量 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:采购退货新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{FBillNo}} | 单据编号 |
FDate | 退料日期 | {{FDate}} | 日期 |
FSupplierID | 供应商 | VEN00001 | 基础资料 |
FMRTYPE | 退料类型 | {{FMRTYPE}} | 下拉列表 |
FMRMODE | 退料方式 | {{FMRMODE}} | 下拉列表 |
FStockOrgId | 退料组织 | 100 | 组织 |
FDESCRIPTION | 备注 | 测试 | 多行文本 |
FSettleOrgId | 结算组织 | 100 | 组织 |
FSettleCurrId | 结算币别 | PRE001 | 基础资料 |
FPayOrgId | 付款组织 | 100 | 组织 |
FPURMRBENTRY | 明细信息 | | 明细信息 |
FPURMRBENTRY.FMATERIALID | 物料编码 | ST00001-a | 基础资料 |
FPURMRBENTRY.FRMREALQTY | 实退数量 | 2 | 数量 |
FPURMRBENTRY.FSTOCKID | 仓库 | CK001 | 基础资料 |
FPURMRBENTRY.FNOTE | 备注 | 测试 | 文本 |
FPURMRBENTRY.FPrice | 单价 | {{FPrice}} | 单价 |
FPURMRBENTRY.FPRICEUNITID | 计价单位 | Pcs | |
FPURMRBENTRY.FUnitID | 库存单位 | Pcs | |
FPURMRBENTRY.FCarryUnitId | 采购单位 | Pcs | |
FPURMRBENTRY.FSTOCKLOCID | 仓位 | | |
FPURMRBENTRY.FormId | 业务对象表单Id | PUR_MRB | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FPURMRBENTRY.Operation | 执行的操作 | batchSave | |
FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | true | |
FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FPURMRBENTRY.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
数据对接价值
数据集成中台设计中心Web界面以“拖拽”式交互设计,使用鼠标即可构建设计多异构系统数据集成流程,低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求,结合不同模块即可生成不同业务流程,提升流程设计效率。平台支持多种高度灵活部署,高并发、高性能、高可用,可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒,为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力,保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如:金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
