接口配置打通巨益OMS和金蝶云星空数据对接
![系统接口打通](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/cover/e9e6019b-a62e-3733-b21a-3d35a6039c081674720526.jpeg)
来源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:巨益OMS
深圳市巨益科技开发有限公司(巨益科技)2013年成立于深圳,专注为中大型零售品牌企业提供全渠道电商中台服务,经过7年多时间的业务沉淀,已助力超过1000+年销售额过亿的行业TOP品牌实现数字化转型,服务口碑获得了客户的一致好评。截至目前,巨益科技服务客户类目涉及服装配饰、数码家电、化妆品、眼镜珠宝、食品保健、母婴用品等十三大行业,并凭借行业领先的中台服务案例先后荣获阿里、京东等平台颁发的“年度十佳服务商”、“京卓越金奖”、“订单压测TOP1”等荣誉奖项。
数据接口配置方案
在轻易云平台进行集成方案的配置时,为了实现快速搭建,轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案,参考市场主流所进行的字段配置完成集成方案的自定义化快速配置,即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置,让配置更加清晰,首先确定该方方案的对接内容,第二歩获取筛选数据源平台的数据,第三步数据源与写入目标形成映射关系配置。完成配置后一键启用通过该系统数据集成平台的能力,可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成,并且每周都在增加新的应用系统接入。
![数据集成方案](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/ar/p4-11.png)
![旺店通与金蝶打通](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/ar/p4-25.png)
![ERP如何对接](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/ar/p4-2.png)
金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:收款退款单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 |
FPAYORGID | 付款组织 | string |
FCHECKCODE | 流水号/对账码 | string |
FSwiftCode | SwiftCode | string |
FPRESETASSISTANT1 | 预设辅助资料字段1 | string |
FTHIRDBILLNO | 第三方单据编号 | string |
FSETTLETYPEID | 结算方式 | string |
FCONTACTUNIT | 往来单位 | string |
FOURACCOUNTNAME | 我方账户名称 | string |
FPOSTDATE | 登账日期 | string |
FServiceChargeNo | 手续费账号 | string |
FieldKeys | 需查询的字段key集合 | array |
FSubmitBankTime | 提交/撤销银行时间 | string |
FQty | 数量 | string |
FEBMSG | 银企处理详细信息 | string |
FRECTUNITTYPE | 收款单位类型 | string |
FREFUNDAMOUNT_H | 表头-退款金额本位币 | string |
FCASHSALE | 现销 | string |
FServiceLevel | 服务级别 | string |
FCancelStatus | 作废状态 | string |
FRecType | 收款类型 | string |
FCNAPSNum | CNAPSNum | string |
FReturnMsg | 错误码 | string |
FCNAPS | 联行号 | string |
FCOSTNAME | 费用项目名称 | string |
FTransacType | 交易类型 | string |
FNDistrict | 地区 | string |
FREMARK | 备注 | string |
FSETTLEEXCHANGETYPE | 结算汇率类型 | string |
Limit | 最大行数 | string |
FINNERACCOUNTNAME | 内部账户名称 | string |
FFinishTime | 付款完成时间 | string |
FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | string |
FormId | 业务对象表单Id | string |
FSignature | 签名 | string |
FPRESETTEXT1 | 预设文本字段1 | string |
FSALEERID | 销售员 | string |
FServiceChargeBank | 手续费账号银行 | string |
FEXCHANGERATE | 汇率 | string |
FCNYTransactType | 人民币交易种类 | string |
FProvince | 省(作废) | string |
FREFUNDAMOUNT_E | 退款金额本位币 | string |
FREALREFUNDAMOUNTFOR | 表头-实退金额 | string |
FOpenAddressRec | 开户行地址 | string |
FilterString | 过滤条件 | string |
FReceiveBranchCode | 收款支行代码 | string |
FREFUNDAMOUNTFOR_E | 退款金额 | string |
FMessageInstruct | 电文指示 | string |
FVirIsSameAcctOrg | 是否同一核算组织 | string |
FNOTE | 备注 | string |
FPRESETASSISTANT2 | 预设辅助资料字段2 | string |
FCOSTID | 费用项目 | string |
FCNYPayMethod | CNY付款方式 | string |
FPrice | 含税单价 | string |
FREFUNDTOTALAMOUNTFOR | 表头-应退金额 | string |
FPURPOSEID | 原收款用途 | string |
FISPOST | 是否登账 | string |
FSETTLECUR | 结算币别 | string |
FReceiveBankCode | 收款银行代码 | string |
FBankDetail | 银行网点 | string |
FReceiveBranchClear | 收款人本地清算分行代码 | string |
FISSAMEORG | 是否相同组织 | string |
FBillNo | 单据编号 | string |
FBankTypeRec | 收款银行(作废) | string |
FINNERACCOUNTID | 内部账号 | string |
FSALEORDERNUMBER | 销售订单号(按物料和订单收付) | string |
FNOTVERIFICATEAMOUNT | 未核销金额 | string |
FDepartment | 部门 | string |
FORDERENTRYID | 销售订单明细内码 | string |
FCancellerId | 作废人 | string |
FREFUNDTOTALAMOUNT | 应退金额本位币 | string |
FSETTLENO | 结算号 | string |
StartRow | 开始行索引 | string |
FSALEORGID | 销售组织 | string |
FGYACCOUNTWATERID | 管易财务流水内码 | string |
FCollectionCurr | 收款币别 | string |
FWRITTENOFFAMOUNT | 已核销金额本位币 | string |
FDATE | 业务日期 | string |
FREFUNDAMOUNTFOR | 表体-应退金额 | string |
FISB2C | B2C业务 | string |
FMATERIALID | 物料编码 | string |
FNCity | 城市 | string |
FMatchMethodID | 核销方式 | string |
FISINIT | 是否期初单据 | string |
FBankCode | 银行状态码 | string |
FCashAccount | 现金账号 | string |
FWRITTENOFFSTATUS | 核销状态 | string |
FServiceChargeCurr | 手续费币别 | string |
FUrgent | 加急 | string |
FSALEGROUPID | 销售组 | string |
FExContractNo | 兑换合约号 | string |
FModifierId | 修改人 | string |
FServiceChargeBear | 手续费承担方 | string |
FSOURCESYSTEM | 来源系统 | string |
FCreateDate | 创建日期 | string |
FRuZhangType | 入账类型 | string |
FISFROMTRADEBANK | 来源交易明细 | string |
FACCOUNTID | 我方银行账号 | string |
FREALREFUNDAMOUNT | 实退金额本位币 | string |
FWRITTENOFFSTATUS_D | 表体明细-核销状态 | string |
FPRICEUNITID | 计价单位 | string |
FAgentBankArea | 代理行国家\地区 | string |
FRMBPayMethod | 人民币付款方式 | string |
FSALEORDERID | 销售订单内码 | string |
FCollectionAmount | 收款金额 | string |
FBLEND | 勾对 | string |
FOtherPartyEmail | 对方邮箱 | string |
FBUSINESSTYPE | 业务类型 | string |
FSETTLEORGID.FNumber | 结算组织 | string |
FCOSTDEPARTMENTID | 费用承担部门 | string |
FMATERIALNAME | 物料名称 | string |
FHANDLINGCHARGEFOR | 手续费 | string |
FREFUNDAMOUNT | 应退金额本位币 | string |
FNProvince | 省 | string |
FREFUNDAMOUNTFOR_H | 退款金额 | string |
FReceiveBankClear | 收款银行本地清算码 | string |
FCreditCheckResult | 信用检查结果 | string |
FPayType | 支付类型 | string |
FOPPOSITEBANKACCOUNT | 对方银行账号 | string |
FDistrictCode | 地区码 | string |
FAgentBankAcnt | 代理行账号 | string |
FHANDLINGCHARGE | 手续费本位币 | string |
FResponseTme | 付款回调时间 | string |
FOPPOSITECCOUNTNAME | 对方账户名称 | string |
FPayMethod | 付款方式 | string |
FScanPoint | 扫描点 | string |
FREALREFUNDAMOUNTFOR_D | 表体-实退金额 | string |
FBankStatus | 银行处理状态 | string |
FPRESETBASE2 | 预设基础资料字段2 | string |
FClearParameter | 清算要求参数 | string |
FCURRENCYID | 币别 | string |
FSETTLEMAINBOOKID | 结算本位币 | string |
FSubmitStatus | 提交银行状态 | string |
FDistrict | 地区(作废) | string |
FREALREFUNDAMOUNT_D | 实退金额本位币 | string |
FAgentBankName | 代理行名称 | string |
FCancelDate | 作废日期 | string |
FSALEORDERNO | 销售订单号(预付订单号) | string |
FAgentSWIFTCode | SWIFT Code(代理行) | string |
FOtherPartyAdress | 对方地址 | string |
TopRowCount | 返回总行数 | int |
FAPPROVERID | 审核人 | string |
FCONTACTUNITTYPE | 往来单位类型 | string |
FBookingDate | 期望付款日期 | string |
FCreaterId | 创建人 | string |
FBillTypeID | 单据类型 | string |
FOPPOSITEBANKNAME | 对方开户行 | string |
FDOCUMENTSTATUS | 单据状态 | string |
FPRESETBASE1 | 预设基础资料字段1 | string |
FWBSETTLENO | 流水号 | string |
FACCOUNTSYSTEM | 会计核算体系 | string |
FModifyDate | 修改日期 | string |
FByAgentBank | 通过代理行完成 | string |
FCity | 城市(作废) | string |
FREFUNDBILLENTRY_FEntryID | FREFUNDBILLENTRY_FEntryID | string |
FRECTUNIT | 收款单位 | string |
FCountry | 国别 | string |
FISFROMALLREFUND | 是否来源于整单退款 | string |
FPRESETTEXT2 | 预设文本字段2 | string |
FEXCHANGETYPE | 汇率类型 | string |
FMATERIALSEQ | 订单行号 | string |
FLinkRowId | 关联行ID | string |
FAgentBankAddress | 代理行地址 | string |
FSALEDEPTID | 销售部门 | string |
FRequestTime | 请求时间 | string |
FReceiveBankBIC | 收款银行BIC | string |
FID | 实体主键 | string |
FSETTLERATE | 结算汇率 | string |
FSubmitUser | 提交/撤销银行人 | string |
FISCARRYRATE | 是否下推携带汇率到结算汇率 | string |
FMAINBOOKCURRID | 本位币 | string |
FIsWriteOff | 是否转销 | string |
FOverseaPay | 境外支付 | string |
FApproveDate | 审核日期 | string |
响应参数
字段 | 名称 | 类型 | 描述 |
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 | -{{FREFUNDTOTALAMOUNTFOR}} |
adjustReason | 调整原因 | string | {{FPURPOSEID}} |
adjustType | 调整类型 | string | ADJUST_BALANCE |
collectedAccount | 收款账户 | string | {{FOPPOSITEBANKACCOUNT}} |
companyCode | 公司编码 | string | {{FSALEORGID}} |
distributorCode | 分销商编码 | string | 1001 |
distributorSettlementType | 分销商结算类型 | string | ALI_PAY |
outCode | 外部单号 | string | {{FBillNo}}{{FPAYORGID}} |
paymentAccount | 付款账户 | string | {{FOURACCOUNTNAME}} |
remark | 备注 | string | {{FNOTE}} |
settlementTradeCode | 交易单号 | string | {{FBillNo}}{{FPAYORGID}} |
系统对接总览
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和巨益OMS,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。
![企业微信与ERP对接](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/ar/p7-7.png)
![ERP打通OA](https://qeasy-1305182502.cos.ap-guangzhou.myqcloud.com/ar/p7-2.png)