金蝶云星空与巨益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 | |
| 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 | 关联行ID | FLinkRowId | |
| FSALEORDERBase | 销售订单（基础资料） | FSALEORDERBase | |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_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 | 业务对象表单Id | AR_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 | 表头-收款金额本位币 | | |
| 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 | 收款金额 | | |
| FRECAMOUNT_E | 收款金额本位币 | | |
| FPOSTDATE | 登账日期 | | |
| FISPOST | 是否登账 | | |
| FMATERIALID | 物料编码 | | |
| FMATERIALNAME | 物料名称 | | |
| FSALEORDERNO | 销售订单号 | | |
| FMATERIALSEQ | 订单行号 | | |
| FORDERENTRYID | 销售订单明细内码 | | |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | | |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | | |
| FNOTVERIFICATEAMOUNT | 未核销金额 | | |
| FPRICEUNITID | 计价单位 | | |
| FPrice | 含税单价 | | |
| FQty | 数量 | | |
| FCOSTID | 费用项目 | | |
| FCOSTDEPARTMENTID | 费用承担部门 | | |
| FCOSTNAME | 费用项目名称 | | |
| FLinkRowId | 关联行ID | | |
| FSALEORDERBase | 销售订单（基础资料） | | |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_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 | 分销商编码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等等。
