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

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

源系统:金蝶云星空

金蝶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_FEntryID	FREFUNDBILLENTRY_FEntryID	FREFUNDBILLENTRY_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
FISB2C	B2C业务	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	预设基础资料字段2	FPRESETBASE2
FPRESETBASE1	预设基础资料字段1	FPRESETBASE1
FCASHSALE	现销	FCASHSALE
FPRESETASSISTANT1	预设辅助资料字段1	FPRESETASSISTANT1
FPRESETASSISTANT2	预设辅助资料字段2	FPRESETASSISTANT2
FPRESETTEXT1	预设文本字段1	FPRESETTEXT1
FPRESETTEXT2	预设文本字段2	FPRESETTEXT2
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
FSwiftCode	SwiftCode	FSwiftCode
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
FCNYPayMethod	CNY付款方式	FCNYPayMethod
FExContractNo	兑换合约号	FExContractNo
FCollectionCurr	收款币别	FCollectionCurr
FCollectionAmount	收款金额	FCollectionAmount
FReceiveBankBIC	收款银行BIC	FReceiveBankBIC
FReceiveBankCode	收款银行代码	FReceiveBankCode
FReceiveBranchCode	收款支行代码	FReceiveBranchCode
FServiceChargeBear	手续费承担方	FServiceChargeBear
FServiceChargeNo	手续费账号	FServiceChargeNo
FServiceChargeBank	手续费账号银行	FServiceChargeBank
FServiceChargeCurr	手续费币别	FServiceChargeCurr
FCNAPSNum	CNAPSNum	FCNAPSNum
FCNYTransactType	人民币交易种类	FCNYTransactType
FRMBPayMethod	人民币付款方式	FRMBPayMethod
FAgentBankAcnt	代理行账号	FAgentBankAcnt
FAgentBankName	代理行名称	FAgentBankName
FAgentBankArea	代理行国家\地区	FAgentBankArea
FAgentSWIFTCode	SWIFT 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	关联行ID	FLinkRowId
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	业务对象表单Id	AR_REFUNDBILL	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FREFUNDBILLENTRY_FEntryID	FREFUNDBILLENTRY_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	退款金额
FISB2C	B2C业务
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	支付类型
FSwiftCode	SwiftCode
FWRITTENOFFAMOUNT	已核销金额本位币
FCHECKCODE	流水号/对账码
FNProvince	省
FNCity	城市
FNDistrict	地区
FCountry	国别
FBankDetail	银行网点
FSignature	签名
FReturnMsg	错误码
FFinishTime	付款完成时间
FDistrictCode	地区码
FResponseTme	付款回调时间
FRequestTime	请求时间
FOtherPartyAdress	对方地址
FOtherPartyEmail	对方邮箱
FTransacType	交易类型
FMessageInstruct	电文指示
FServiceLevel	服务级别
FPayMethod	付款方式
FCNYPayMethod	CNY付款方式
FExContractNo	兑换合约号
FCollectionCurr	收款币别
FCollectionAmount	收款金额
FReceiveBankBIC	收款银行BIC
FReceiveBankCode	收款银行代码
FReceiveBranchCode	收款支行代码
FServiceChargeBear	手续费承担方
FServiceChargeNo	手续费账号
FServiceChargeBank	手续费账号银行
FServiceChargeCurr	手续费币别
FCNAPSNum	CNAPSNum
FCNYTransactType	人民币交易种类
FRMBPayMethod	人民币付款方式
FAgentBankAcnt	代理行账号
FAgentBankName	代理行名称
FAgentBankArea	代理行国家\地区
FAgentSWIFTCode	SWIFT Code(代理行)
FAgentBankAddress	代理行地址
FReceiveBankClear	收款银行本地清算码
FReceiveBranchClear	收款人本地清算分行代码
FClearParameter	清算要求参数
FByAgentBank	通过代理行完成
FOverseaPay	境外支付
FNOTVERIFICATEAMOUNT	未核销金额
FPRICEUNITID	计价单位
FPrice	含税单价
FQty	数量
FCOSTID	费用项目
FCOSTNAME	费用项目名称
FCOSTDEPARTMENTID	费用承担部门
FLinkRowId	关联行ID

金蝶云星空接口明细

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

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	SKTKDLX01_SYS
FDATE	日期	string	2022-04-18 03:25:53
FCONTACTUNITTYPE	往来类型	string	BD_Customer
FCONTACTUNIT	往来单位	string	{{FCONTACTUNIT}}
FRECTUNITTYPE	收款单位类型	string	BD_Customer
FRECTUNIT	收款单位	string	{{FRECTUNIT}}
FCURRENCYID	币别	string	PRE001
FSETTLEORGID	结算组织	string	102
FSALEORGID	销售组织	string	{{FSALEORGID}}
FBUSINESSTYPE	业务类型	string	1
FEXCHANGERATE	汇率	string	1.0
FPAYORGID	支付组织	string	{{FPAYORGID}}
FSETTLEMAINBOOKID	结算本位币	string	PRE001
FREFUNDBILLENTRY	明细	array
FREFUNDBILLENTRY.FSETTLETYPEID	结算方式	string	JSFS03_SYS
FREFUNDBILLENTRY.FPURPOSEID	原收款用途	string	SFKYT01_SYS
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR	退款金额	string	{{FREFUNDAMOUNTFOR_H}}
FREFUNDBILLENTRY.FACCOUNTID	我方银行账号	string	{{FACCOUNTID}}
FREFUNDBILLENTRY.FNOTE	摘要	string	{{FNOTE}}
FREFUNDBILLENTRY.FPOSTDATE	登账日期	string
FREFUNDBILLENTRY.FISPOST	是否登账	string	true
FREFUNDBILLENTRY.FRuZhangType	入账类型	string	1
FREFUNDBILLENTRY.FPayType	支付类型	string	A
FREFUNDBILLENTRY.FormId	业务对象表单Id	string	AR_REFUNDBILL
FREFUNDBILLENTRY.Operation	执行的操作	string	BatchSave
FREFUNDBILLENTRY.IsAutoSubmitAndAudit	提交并审核	bool	true
FREFUNDBILLENTRY.IsVerifyBaseDataField	验证基础资料	bool	false

系统打通概况

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