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

接通系统：金蝶云星空

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

集成系统:巨益OMS

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

数据集成方案配置

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

金蝶云星空接口明细

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

请求参数

字段名称类型描述 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryIDstring 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 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 Limit最大行数string金蝶的查询分页参数 StartRow开始行索引string金蝶的查询分页参数 TopRowCount返回总行数int金蝶的查询分页参数 FilterString过滤条件string示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合array金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

字段名称类型描述 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

巨益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架构。

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