金蝶云星空对接打通金蝶云星空收款退款单查询接口与收款退款新增接口

源系统:金蝶云星空

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

对接目标平台:金蝶云星空

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

多系统对接方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

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过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdAR_REFUNDBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 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

金蝶云星空接口明细

调用接口：batchSave
接口名称：收款退款新增
方法：POST

请求参数

字段字段名称类型配置值 FBillTypeID单据类型stringSKTKDLX01_SYS FDATE日期string2022-04-18 03:25:53 FCONTACTUNITTYPE往来类型stringBD_Customer FCONTACTUNIT往来单位string{{FCONTACTUNIT}} FRECTUNITTYPE收款单位类型stringBD_Customer FRECTUNIT收款单位string{{FRECTUNIT}} FCURRENCYID币别stringPRE001 FSETTLEORGID结算组织string102 FSALEORGID销售组织string{{FSALEORGID}} FBUSINESSTYPE业务类型string1 FEXCHANGERATE汇率string1.0 FPAYORGID支付组织string{{FPAYORGID}} FSETTLEMAINBOOKID结算本位币stringPRE001 FREFUNDBILLENTRY明细array FREFUNDBILLENTRY.FSETTLETYPEID结算方式stringJSFS03_SYS FREFUNDBILLENTRY.FPURPOSEID原收款用途stringSFKYT01_SYS FREFUNDBILLENTRY.FREFUNDAMOUNTFOR退款金额string{{FREFUNDAMOUNTFOR_H}} FREFUNDBILLENTRY.FACCOUNTID我方银行账号string{{FACCOUNTID}} FREFUNDBILLENTRY.FNOTE摘要string{{FNOTE}} FREFUNDBILLENTRY.FPOSTDATE登账日期string FREFUNDBILLENTRY.FISPOST是否登账stringtrue FREFUNDBILLENTRY.FRuZhangType入账类型string1 FREFUNDBILLENTRY.FPayType支付类型stringA FREFUNDBILLENTRY.FormId业务对象表单IdstringAR_REFUNDBILL FREFUNDBILLENTRY.Operation执行的操作stringBatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit提交并审核booltrue FREFUNDBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统打通概况

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。

金蝶云星空对接打通金蝶云星空收款退款单查询接口与收款退款新增接口