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

金蝶云星空与巨益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 FISB2CB2C业务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预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 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 FRECAMOUNT_E收款金额本位币FRECAMOUNT_E FPOSTDATE登账日期FPOSTDATE FISPOST是否登账FISPOST FMATERIALID物料编码FMATERIALID.FNumber FMATERIALNAME物料名称FMATERIALNAME FSALEORDERNO销售订单号FSALEORDERNO FMATERIALSEQ订单行号FMATERIALSEQ FORDERENTRYID销售订单明细内码FORDERENTRYID FTOPAYMENTAMOUNTFOR保证金转货款金额FTOPAYMENTAMOUNTFOR FWRITTENOFFAMOUNT已核销金额本位币FWRITTENOFFAMOUNT FNOTVERIFICATEAMOUNT未核销金额FNOTVERIFICATEAMOUNT FPRICEUNITID计价单位FPRICEUNITID FPrice含税单价FPrice FQty数量FQty FCOSTID费用项目FCOSTID.FNumber FCOSTDEPARTMENTID费用承担部门FCOSTDEPARTMENTID.FNumber FCOSTNAME费用项目名称FCOSTNAME FLinkRowId关联行IDFLinkRowId FSALEORDERBase销售订单（基础资料）FSALEORDERBase FRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_FEntryID Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdAR_RECEIVEBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 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表头-收款金额本位币 FISB2CB2C业务 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收款金额 FRECAMOUNT_E收款金额本位币 FPOSTDATE登账日期 FISPOST是否登账 FMATERIALID物料编码 FMATERIALNAME物料名称 FSALEORDERNO销售订单号 FMATERIALSEQ订单行号 FORDERENTRYID销售订单明细内码 FTOPAYMENTAMOUNTFOR保证金转货款金额 FWRITTENOFFAMOUNT已核销金额本位币 FNOTVERIFICATEAMOUNT未核销金额 FPRICEUNITID计价单位 FPrice含税单价 FQty数量 FCOSTID费用项目 FCOSTDEPARTMENTID费用承担部门 FCOSTNAME费用项目名称 FLinkRowId关联行ID FSALEORDERBase销售订单（基础资料） FRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_FEntryID

巨益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分销商编码10011001分销商编码,示例值(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等等。