从金蝶云星空到金蝶云星空通过接口集成数据

数据源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
系统对接接口配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取金蝶云星空的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。通过该系统数据集成平台的能力,可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成,并且每周都在增加新的应用系统接入。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:收款单查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FID | 实体主键 | string | FID |
| FBillNo | 单据编号 | string | FBillNo |
| FDOCUMENTSTATUS | 单据状态 | string | FDOCUMENTSTATUS |
| FCreatorId | 创建人 | string | FCreatorId |
| FAPPROVERID | 审核人 | string | FAPPROVERID |
| FCreateDate | 创建日期 | string | FCreateDate |
| FSETTLEORGID | 结算组织 | string | FSETTLEORGID.FNumber |
| FApproveDate | 审核日期 | string | FApproveDate |
| FSALEORGID | 销售组织 | string | FSALEORGID.FNumber |
| FEXCHANGETYPE | 汇率类型 | string | FEXCHANGETYPE |
| FRECEIVEAMOUNTFOR_H | 表头-应收金额 | string | FRECEIVEAMOUNTFOR_H |
| FMAINBOOKCURID | 本位币 | string | FMAINBOOKCURID |
| FRECEIVEAMOUNT_H | 表头-应收金额本位币 | string | FRECEIVEAMOUNT_H |
| FCURRENCYID | 币别 | string | FCURRENCYID.FNumber |
| FDATE | 业务日期 | string | FDATE |
| FModifyDate | 修改日期 | string | FModifyDate |
| FModifierId | 修改人 | string | FModifierId |
| FEXCHANGERATE | 汇率 | string | FEXCHANGERATE |
| FWRITTENOFFSTATUS | 核销状态 | string | FWRITTENOFFSTATUS |
| FSALEERID | 销售员 | string | FSALEERID.FNumber |
| FSALEGROUPID | 销售组 | string | FSALEGROUPID.FNumber |
| FSALEDEPTID | 销售部门 | string | FSALEDEPTID.FNumber |
| FBillTypeID | 单据类型 | string | FBillTypeID.FNumber |
| FREALRECAMOUNTFOR | 表头-实收金额 | string | FREALRECAMOUNTFOR |
| FREALRECAMOUNT_H | 表头-实收金额本位币 | string | FREALRECAMOUNT_H |
| FACCOUNTSYSTEM | 会计核算体系 | string | FACCOUNTSYSTEM |
| FCancelDate | 作废日期 | string | FCancelDate |
| FCancelStatus | 作废状态 | string | FCancelStatus |
| FCancellerId | 作废人 | string | FCancellerId |
| FCONTACTUNITTYPE | 往来单位类型 | string | FCONTACTUNITTYPE |
| FCONTACTUNIT | 往来单位 | string | FCONTACTUNIT.FNumber |
| FPAYUNITTYPE | 付款单位类型 | string | FPAYUNITTYPE |
| FPAYUNIT | 付款单位 | string | FPAYUNIT.FNumber |
| FBUSINESSTYPE | 业务类型 | string | FBUSINESSTYPE |
| FCreditCheckResult | 信用检查结果 | string | FCreditCheckResult |
| FISINIT | 是否期初单据 | string | FISINIT |
| FDepartment | 部门 | string | FDepartment |
| FPAYORGID | 收款组织 | string | FPAYORGID.FNumber |
| FIsSameOrg | 是否相同组织 | string | FIsSameOrg |
| FSOURCESYSTEM | 来源系统 | string | FSOURCESYSTEM |
| FCASHSALE | 现销 | string | FCASHSALE |
| FSETTLECUR | 结算币别 | string | FSETTLECUR |
| FSETTLERATE | 结算汇率 | string | FSETTLERATE |
| FRECAMOUNTFOR | 收款金额 | string | FRECAMOUNTFOR |
| FRECAMOUNT | 表头-收款金额本位币 | string | FRECAMOUNT |
| FISB2C | B2C业务 | string | FISB2C |
| FWBSETTLENO | 流水号/对账码 | string | FWBSETTLENO |
| FIsWriteOff | 是否转销 | string | FIsWriteOff |
| FMatchMethodID | 核销方式 | string | FMatchMethodID |
| FScanPoint | 扫描点 | string | FScanPoint |
| FKDPAYNO | 金蝶支付流水号 | string | FKDPAYNO |
| FREMARK | 备注 | string | FREMARK |
| FTHIRDBILLNO | 第三方单据编号 | string | FTHIRDBILLNO |
| FSETTLEMAINBOOKID | 结算本位币 | string | FSETTLEMAINBOOKID |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | string | FSETTLEEXCHANGETYPE |
| FOUTCONTACTID | 转出往来单位 | string | FOUTCONTACTID |
| FOUTCONTACTTYPE | 转出往来单位类型 | string | FOUTCONTACTTYPE |
| FGYACCOUNTWATERID | 管易财务流水内码 | string | FGYACCOUNTWATERID |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | string | FISCARRYRATE |
| FPRESETBASE1 | 预设基础资料字段1 | string | FPRESETBASE1 |
| FPRESETBASE2 | 预设基础资料字段2 | string | FPRESETBASE2 |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | string | FPRESETASSISTANT1 |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | string | FPRESETASSISTANT2 |
| FPRESETTEXT1 | 预设文本字段1 | string | FPRESETTEXT1 |
| FPRESETTEXT2 | 预设文本字段2 | string | FPRESETTEXT2 |
| FISFROMSALORDER | 来源销售订单下推 | string | FISFROMSALORDER |
| FVirIsSameAcctOrg | 是否同一核算组织 | string | FVirIsSameAcctOrg |
| FSETTLETYPEID | 结算方式 | string | FSETTLETYPEID |
| FSETTLERECAMOUNTFOR | 折后金额 | string | FSETTLERECAMOUNTFOR |
| FSETTLEDISTAMOUNTFOR | 现金折扣 | string | FSETTLEDISTAMOUNTFOR |
| FRECTOTALAMOUNTFOR | 表体-应收金额 | string | FRECTOTALAMOUNTFOR |
| FSETTLERECAMOUNT | 折后金额本位币 | string | FSETTLERECAMOUNT |
| FSETTLEDISTAMOUNT | 现金折扣本位币 | string | FSETTLEDISTAMOUNT |
| FRECTOTALAMOUNT | 表体-应收金额本位币 | string | FRECTOTALAMOUNT |
| FWRITTENOFFSTATUS_D | 表体明细-核销状态 | string | FWRITTENOFFSTATUS_D |
| FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | string | FWRITTENOFFAMOUNTFOR_D |
| FCOMMENT | 备注 | string | FCOMMENT |
| FOPPOSITEBANKACCOUNT | 对方银行账号 | string | FOPPOSITEBANKACCOUNT |
| FOPPOSITECCOUNTNAME | 对方账户名称 | string | FOPPOSITECCOUNTNAME |
| FRECEIVEITEM | 预收销售订单 | string | FRECEIVEITEM |
| FHANDLINGCHARGEFOR | 手续费 | string | FHANDLINGCHARGEFOR |
| FHANDLINGCHARGE | 手续费本位币 | string | FHANDLINGCHARGE |
| FREALRECAMOUNTFOR_D | 表体-实收金额 | string | FREALRECAMOUNTFOR_D |
| FREALRECAMOUNT_D | 表体-实收金额本位币 | string | FREALRECAMOUNT_D |
| FASSTOTALAMOUNTFOR | 关联总金额 | string | FASSTOTALAMOUNTFOR |
| FRECEIVEITEMTYPE | 预收项目类型 | string | FRECEIVEITEMTYPE |
| FSaleOrderID | 预收销售订单号内码 | string | FSaleOrderID |
| FACCOUNTID | 我方银行账号 | string | FACCOUNTID.FNumber |
| FOVERUNDERAMOUNTFOR | 长短款 | string | FOVERUNDERAMOUNTFOR |
| FOPPOSITEBANKNAME | 对方开户行 | string | FOPPOSITEBANKNAME |
| FSETTLENO | 结算号 | string | FSETTLENO |
| FBLEND | 勾对 | string | FBLEND |
| FPURPOSEID | 收款用途 | string | FPURPOSEID.FNumber |
| FOVERUNDERAMOUNT | 长短款本位币 | string | FOVERUNDERAMOUNT |
| FINNERACCOUNTID | 内部账号 | string | FINNERACCOUNTID |
| FINNERACCOUNTNAME | 内部账户名称 | string | FINNERACCOUNTNAME |
| FReFundAmount | 退款关联金额 | string | FReFundAmount |
| FCashAccount | 现金账号 | string | FCashAccount |
| FRECAMOUNTFOR_E | 收款金额 | string | FRECAMOUNTFOR_E |
| FRECAMOUNT_E | 收款金额本位币 | string | FRECAMOUNT_E |
| FPOSTDATE | 登账日期 | string | FPOSTDATE |
| FISPOST | 是否登账 | string | FISPOST |
| FMATERIALID | 物料编码 | string | FMATERIALID.FNumber |
| FMATERIALNAME | 物料名称 | string | FMATERIALNAME |
| FSALEORDERNO | 销售订单号 | string | FSALEORDERNO |
| FMATERIALSEQ | 订单行号 | string | FMATERIALSEQ |
| FORDERENTRYID | 销售订单明细内码 | string | FORDERENTRYID |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | string | FTOPAYMENTAMOUNTFOR |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | string | FWRITTENOFFAMOUNT |
| FNOTVERIFICATEAMOUNT | 未核销金额 | string | FNOTVERIFICATEAMOUNT |
| FPRICEUNITID | 计价单位 | string | FPRICEUNITID |
| FPrice | 含税单价 | string | FPrice |
| FQty | 数量 | string | FQty |
| FCOSTID | 费用项目 | string | FCOSTID.FNumber |
| FCOSTDEPARTMENTID | 费用承担部门 | string | FCOSTDEPARTMENTID.FNumber |
| FCOSTNAME | 费用项目名称 | string | FCOSTNAME |
| FLinkRowId | 关联行ID | string | FLinkRowId |
| FSALEORDERBase | 销售订单(基础资料) | string | FSALEORDERBase |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | string | FRECEIVEBILLSRCENTRY_FEntryID |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | AR_RECEIVEBILL |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDOCUMENTSTATUS | 单据状态 | string | |
| FCreatorId | 创建人 | string | |
| FAPPROVERID | 审核人 | string | |
| FCreateDate | 创建日期 | string | |
| FSETTLEORGID | 结算组织 | string | |
| FApproveDate | 审核日期 | string | |
| FSALEORGID | 销售组织 | string | |
| FEXCHANGETYPE | 汇率类型 | string | |
| FRECEIVEAMOUNTFOR_H | 表头-应收金额 | string | |
| FMAINBOOKCURID | 本位币 | string | |
| FRECEIVEAMOUNT_H | 表头-应收金额本位币 | string | |
| FCURRENCYID | 币别 | string | |
| FDATE | 业务日期 | string | |
| FModifyDate | 修改日期 | string | |
| FModifierId | 修改人 | string | |
| FEXCHANGERATE | 汇率 | string | |
| FWRITTENOFFSTATUS | 核销状态 | string | |
| FSALEERID | 销售员 | string | |
| FSALEGROUPID | 销售组 | string | |
| FSALEDEPTID | 销售部门 | string | |
| FBillTypeID | 单据类型 | string | |
| FREALRECAMOUNTFOR | 表头-实收金额 | string | |
| FREALRECAMOUNT_H | 表头-实收金额本位币 | string | |
| FACCOUNTSYSTEM | 会计核算体系 | string | |
| FCancelDate | 作废日期 | string | |
| FCancelStatus | 作废状态 | string | |
| FCancellerId | 作废人 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FPAYUNITTYPE | 付款单位类型 | string | |
| FPAYUNIT | 付款单位 | string | |
| FBUSINESSTYPE | 业务类型 | string | |
| FCreditCheckResult | 信用检查结果 | string | |
| FISINIT | 是否期初单据 | string | |
| FDepartment | 部门 | string | |
| FPAYORGID | 收款组织 | string | |
| FIsSameOrg | 是否相同组织 | string | |
| FSOURCESYSTEM | 来源系统 | string | |
| FCASHSALE | 现销 | string | |
| FSETTLECUR | 结算币别 | string | |
| FSETTLERATE | 结算汇率 | string | |
| FRECAMOUNTFOR | 收款金额 | string | |
| FRECAMOUNT | 表头-收款金额本位币 | string | |
| FISB2C | B2C业务 | string | |
| FWBSETTLENO | 流水号/对账码 | string | |
| FIsWriteOff | 是否转销 | string | |
| FMatchMethodID | 核销方式 | string | |
| FScanPoint | 扫描点 | string | |
| FKDPAYNO | 金蝶支付流水号 | string | |
| FREMARK | 备注 | string | |
| FTHIRDBILLNO | 第三方单据编号 | string | |
| FSETTLEMAINBOOKID | 结算本位币 | string | |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | string | |
| FOUTCONTACTID | 转出往来单位 | string | |
| FOUTCONTACTTYPE | 转出往来单位类型 | string | |
| FGYACCOUNTWATERID | 管易财务流水内码 | string | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | string | |
| FPRESETBASE1 | 预设基础资料字段1 | string | |
| FPRESETBASE2 | 预设基础资料字段2 | string | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | string | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | string | |
| FPRESETTEXT1 | 预设文本字段1 | string | |
| FPRESETTEXT2 | 预设文本字段2 | string | |
| FISFROMSALORDER | 来源销售订单下推 | string | |
| FVirIsSameAcctOrg | 是否同一核算组织 | string | |
| FSETTLETYPEID | 结算方式 | string | |
| FSETTLERECAMOUNTFOR | 折后金额 | string | |
| FSETTLEDISTAMOUNTFOR | 现金折扣 | string | |
| FRECTOTALAMOUNTFOR | 表体-应收金额 | string | |
| FSETTLERECAMOUNT | 折后金额本位币 | string | |
| FSETTLEDISTAMOUNT | 现金折扣本位币 | string | |
| FRECTOTALAMOUNT | 表体-应收金额本位币 | string | |
| FWRITTENOFFSTATUS_D | 表体明细-核销状态 | string | |
| FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | string | |
| FCOMMENT | 备注 | string | |
| FOPPOSITEBANKACCOUNT | 对方银行账号 | string | |
| FOPPOSITECCOUNTNAME | 对方账户名称 | string | |
| FRECEIVEITEM | 预收销售订单 | string | |
| FHANDLINGCHARGEFOR | 手续费 | string | |
| FHANDLINGCHARGE | 手续费本位币 | string | |
| FREALRECAMOUNTFOR_D | 表体-实收金额 | string | |
| FREALRECAMOUNT_D | 表体-实收金额本位币 | string | |
| FASSTOTALAMOUNTFOR | 关联总金额 | string | |
| FRECEIVEITEMTYPE | 预收项目类型 | string | |
| FSaleOrderID | 预收销售订单号内码 | string | |
| FACCOUNTID | 我方银行账号 | string | |
| FOVERUNDERAMOUNTFOR | 长短款 | string | |
| FOPPOSITEBANKNAME | 对方开户行 | string | |
| FSETTLENO | 结算号 | string | |
| FBLEND | 勾对 | string | |
| FPURPOSEID | 收款用途 | string | |
| FOVERUNDERAMOUNT | 长短款本位币 | string | |
| FINNERACCOUNTID | 内部账号 | string | |
| FINNERACCOUNTNAME | 内部账户名称 | string | |
| FReFundAmount | 退款关联金额 | string | |
| FCashAccount | 现金账号 | string | |
| FRECAMOUNTFOR_E | 收款金额 | string | |
| FRECAMOUNT_E | 收款金额本位币 | string | |
| FPOSTDATE | 登账日期 | string | |
| FISPOST | 是否登账 | string | |
| FMATERIALID | 物料编码 | string | |
| FMATERIALNAME | 物料名称 | string | |
| FSALEORDERNO | 销售订单号 | string | |
| FMATERIALSEQ | 订单行号 | string | |
| FORDERENTRYID | 销售订单明细内码 | string | |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | string | |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | string | |
| FNOTVERIFICATEAMOUNT | 未核销金额 | string | |
| FPRICEUNITID | 计价单位 | string | |
| FPrice | 含税单价 | string | |
| FQty | 数量 | string | |
| FCOSTID | 费用项目 | string | |
| FCOSTDEPARTMENTID | 费用承担部门 | string | |
| FCOSTNAME | 费用项目名称 | string | |
| FLinkRowId | 关联行ID | string | |
| FSALEORDERBase | 销售订单(基础资料) | string | |
| FRECEIVEBILLSRCENTRY_FEntryID | FRECEIVEBILLSRCENTRY_FEntryID | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:收款单新增
- METHOD:POST
请求参数
| 接口字段 | 名称 | 预设值 |
| FBillNo | 单据编号 | |
| FDOCUMENTSTATUS | 单据状态 | C |
| FSETTLEORGID | 结算组织 | |
| FEXCHANGETYPE | 汇率类型 | HLTX01_SYS |
| FCURRENCYID | 币别 | PRE001 |
| FDATE | 业务日期 | |
| FBillTypeID | 单据类型 | SKDLX02_SYS |
| FCancelStatus | 作废状态 | A |
| FCONTACTUNITTYPE | 往来单位类型 | BD_Customer |
| FCONTACTUNIT | 往来单位 | |
| FPAYUNITTYPE | 付款单位类型 | BD_Customer |
| FPAYUNIT | 付款单位 | |
| FBUSINESSTYPE | 业务类型 | 1 |
| FPAYORGID | 收款组织 | |
| FSETTLECUR | 结算币别 | PRE001 |
| FRECEIVEBILLENTRY | 收款单明细 | |
| FRECEIVEBILLENTRY.FSETTLETYPEID | 结算方式 | JSFS01_SYS |
| FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR | 表体-应收金额 | |
| FRECEIVEBILLENTRY.FACCOUNTID | 我方银行账号 | |
| FRECEIVEBILLENTRY.FPURPOSEID | 收款用途 | SFKYT02_SYS |
| FRECEIVEBILLENTRY.FPOSTDATE1 | 登账日期 | |
| FRECEIVEBILLENTRY.FormId | 业务对象表单Id | AR_RECEIVEBILL |
| FRECEIVEBILLENTRY.Operation | 执行的操作 | BatchSave |
| FRECEIVEBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | true |
| FRECEIVEBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false |
系统数据集成价值
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和金蝶云星空,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。
