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

数据源平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

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

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

数据对接方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的收款退款单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器。选择对应的写入空操作接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：收款退款单查询
方法：POST

请求参数

字段字段名称类型配置值 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryIDstringFREFUNDBILLENTRY_FEntryID FID实体主键stringFID FBillNo单据编号stringFBillNo FDOCUMENTSTATUS单据状态stringFDOCUMENTSTATUS FCreaterId创建人stringFCreaterId FCreateDate创建日期stringFCreateDate FSETTLEORGID.FNumber结算组织stringFSETTLEORGID FApproveDate审核日期stringFApproveDate FSALEORGID销售组织stringFSALEORGID.FNumber FEXCHANGETYPE汇率类型stringFEXCHANGETYPE FMAINBOOKCURRID本位币stringFMAINBOOKCURRID.FNumber FREFUNDTOTALAMOUNT应退金额本位币stringFREFUNDTOTALAMOUNT FDATE业务日期stringFDATE FCURRENCYID币别stringFCURRENCYID.FNumber FModifyDate修改日期stringFModifyDate FModifierId修改人stringFModifierId FEXCHANGERATE汇率stringFEXCHANGERATE FWRITTENOFFSTATUS核销状态stringFWRITTENOFFSTATUS FBillTypeID单据类型stringFBillTypeID.FNumber FREFUNDTOTALAMOUNTFOR表头-应退金额stringFREFUNDTOTALAMOUNTFOR FSALEERID销售员stringFSALEERID.FNumber FSALEGROUPID销售组stringFSALEGROUPID.FNumber FSALEDEPTID销售部门stringFSALEDEPTID.FNumber FAPPROVERID审核人stringFAPPROVERID FREALREFUNDAMOUNTFOR表头-实退金额stringFREALREFUNDAMOUNTFOR FREALREFUNDAMOUNT实退金额本位币stringFREALREFUNDAMOUNT FACCOUNTSYSTEM会计核算体系stringFACCOUNTSYSTEM FCancelDate作废日期stringFCancelDate FCancellerId作废人stringFCancellerId FCancelStatus作废状态stringFCancelStatus FRECTUNITTYPE收款单位类型stringFRECTUNITTYPE FCONTACTUNIT往来单位stringFCONTACTUNIT.FNumber FCONTACTUNITTYPE往来单位类型stringFCONTACTUNITTYPE FRECTUNIT收款单位stringFRECTUNIT.FNumber FBUSINESSTYPE业务类型stringFBUSINESSTYPE FCreditCheckResult信用检查结果stringFCreditCheckResult FISINIT是否期初单据stringFISINIT FDepartment部门stringFDepartment.FNumber FPAYORGID付款组织stringFPAYORGID.FNumber FISSAMEORG是否相同组织stringFISSAMEORG FSETTLECUR结算币别stringFSETTLECUR FSETTLERATE结算汇率stringFSETTLERATE FREFUNDAMOUNT_H表头-退款金额本位币stringFREFUNDAMOUNT_H FREFUNDAMOUNTFOR_H退款金额stringFREFUNDAMOUNTFOR_H FISB2CB2C业务stringFISB2C FSOURCESYSTEM来源系统stringFSOURCESYSTEM FIsWriteOff是否转销stringFIsWriteOff FMatchMethodID核销方式stringFMatchMethodID FScanPoint扫描点stringFScanPoint FREMARK备注stringFREMARK FBookingDate期望付款日期stringFBookingDate FTHIRDBILLNO第三方单据编号stringFTHIRDBILLNO FWBSETTLENO流水号stringFWBSETTLENO FSETTLEMAINBOOKID结算本位币stringFSETTLEMAINBOOKID FSETTLEEXCHANGETYPE结算汇率类型stringFSETTLEEXCHANGETYPE FISFROMTRADEBANK来源交易明细stringFISFROMTRADEBANK FGYACCOUNTWATERID管易财务流水内码stringFGYACCOUNTWATERID FISCARRYRATE是否下推携带汇率到结算汇率stringFISCARRYRATE FPRESETBASE2预设基础资料字段2stringFPRESETBASE2 FPRESETBASE1预设基础资料字段1stringFPRESETBASE1 FCASHSALE现销stringFCASHSALE FPRESETASSISTANT1预设辅助资料字段1stringFPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2stringFPRESETASSISTANT2 FPRESETTEXT1预设文本字段1stringFPRESETTEXT1 FPRESETTEXT2预设文本字段2stringFPRESETTEXT2 FISFROMALLREFUND是否来源于整单退款stringFISFROMALLREFUND FVirIsSameAcctOrg是否同一核算组织stringFVirIsSameAcctOrg FSETTLETYPEID结算方式stringFSETTLETYPEID FREFUNDAMOUNTFOR表体-应退金额stringFREFUNDAMOUNTFOR FNOTE备注stringFNOTE FWRITTENOFFSTATUS_D表体明细-核销状态stringFWRITTENOFFSTATUS_D FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额stringFWRITTENOFFAMOUNTFOR_D FOPPOSITEBANKACCOUNT对方银行账号stringFOPPOSITEBANKACCOUNT FOPPOSITECCOUNTNAME对方账户名称stringFOPPOSITECCOUNTNAME FREFUNDAMOUNT应退金额本位币stringFREFUNDAMOUNT FHANDLINGCHARGEFOR手续费stringFHANDLINGCHARGEFOR FREALREFUNDAMOUNTFOR_D表体-实退金额stringFREALREFUNDAMOUNTFOR_D FHANDLINGCHARGE手续费本位币stringFHANDLINGCHARGE FREALREFUNDAMOUNT_D实退金额本位币stringFREALREFUNDAMOUNT_D FACCOUNTID我方银行账号stringFACCOUNTID.FNumber FOURACCOUNTNAME我方账户名称stringFOURACCOUNTNAME FOPPOSITEBANKNAME对方开户行stringFOPPOSITEBANKNAME FSETTLENO结算号stringFSETTLENO FBLEND勾对stringFBLEND FPURPOSEID原收款用途stringFPURPOSEID.FNumber FOpenAddressRec开户行地址stringFOpenAddressRec FRecType收款类型stringFRecType FCNAPS联行号stringFCNAPS FBankTypeRec收款银行（作废）stringFBankTypeRec FProvince省（作废）stringFProvince FCity城市（作废）stringFCity FDistrict地区（作废）stringFDistrict FUrgent加急stringFUrgent FSubmitStatus提交银行状态stringFSubmitStatus FSubmitUser提交/撤销银行人stringFSubmitUser FSubmitBankTime提交/撤销银行时间stringFSubmitBankTime FBankStatus银行处理状态stringFBankStatus FBankCode银行状态码stringFBankCode FINNERACCOUNTID内部账号stringFINNERACCOUNTID FINNERACCOUNTNAME内部账户名称stringFINNERACCOUNTNAME FCashAccount现金账号stringFCashAccount FREFUNDAMOUNTFOR_E退款金额stringFREFUNDAMOUNTFOR_E FREFUNDAMOUNT_E退款金额本位币stringFREFUNDAMOUNT_E FPOSTDATE登账日期stringFPOSTDATE FISPOST是否登账stringFISPOST FSALEORDERNO销售订单号（预付订单号）stringFSALEORDERNO FSALEORDERID销售订单内码stringFSALEORDERID FMATERIALID物料编码stringFMATERIALID.FNumber FMATERIALNAME物料名称stringFMATERIALNAME FMATERIALSEQ订单行号stringFMATERIALSEQ FORDERENTRYID销售订单明细内码stringFORDERENTRYID FRuZhangType入账类型stringFRuZhangType FEBMSG银企处理详细信息stringFEBMSG FSALEORDERNUMBER销售订单号（按物料和订单收付）stringFSALEORDERNUMBER FPayType支付类型stringFPayType FSwiftCodeSwiftCodestringFSwiftCode FWRITTENOFFAMOUNT已核销金额本位币stringFWRITTENOFFAMOUNT FCHECKCODE流水号/对账码stringFCHECKCODE FNProvince省stringFNProvince FNCity城市stringFNCity FNDistrict地区stringFNDistrict FCountry国别stringFCountry FBankDetail银行网点stringFBankDetail FSignature签名stringFSignature FReturnMsg错误码stringFReturnMsg FFinishTime付款完成时间stringFFinishTime FDistrictCode地区码stringFDistrictCode FResponseTme付款回调时间stringFResponseTme FRequestTime请求时间stringFRequestTime FOtherPartyAdress对方地址stringFOtherPartyAdress FOtherPartyEmail对方邮箱stringFOtherPartyEmail FTransacType交易类型stringFTransacType FMessageInstruct电文指示stringFMessageInstruct FServiceLevel服务级别stringFServiceLevel FPayMethod付款方式stringFPayMethod FCNYPayMethodCNY付款方式stringFCNYPayMethod FExContractNo兑换合约号stringFExContractNo FCollectionCurr收款币别stringFCollectionCurr FCollectionAmount收款金额stringFCollectionAmount FReceiveBankBIC收款银行BICstringFReceiveBankBIC FReceiveBankCode收款银行代码stringFReceiveBankCode FReceiveBranchCode收款支行代码stringFReceiveBranchCode FServiceChargeBear手续费承担方stringFServiceChargeBear FServiceChargeNo手续费账号stringFServiceChargeNo FServiceChargeBank手续费账号银行stringFServiceChargeBank FServiceChargeCurr手续费币别stringFServiceChargeCurr FCNAPSNumCNAPSNumstringFCNAPSNum FCNYTransactType人民币交易种类stringFCNYTransactType FRMBPayMethod人民币付款方式stringFRMBPayMethod FAgentBankAcnt代理行账号stringFAgentBankAcnt FAgentBankName代理行名称stringFAgentBankName FAgentBankArea代理行国家\地区stringFAgentBankArea FAgentSWIFTCodeSWIFT Code(代理行)stringFAgentSWIFTCode FAgentBankAddress代理行地址stringFAgentBankAddress FReceiveBankClear收款银行本地清算码stringFReceiveBankClear FReceiveBranchClear收款人本地清算分行代码stringFReceiveBranchClear FClearParameter清算要求参数stringFClearParameter FByAgentBank通过代理行完成stringFByAgentBank FOverseaPay境外支付stringFOverseaPay FNOTVERIFICATEAMOUNT未核销金额stringFNOTVERIFICATEAMOUNT FPRICEUNITID计价单位stringFPRICEUNITID FPrice含税单价stringFPrice FQty数量stringFQty FCOSTID费用项目stringFCOSTID.FNumber FCOSTNAME费用项目名称stringFCOSTNAME FCOSTDEPARTMENTID费用承担部门stringFCOSTDEPARTMENTID FLinkRowId关联行IDstringFLinkRowId Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件string FieldKeys需查询的字段key集合array FormId业务对象表单IdstringAR_REFUNDBILL

响应参数

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

轻易云集成平台接口明细

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

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。