金蝶云星空与巨益OMS对接集成收款单查询连通分销商余额调价(ERP收款单对接OMS分销商余额增加)

对接系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

目标系统:巨益OMS

将天猫，京东，唯品，抖音小店，微信小程序，企业独立站，跨境平台等三方平台产生的订单经过路由计算给到不同的发货方；将不同的存货实体比如仓库，门店，工厂的库存汇总计算后共享到三方平台销售。

接口方案配置

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

金蝶云星空接口明细

• API：executeBillQuery

• NAME：收款单查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FID	实体主键	FID
FBillNo	单据编号	FBillNo
FDOCUMENTSTATUS	单据状态	FDOCUMENTSTATUS
FCreatorId	创建人	FCreatorId
FAPPROVERID	审核人	FAPPROVERID
FCreateDate	创建日期	FCreateDate
FSETTLEORGID	结算组织	FSETTLEORGID.FNumber
FApproveDate	审核日期	FApproveDate
FSALEORGID	销售组织	FSALEORGID.FNumber
FEXCHANGETYPE	汇率类型	FEXCHANGETYPE
FRECEIVEAMOUNTFOR_H	表头-应收金额	FRECEIVEAMOUNTFOR_H
FMAINBOOKCURID	本位币	FMAINBOOKCURID
FRECEIVEAMOUNT_H	表头-应收金额本位币	FRECEIVEAMOUNT_H
FCURRENCYID	币别	FCURRENCYID.FNumber
FDATE	业务日期	FDATE
FModifyDate	修改日期	FModifyDate
FModifierId	修改人	FModifierId
FEXCHANGERATE	汇率	FEXCHANGERATE
FWRITTENOFFSTATUS	核销状态	FWRITTENOFFSTATUS
FSALEERID	销售员	FSALEERID.FNumber
FSALEGROUPID	销售组	FSALEGROUPID.FNumber
FSALEDEPTID	销售部门	FSALEDEPTID.FNumber
FBillTypeID	单据类型	FBillTypeID.FNumber
FREALRECAMOUNTFOR	表头-实收金额	FREALRECAMOUNTFOR
FREALRECAMOUNT_H	表头-实收金额本位币	FREALRECAMOUNT_H
FACCOUNTSYSTEM	会计核算体系	FACCOUNTSYSTEM
FCancelDate	作废日期	FCancelDate
FCancelStatus	作废状态	FCancelStatus
FCancellerId	作废人	FCancellerId
FCONTACTUNITTYPE	往来单位类型	FCONTACTUNITTYPE
FCONTACTUNIT	往来单位	FCONTACTUNIT.FNumber
FPAYUNITTYPE	付款单位类型	FPAYUNITTYPE
FPAYUNIT	付款单位	FPAYUNIT.FNumber
FBUSINESSTYPE	业务类型	FBUSINESSTYPE
FCreditCheckResult	信用检查结果	FCreditCheckResult
FISINIT	是否期初单据	FISINIT
FDepartment	部门	FDepartment
FPAYORGID	收款组织	FPAYORGID.FNumber
FIsSameOrg	是否相同组织	FIsSameOrg
FSOURCESYSTEM	来源系统	FSOURCESYSTEM
FCASHSALE	现销	FCASHSALE
FSETTLECUR	结算币别	FSETTLECUR
FSETTLERATE	结算汇率	FSETTLERATE
FRECAMOUNTFOR	收款金额	FRECAMOUNTFOR
FRECAMOUNT	表头-收款金额本位币	FRECAMOUNT
FISB2C	B2C业务	FISB2C
FWBSETTLENO	流水号/对账码	FWBSETTLENO
FIsWriteOff	是否转销	FIsWriteOff
FMatchMethodID	核销方式	FMatchMethodID
FScanPoint	扫描点	FScanPoint
FKDPAYNO	金蝶支付流水号	FKDPAYNO
FREMARK	备注	FREMARK
FTHIRDBILLNO	第三方单据编号	FTHIRDBILLNO
FSETTLEMAINBOOKID	结算本位币	FSETTLEMAINBOOKID
FSETTLEEXCHANGETYPE	结算汇率类型	FSETTLEEXCHANGETYPE
FOUTCONTACTID	转出往来单位	FOUTCONTACTID
FOUTCONTACTTYPE	转出往来单位类型	FOUTCONTACTTYPE
FGYACCOUNTWATERID	管易财务流水内码	FGYACCOUNTWATERID
FISCARRYRATE	是否下推携带汇率到结算汇率	FISCARRYRATE
FPRESETBASE1	预设基础资料字段1	FPRESETBASE1
FPRESETBASE2	预设基础资料字段2	FPRESETBASE2
FPRESETASSISTANT1	预设辅助资料字段1	FPRESETASSISTANT1
FPRESETASSISTANT2	预设辅助资料字段2	FPRESETASSISTANT2
FPRESETTEXT1	预设文本字段1	FPRESETTEXT1
FPRESETTEXT2	预设文本字段2	FPRESETTEXT2
FISFROMSALORDER	来源销售订单下推	FISFROMSALORDER
FVirIsSameAcctOrg	是否同一核算组织	FVirIsSameAcctOrg
FSETTLETYPEID	结算方式	FSETTLETYPEID
FSETTLERECAMOUNTFOR	折后金额	FSETTLERECAMOUNTFOR
FSETTLEDISTAMOUNTFOR	现金折扣	FSETTLEDISTAMOUNTFOR
FRECTOTALAMOUNTFOR	表体-应收金额	FRECTOTALAMOUNTFOR
FSETTLERECAMOUNT	折后金额本位币	FSETTLERECAMOUNT
FSETTLEDISTAMOUNT	现金折扣本位币	FSETTLEDISTAMOUNT
FRECTOTALAMOUNT	表体-应收金额本位币	FRECTOTALAMOUNT
FWRITTENOFFSTATUS_D	表体明细-核销状态	FWRITTENOFFSTATUS_D
FWRITTENOFFAMOUNTFOR_D	表体明细-已核销金额	FWRITTENOFFAMOUNTFOR_D
FCOMMENT	备注	FCOMMENT
FOPPOSITEBANKACCOUNT	对方银行账号	FOPPOSITEBANKACCOUNT
FOPPOSITECCOUNTNAME	对方账户名称	FOPPOSITECCOUNTNAME
FRECEIVEITEM	预收销售订单	FRECEIVEITEM
FHANDLINGCHARGEFOR	手续费	FHANDLINGCHARGEFOR
FHANDLINGCHARGE	手续费本位币	FHANDLINGCHARGE
FREALRECAMOUNTFOR_D	表体-实收金额	FREALRECAMOUNTFOR_D
FREALRECAMOUNT_D	表体-实收金额本位币	FREALRECAMOUNT_D
FASSTOTALAMOUNTFOR	关联总金额	FASSTOTALAMOUNTFOR
FRECEIVEITEMTYPE	预收项目类型	FRECEIVEITEMTYPE
FSaleOrderID	预收销售订单号内码	FSaleOrderID
FACCOUNTID	我方银行账号	FACCOUNTID.FNumber
FOVERUNDERAMOUNTFOR	长短款	FOVERUNDERAMOUNTFOR
FOPPOSITEBANKNAME	对方开户行	FOPPOSITEBANKNAME
FSETTLENO	结算号	FSETTLENO
FBLEND	勾对	FBLEND
FPURPOSEID	收款用途	FPURPOSEID.FNumber
FOVERUNDERAMOUNT	长短款本位币	FOVERUNDERAMOUNT
FINNERACCOUNTID	内部账号	FINNERACCOUNTID
FINNERACCOUNTNAME	内部账户名称	FINNERACCOUNTNAME
FReFundAmount	退款关联金额	FReFundAmount
FCashAccount	现金账号	FCashAccount
FRECAMOUNTFOR_E	收款金额	FRECAMOUNTFOR_E

