金蝶云星空和金蝶云星空单据接口对接
来源系统:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的收款单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的收款单新增接口作为数据写入动作，既可以完成第一步的数据对接配置。
金蝶云星空接口明细
- 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 | | |
金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：收款单新增
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| FBillNo | 单据编号 | string | {{FBillNo}}测试 |
| FDOCUMENTSTATUS | 单据状态 | string | {{FDOCUMENTSTATUS}} |
| FSETTLEORGID | 结算组织 | string | {{FSETTLEORGID}} |
| FEXCHANGETYPE | 汇率类型 | string | HLTX01_SYS |
| FCURRENCYID | 币别 | string | {{FCURRENCYID}} |
| FDATE | 业务日期 | string | 2022-04-18 00:16:23 |
| FBillTypeID | 单据类型 | string | SKDLX02_SYS |
| FCancelStatus | 作废状态 | string | {{FCancelStatus}} |
| FCONTACTUNITTYPE | 往来单位类型 | string | {{FCONTACTUNITTYPE}} |
| FCONTACTUNIT | 往来单位 | string | {{FCONTACTUNIT}} |
| FPAYUNITTYPE | 付款单位类型 | string | {{FPAYUNITTYPE}} |
| FPAYUNIT | 付款单位 | string | {{FPAYUNIT}} |
| FBUSINESSTYPE | 业务类型 | string | {{FBUSINESSTYPE}} |
| FPAYORGID | 收款组织 | string | {{FPAYORGID}} |
| FSETTLECUR | 结算币别 | string | PRE001 |
| FRECEIVEBILLENTRY | 收款单明细 | array | |
| FRECEIVEBILLENTRY.FSETTLETYPEID | 结算方式 | string | JSFS01_SYS |
| FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR | 表体-应收金额 | string | {{FRECTOTALAMOUNTFOR}} |
| FRECEIVEBILLENTRY.FACCOUNTID | 我方银行账号 | string | {{FACCOUNTID}} |
| FRECEIVEBILLENTRY.FPURPOSEID | 收款用途 | string | {{FPURPOSEID}} |
| FRECEIVEBILLENTRY.FPOSTDATE1 | 登账日期 | string | |
| FRECEIVEBILLENTRY.FormId | 业务对象表单Id | string | AR_RECEIVEBILL |
| FRECEIVEBILLENTRY.Operation | 执行的操作 | string | BatchSave |
| FRECEIVEBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FRECEIVEBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统集成总览
全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶云星空、金蝶云星空间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。
