金蝶云星空和轻易云集成平台接口打通对接实战

金蝶云星空和轻易云集成平台接口打通对接实战

接通系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接通系统：轻易云集成平台

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成

数据接口配置方案

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：收款退款单查询
• METHOD：POST

请求参数

接口字段名称预设值 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryID FID实体主键FID FBillNo单据编号FBillNo FDOCUMENTSTATUS单据状态FDOCUMENTSTATUS FCreaterId创建人FCreaterId FCreateDate创建日期FCreateDate FSETTLEORGID.FNumber结算组织FSETTLEORGID FApproveDate审核日期FApproveDate FSALEORGID销售组织FSALEORGID.FNumber FEXCHANGETYPE汇率类型FEXCHANGETYPE FMAINBOOKCURRID本位币FMAINBOOKCURRID.FNumber FREFUNDTOTALAMOUNT应退金额本位币FREFUNDTOTALAMOUNT FDATE业务日期FDATE FCURRENCYID币别FCURRENCYID.FNumber FModifyDate修改日期FModifyDate FModifierId修改人FModifierId FEXCHANGERATE汇率FEXCHANGERATE FWRITTENOFFSTATUS核销状态FWRITTENOFFSTATUS FBillTypeID单据类型FBillTypeID.FNumber FREFUNDTOTALAMOUNTFOR表头-应退金额FREFUNDTOTALAMOUNTFOR FSALEERID销售员FSALEERID.FNumber FSALEGROUPID销售组FSALEGROUPID.FNumber FSALEDEPTID销售部门FSALEDEPTID.FNumber FAPPROVERID审核人FAPPROVERID FREALREFUNDAMOUNTFOR表头-实退金额FREALREFUNDAMOUNTFOR FREALREFUNDAMOUNT实退金额本位币FREALREFUNDAMOUNT FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM FCancelDate作废日期FCancelDate FCancellerId作废人FCancellerId FCancelStatus作废状态FCancelStatus FRECTUNITTYPE收款单位类型FRECTUNITTYPE FCONTACTUNIT往来单位FCONTACTUNIT.FNumber FCONTACTUNITTYPE往来单位类型FCONTACTUNITTYPE FRECTUNIT收款单位FRECTUNIT.FNumber FBUSINESSTYPE业务类型FBUSINESSTYPE FCreditCheckResult信用检查结果FCreditCheckResult FISINIT是否期初单据FISINIT FDepartment部门FDepartment.FNumber FPAYORGID付款组织FPAYORGID.FNumber FISSAMEORG是否相同组织FISSAMEORG FSETTLECUR结算币别FSETTLECUR FSETTLERATE结算汇率FSETTLERATE FREFUNDAMOUNT_H表头-退款金额本位币FREFUNDAMOUNT_H FREFUNDAMOUNTFOR_H退款金额FREFUNDAMOUNTFOR_H FISB2CB2C业务FISB2C FSOURCESYSTEM来源系统FSOURCESYSTEM FIsWriteOff是否转销FIsWriteOff FMatchMethodID核销方式FMatchMethodID FScanPoint扫描点FScanPoint FREMARK备注FREMARK FBookingDate期望付款日期FBookingDate FTHIRDBILLNO第三方单据编号FTHIRDBILLNO FWBSETTLENO流水号FWBSETTLENO FSETTLEMAINBOOKID结算本位币FSETTLEMAINBOOKID FSETTLEEXCHANGETYPE结算汇率类型FSETTLEEXCHANGETYPE FISFROMTRADEBANK来源交易明细FISFROMTRADEBANK FGYACCOUNTWATERID管易财务流水内码FGYACCOUNTWATERID FISCARRYRATE是否下推携带汇率到结算汇率FISCARRYRATE FPRESETBASE2预设基础资料字段2FPRESETBASE2 FPRESETBASE1预设基础资料字段1FPRESETBASE1 FCASHSALE现销FCASHSALE FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FISFROMALLREFUND是否来源于整单退款FISFROMALLREFUND FVirIsSameAcctOrg是否同一核算组织FVirIsSameAcctOrg FSETTLETYPEID结算方式FSETTLETYPEID FREFUNDAMOUNTFOR表体-应退金额FREFUNDAMOUNTFOR FNOTE备注FNOTE FWRITTENOFFSTATUS_D表体明细-核销状态FWRITTENOFFSTATUS_D FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额FWRITTENOFFAMOUNTFOR_D FOPPOSITEBANKACCOUNT对方银行账号FOPPOSITEBANKACCOUNT FOPPOSITECCOUNTNAME对方账户名称FOPPOSITECCOUNTNAME FREFUNDAMOUNT应退金额本位币FREFUNDAMOUNT FHANDLINGCHARGEFOR手续费FHANDLINGCHARGEFOR FREALREFUNDAMOUNTFOR_D表体-实退金额FREALREFUNDAMOUNTFOR_D FHANDLINGCHARGE手续费本位币FHANDLINGCHARGE FREALREFUNDAMOUNT_D实退金额本位币FREALREFUNDAMOUNT_D FACCOUNTID我方银行账号FACCOUNTID.FNumber FOURACCOUNTNAME我方账户名称FOURACCOUNTNAME FOPPOSITEBANKNAME对方开户行FOPPOSITEBANKNAME FSETTLENO结算号FSETTLENO FBLEND勾对FBLEND FPURPOSEID原收款用途FPURPOSEID.FNumber FOpenAddressRec开户行地址FOpenAddressRec FRecType收款类型FRecType FCNAPS联行号FCNAPS FBankTypeRec收款银行（作废）FBankTypeRec FProvince省（作废）FProvince FCity城市（作废）FCity FDistrict地区（作废）FDistrict FUrgent加急FUrgent FSubmitStatus提交银行状态FSubmitStatus FSubmitUser提交/撤销银行人FSubmitUser FSubmitBankTime提交/撤销银行时间FSubmitBankTime FBankStatus银行处理状态FBankStatus FBankCode银行状态码FBankCode FINNERACCOUNTID内部账号FINNERACCOUNTID FINNERACCOUNTNAME内部账户名称FINNERACCOUNTNAME FCashAccount现金账号FCashAccount FREFUNDAMOUNTFOR_E退款金额FREFUNDAMOUNTFOR_E FREFUNDAMOUNT_E退款金额本位币FREFUNDAMOUNT_E FPOSTDATE登账日期FPOSTDATE FISPOST是否登账FISPOST FSALEORDERNO销售订单号（预付订单号）FSALEORDERNO FSALEORDERID销售订单内码FSALEORDERID FMATERIALID物料编码FMATERIALID.FNumber FMATERIALNAME物料名称FMATERIALNAME FMATERIALSEQ订单行号FMATERIALSEQ FORDERENTRYID销售订单明细内码FORDERENTRYID FRuZhangType入账类型FRuZhangType FEBMSG银企处理详细信息FEBMSG FSALEORDERNUMBER销售订单号（按物料和订单收付）FSALEORDERNUMBER FPayType支付类型FPayType FSwiftCodeSwiftCodeFSwiftCode FWRITTENOFFAMOUNT已核销金额本位币FWRITTENOFFAMOUNT FCHECKCODE流水号/对账码FCHECKCODE FNProvince省FNProvince FNCity城市FNCity FNDistrict地区FNDistrict FCountry国别FCountry FBankDetail银行网点FBankDetail FSignature签名FSignature FReturnMsg错误码FReturnMsg FFinishTime付款完成时间FFinishTime FDistrictCode地区码FDistrictCode FResponseTme付款回调时间FResponseTme FRequestTime请求时间FRequestTime FOtherPartyAdress对方地址FOtherPartyAdress FOtherPartyEmail对方邮箱FOtherPartyEmail FTransacType交易类型FTransacType FMessageInstruct电文指示FMessageInstruct FServiceLevel服务级别FServiceLevel FPayMethod付款方式FPayMethod FCNYPayMethodCNY付款方式FCNYPayMethod FExContractNo兑换合约号FExContractNo FCollectionCurr收款币别FCollectionCurr FCollectionAmount收款金额FCollectionAmount FReceiveBankBIC收款银行BICFReceiveBankBIC FReceiveBankCode收款银行代码FReceiveBankCode FReceiveBranchCode收款支行代码FReceiveBranchCode FServiceChargeBear手续费承担方FServiceChargeBear FServiceChargeNo手续费账号FServiceChargeNo FServiceChargeBank手续费账号银行FServiceChargeBank FServiceChargeCurr手续费币别FServiceChargeCurr FCNAPSNumCNAPSNumFCNAPSNum FCNYTransactType人民币交易种类FCNYTransactType FRMBPayMethod人民币付款方式FRMBPayMethod FAgentBankAcnt代理行账号FAgentBankAcnt FAgentBankName代理行名称FAgentBankName FAgentBankArea代理行国家\地区FAgentBankArea FAgentSWIFTCodeSWIFT Code(代理行)FAgentSWIFTCode FAgentBankAddress代理行地址FAgentBankAddress FReceiveBankClear收款银行本地清算码FReceiveBankClear FReceiveBranchClear收款人本地清算分行代码FReceiveBranchClear FClearParameter清算要求参数FClearParameter FByAgentBank通过代理行完成FByAgentBank FOverseaPay境外支付FOverseaPay FNOTVERIFICATEAMOUNT未核销金额FNOTVERIFICATEAMOUNT FPRICEUNITID计价单位FPRICEUNITID FPrice含税单价FPrice FQty数量FQty FCOSTID费用项目FCOSTID.FNumber FCOSTNAME费用项目名称FCOSTNAME FCOSTDEPARTMENTID费用承担部门FCOSTDEPARTMENTID FLinkRowId关联行IDFLinkRowId Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件 FieldKeys需查询的字段key集合 FormId业务对象表单IdAR_REFUNDBILL