响应参数

接口字段	字段名称	预设值	描述
FID	实体主键
FBillNo	单据编号
FDOCUMENTSTATUS	单据状态
FCreatorId	创建人
FAPPROVERID	审核人
FCreateDate	创建日期
FSETTLEORGID	结算组织
FApproveDate	审核日期
FSALEORGID	销售组织
FEXCHANGETYPE	汇率类型
FRECEIVEAMOUNTFOR_H	表头-应收金额
FMAINBOOKCURID	本位币
FRECEIVEAMOUNT_H	表头-应收金额本位币
FCURRENCYID	币别
FDATE	业务日期
FModifyDate	修改日期
FModifierId	修改人
FEXCHANGERATE	汇率
FWRITTENOFFSTATUS	核销状态
FSALEERID	销售员
FSALEGROUPID	销售组
FSALEDEPTID	销售部门
FBillTypeID	单据类型
FREALRECAMOUNTFOR	表头-实收金额
FREALRECAMOUNT_H	表头-实收金额本位币
FACCOUNTSYSTEM	会计核算体系
FCancelDate	作废日期
FCancelStatus	作废状态
FCancellerId	作废人
FCONTACTUNITTYPE	往来单位类型
FCONTACTUNIT	往来单位
FPAYUNITTYPE	付款单位类型
FPAYUNIT	付款单位
FBUSINESSTYPE	业务类型
FCreditCheckResult	信用检查结果
FISINIT	是否期初单据
FDepartment	部门
FPAYORGID	收款组织
FIsSameOrg	是否相同组织
FSOURCESYSTEM	来源系统
FCASHSALE	现销
FSETTLECUR	结算币别
FSETTLERATE	结算汇率
FRECAMOUNTFOR	收款金额
FRECAMOUNT	表头-收款金额本位币
FISB2C	B2C业务
FWBSETTLENO	流水号/对账码
FIsWriteOff	是否转销
FMatchMethodID	核销方式
FScanPoint	扫描点
FKDPAYNO	金蝶支付流水号
FREMARK	备注
FTHIRDBILLNO	第三方单据编号
FSETTLEMAINBOOKID	结算本位币
FSETTLEEXCHANGETYPE	结算汇率类型
FOUTCONTACTID	转出往来单位
FOUTCONTACTTYPE	转出往来单位类型
FGYACCOUNTWATERID	管易财务流水内码
FISCARRYRATE	是否下推携带汇率到结算汇率
FPRESETBASE1	预设基础资料字段1
FPRESETBASE2	预设基础资料字段2
FPRESETASSISTANT1	预设辅助资料字段1
FPRESETASSISTANT2	预设辅助资料字段2
FPRESETTEXT1	预设文本字段1
FPRESETTEXT2	预设文本字段2
FISFROMSALORDER	来源销售订单下推
FVirIsSameAcctOrg	是否同一核算组织
FSETTLETYPEID	结算方式
FSETTLERECAMOUNTFOR	折后金额
FSETTLEDISTAMOUNTFOR	现金折扣
FRECTOTALAMOUNTFOR	表体-应收金额
FSETTLERECAMOUNT	折后金额本位币
FSETTLEDISTAMOUNT	现金折扣本位币
FRECTOTALAMOUNT	表体-应收金额本位币
FWRITTENOFFSTATUS_D	表体明细-核销状态
FWRITTENOFFAMOUNTFOR_D	表体明细-已核销金额
FCOMMENT	备注
FOPPOSITEBANKACCOUNT	对方银行账号
FOPPOSITECCOUNTNAME	对方账户名称
FRECEIVEITEM	预收销售订单
FHANDLINGCHARGEFOR	手续费
FHANDLINGCHARGE	手续费本位币
FREALRECAMOUNTFOR_D	表体-实收金额
FREALRECAMOUNT_D	表体-实收金额本位币
FASSTOTALAMOUNTFOR	关联总金额
FRECEIVEITEMTYPE	预收项目类型
FSaleOrderID	预收销售订单号内码
FACCOUNTID	我方银行账号
FOVERUNDERAMOUNTFOR	长短款
FOPPOSITEBANKNAME	对方开户行
FSETTLENO	结算号
FBLEND	勾对
FPURPOSEID	收款用途
FOVERUNDERAMOUNT	长短款本位币
FINNERACCOUNTID	内部账号
FINNERACCOUNTNAME	内部账户名称
FReFundAmount	退款关联金额
FCashAccount	现金账号
FRECAMOUNTFOR_E	收款金额

巨益OMS接口明细

• API：distribute.accountAdjustOrder.adjust

• NAME：分销商余额调价

• METHOD：POST

请求参数

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

系统数据对接

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。