金蝶云星空对接打通巨益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架构。