响应参数

接口字段名称预设值 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryID FID实体主键 FBillNo单据编号 FDOCUMENTSTATUS单据状态 FCreaterId创建人 FCreateDate创建日期 FSETTLEORGID结算组织 FApproveDate审核日期 FSALEORGID销售组织 FEXCHANGETYPE汇率类型 FMAINBOOKCURRID本位币 FREFUNDTOTALAMOUNT应退金额本位币 FDATE业务日期 FCURRENCYID币别 FModifyDate修改日期 FModifierId修改人 FEXCHANGERATE汇率 FWRITTENOFFSTATUS核销状态 FBillTypeID单据类型 FREFUNDTOTALAMOUNTFOR表头-应退金额 FSALEERID销售员 FSALEGROUPID销售组 FSALEDEPTID销售部门 FAPPROVERID审核人 FREALREFUNDAMOUNTFOR表头-实退金额 FREALREFUNDAMOUNT实退金额本位币 FACCOUNTSYSTEM会计核算体系 FCancelDate作废日期 FCancellerId作废人 FCancelStatus作废状态 FRECTUNITTYPE收款单位类型 FCONTACTUNIT往来单位 FCONTACTUNITTYPE往来单位类型 FRECTUNIT收款单位 FBUSINESSTYPE业务类型 FCreditCheckResult信用检查结果 FISINIT是否期初单据 FDepartment部门 FPAYORGID付款组织 FISSAMEORG是否相同组织 FSETTLECUR结算币别 FSETTLERATE结算汇率 FREFUNDAMOUNT_H表头-退款金额本位币 FREFUNDAMOUNTFOR_H退款金额 FISB2CB2C业务 FSOURCESYSTEM来源系统 FIsWriteOff是否转销 FMatchMethodID核销方式 FScanPoint扫描点 FREMARK备注 FBookingDate期望付款日期 FTHIRDBILLNO第三方单据编号 FWBSETTLENO流水号 FSETTLEMAINBOOKID结算本位币 FSETTLEEXCHANGETYPE结算汇率类型 FISFROMTRADEBANK来源交易明细 FGYACCOUNTWATERID管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率 FPRESETBASE2预设基础资料字段2 FPRESETBASE1预设基础资料字段1 FCASHSALE现销 FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FISFROMALLREFUND是否来源于整单退款 FVirIsSameAcctOrg是否同一核算组织 FSETTLETYPEID结算方式 FREFUNDAMOUNTFOR表体-应退金额 FNOTE备注 FWRITTENOFFSTATUS_D表体明细-核销状态 FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额 FOPPOSITEBANKACCOUNT对方银行账号 FOPPOSITECCOUNTNAME对方账户名称 FREFUNDAMOUNT应退金额本位币 FHANDLINGCHARGEFOR手续费 FREALREFUNDAMOUNTFOR_D表体-实退金额 FHANDLINGCHARGE手续费本位币 FREALREFUNDAMOUNT_D实退金额本位币 FACCOUNTID我方银行账号 FOURACCOUNTNAME我方账户名称 FOPPOSITEBANKNAME对方开户行 FSETTLENO结算号 FBLEND勾对 FPURPOSEID原收款用途 FOpenAddressRec开户行地址 FRecType收款类型 FCNAPS联行号 FBankTypeRec收款银行（作废） FProvince省（作废） FCity城市（作废） FDistrict地区（作废） FUrgent加急 FSubmitStatus提交银行状态 FSubmitUser提交/撤销银行人 FSubmitBankTime提交/撤销银行时间 FBankStatus银行处理状态 FBankCode银行状态码 FINNERACCOUNTID内部账号 FINNERACCOUNTNAME内部账户名称 FCashAccount现金账号 FREFUNDAMOUNTFOR_E退款金额 FREFUNDAMOUNT_E退款金额本位币 FPOSTDATE登账日期 FISPOST是否登账 FSALEORDERNO销售订单号（预付订单号） FSALEORDERID销售订单内码 FMATERIALID物料编码 FMATERIALNAME物料名称 FMATERIALSEQ订单行号 FORDERENTRYID销售订单明细内码 FRuZhangType入账类型 FEBMSG银企处理详细信息 FSALEORDERNUMBER销售订单号（按物料和订单收付） FPayType支付类型 FSwiftCodeSwiftCode FWRITTENOFFAMOUNT已核销金额本位币 FCHECKCODE流水号/对账码 FNProvince省 FNCity城市 FNDistrict地区 FCountry国别 FBankDetail银行网点 FSignature签名 FReturnMsg错误码 FFinishTime付款完成时间 FDistrictCode地区码 FResponseTme付款回调时间 FRequestTime请求时间 FOtherPartyAdress对方地址 FOtherPartyEmail对方邮箱 FTransacType交易类型 FMessageInstruct电文指示 FServiceLevel服务级别 FPayMethod付款方式 FCNYPayMethodCNY付款方式 FExContractNo兑换合约号 FCollectionCurr收款币别 FCollectionAmount收款金额 FReceiveBankBIC收款银行BIC FReceiveBankCode收款银行代码 FReceiveBranchCode收款支行代码 FServiceChargeBear手续费承担方 FServiceChargeNo手续费账号 FServiceChargeBank手续费账号银行 FServiceChargeCurr手续费币别 FCNAPSNumCNAPSNum FCNYTransactType人民币交易种类 FRMBPayMethod人民币付款方式 FAgentBankAcnt代理行账号 FAgentBankName代理行名称 FAgentBankArea代理行国家\地区 FAgentSWIFTCodeSWIFT Code(代理行) FAgentBankAddress代理行地址 FReceiveBankClear收款银行本地清算码 FReceiveBranchClear收款人本地清算分行代码 FClearParameter清算要求参数 FByAgentBank通过代理行完成 FOverseaPay境外支付 FNOTVERIFICATEAMOUNT未核销金额 FPRICEUNITID计价单位 FPrice含税单价 FQty数量 FCOSTID费用项目 FCOSTNAME费用项目名称 FCOSTDEPARTMENTID费用承担部门 FLinkRowId关联行ID

轻易云集成平台接口明细

• 调用接口：写入空操作
• 接口名称：写入空操作
• 方法：POST

数据对接价值

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。