金蝶云星空对接打通巨益OMS收款退款单查询接口与分销商余额调价接口

接通系统：金蝶云星空

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

集成系统:巨益OMS

深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳，专注为中大型零售品牌企业提供全渠道电商中台服务，经过7年多时间的业务沉淀，已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型，服务口碑获得了客户的一致好评。截至目前，巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业，并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。

数据集成方案配置

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

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FREFUNDBILLENTRY_FEntryID	FREFUNDBILLENTRY_FEntryID	string
FID	实体主键	string
FBillNo	单据编号	string
FDOCUMENTSTATUS	单据状态	string
FCreaterId	创建人	string
FCreateDate	创建日期	string
FSETTLEORGID.FNumber	结算组织	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
FISB2C	B2C业务	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	预设基础资料字段2	string
FPRESETBASE1	预设基础资料字段1	string
FCASHSALE	现销	string
FPRESETASSISTANT1	预设辅助资料字段1	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT1	预设文本字段1	string
FPRESETTEXT2	预设文本字段2	string
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
FSwiftCode	SwiftCode	string
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
FCNYPayMethod	CNY付款方式	string
FExContractNo	兑换合约号	string
FCollectionCurr	收款币别	string
FCollectionAmount	收款金额	string
FReceiveBankBIC	收款银行BIC	string
FReceiveBankCode	收款银行代码	string
FReceiveBranchCode	收款支行代码	string
FServiceChargeBear	手续费承担方	string
FServiceChargeNo	手续费账号	string
FServiceChargeBank	手续费账号银行	string
FServiceChargeCurr	手续费币别	string
FCNAPSNum	CNAPSNum	string
FCNYTransactType	人民币交易种类	string
FRMBPayMethod	人民币付款方式	string
FAgentBankAcnt	代理行账号	string
FAgentBankName	代理行名称	string
FAgentBankArea	代理行国家\地区	string
FAgentSWIFTCode	SWIFT 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	关联行ID	string
Limit	最大行数	string	金蝶的查询分页参数
StartRow	开始行索引	string	金蝶的查询分页参数
TopRowCount	返回总行数	int	金蝶的查询分页参数
FilterString	过滤条件	string	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合	array	金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

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

巨益OMS接口明细

接口：distribute.accountAdjustOrder.adjust
接口名称：分销商余额调价
接口方法：POST

请求参数

字段	名称	类型	描述
adjustAmount	调整金额	string	调整金额,示例值(100)
adjustReason	调整原因	string	调整原因,示例值(充值)
adjustType	调整类型	string	调整类型(ADJUST_BALANCE=账户余额, ADJUST_LOCK_BALANCE=冻结金额, ADJUST_CREDIT=信用额度, ADJUST_REBATE=返利余额),示例值(ADJUST_BALANCE)
collectedAccount	收款账户	string	收款账户,示例值(123456)
companyCode	公司编码	string	公司编码,示例值(001)
distributorCode	分销商编码	string	分销商编码,示例值(test29)
distributorSettlementType	分销商结算类型	string	分销商结算类型(ALI_PAY=支付宝, UNION_PAY=银联, CASH=现金),示例值(ALI_PAY)
outCode	外部单号	string	外部单号,示例值(test01)
paymentAccount	付款账户	string	付款账户,示例值(654321)
remark	备注	string	备注,示例值(备注信息)
settlementTradeCode	交易单号	string	交易单号,示例值(ZFDH001)

系统打通概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到巨益OMS之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。