金蝶云星空和金蝶云星空单据接口对接
数据源平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
接口方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：其他应收单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDocumentStatus | 单据状态 | FDocumentStatus | |
| FBillTypeID | 单据类型 | FBillTypeID.FNumber | |
| FDATE | 业务日期 | FDATE | |
| FENDDATE_H | 到期日 | FENDDATE_H | |
| FCONTACTUNIT | 往来单位 | FCONTACTUNIT.FNumber | |
| FCONTACTUNITTYPE | 往来单位类型 | FCONTACTUNITTYPE | |
| FCURRENCYID | 币别 | FCURRENCYID.FNumber | |
| FSETTLEORGID | 结算组织 | FSETTLEORGID.FNumber | |
| FPayConditon | 收款条件 | FPayConditon | |
| FMAINBOOKSTDCURRID | 本位币 | FMAINBOOKSTDCURRID.FNumber | |
| FEXCHANGETYPE | 汇率类型 | FEXCHANGETYPE | |
| FExchangeRate | 汇率 | FExchangeRate | |
| FCancelDate | 作废日期 | FCancelDate | |
| FCreateDate | 创建日期 | FCreateDate | |
| FCancelStatus | 作废状态 | FCancelStatus | |
| FModifyDate | 修改日期 | FModifyDate | |
| FAPPROVERID | 审核人 | FAPPROVERID | |
| FAPPROVEDATE | 审核日期 | FAPPROVEDATE | |
| FCancellerId | 作废人 | FCancellerId | |
| FModifierId | 修改人 | FModifierId | |
| FCreatorId | 创建人 | FCreatorId | |
| FAMOUNTFOR | 总金额 | FAMOUNTFOR | |
| FWRITTENOFFSTATUS | 表头基本 - 收款核销状态 | FWRITTENOFFSTATUS | |
| FRelateHadPayAmount | 表头基本 - 收（退）款单的关联金额 | FRelateHadPayAmount | |
| FAMOUNT | 总金额本位币 | FAMOUNT | |
| FSOURCESYSTEM | 来源系统 | FSOURCESYSTEM | |
| FDEPARTMENTID | 申请部门 | FDEPARTMENTID.FNumber | |
| FSettleTypeID | 结算方式 | FSettleTypeID.FNumber | |
| FWRITTENOFFAMOUNTFOR | 已收款核销金额 | FWRITTENOFFAMOUNTFOR | |
| FISINIT | 是否期初单据 | FISINIT | |
| FACCNTTIMEJUDGETIME | 到期日计算日期 | FACCNTTIMEJUDGETIME | |
| FNOTAXAMOUNT | 不含税金额本位币 | FNOTAXAMOUNT | |
| FTAXAMOUNT | 税额本位币 | FTAXAMOUNT | |
| FPAYORGID | 收款组织 | FPAYORGID.FNumber | |
| FAPPLYAMOUNT_H | 表头-付款申请关联金额 | FAPPLYAMOUNT_H | |
| FSALEORGID | 销售组织 | FSALEORGID.FNumber | |
| FAR_OtherRemarks | 备注 | FAR_OtherRemarks | |
| FScanPoint | 扫描点 | FScanPoint | |
| FIsWriteOff | 转销 | FIsWriteOff | |
| FWRITTENOFFAMOUNT | 收（退）款单关联金额本位币 | FWRITTENOFFAMOUNT | |
| FSALEERID | 销售员 | FSALEERID.FNumber | |
| FSALEGROUPID | 销售组 | FSALEGROUPID.FNumber | |
| FSALEDEPTID | 销售部门 | FSALEDEPTID.FNumber | |
| FOUTCONTACTTYPE | 转出往来单位类型 | FOUTCONTACTTYPE | |
| FOUTCONTACTID | 转出往来单位 | FOUTCONTACTID | |
| FPRESETBASE1 | 预设基础资料字段1 | FPRESETBASE1 | |
| FPRESETBASE2 | 预设基础资料字段2 | FPRESETBASE2 | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | FPRESETASSISTANT1 | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | FPRESETASSISTANT2 | |
| FPRESETTEXT1 | 预设文本字段1 | FPRESETTEXT1 | |
| FPRESETTEXT2 | 预设文本字段2 | FPRESETTEXT2 | |
| FISENTRYMATCH | 按费用项目明细收款 | FISENTRYMATCH | |
| FCOSTID | 费用项目编码 | FCOSTID.FNumber | |
| FAMOUNTFOR_D | 总金额 | FAMOUNTFOR_D | |
| FCOMMENT | 备注 | FCOMMENT | |
| FAMOUNT_D | 总金额本位币 | FAMOUNT_D | |
| FNOTAXAMOUNTFOR | 不含税金额 | FNOTAXAMOUNTFOR | |
| FTAXAMOUNTFOR | 税额 | FTAXAMOUNTFOR | |
| FNOTAXAMOUNT_D | 不含税金额本位币 | FNOTAXAMOUNT_D | |
| FTAXAMOUNT_D | 税额本位币 | FTAXAMOUNT_D | |
| FCOSTDEPARTMENTID | 费用承担部门 | FCOSTDEPARTMENTID.FNumber | |
| FAPPLYAMOUNT | 付款申请关联金额 | FAPPLYAMOUNT | |
| FSOURCETYPE | 源单类型 | FSOURCETYPE | |
| FSourceBillNo | 源单编号 | FSourceBillNo | |
| FINVOICETYPE | 发票类型 | FINVOICETYPE | |
| FCREATEINVOICE | 已生成发票 | FCREATEINVOICE | |
| FEntryTaxRate | 税率(%) | FEntryTaxRate | |
| FIVAmountFor | 已开票金额 | FIVAmountFor | |
| FWRITTENOFFSTATUS_E | 核销状态 | FWRITTENOFFSTATUS_E | |
| FWRITTENOFFAMOUNTFOR_E | 已核销金额 | FWRITTENOFFAMOUNTFOR_E | |
| FWRITTENOFFAMOUNT_E | 已核销金额本位币 | FWRITTENOFFAMOUNT_E | |
| FNOTWRITTENOFFAMOUNTFOR | 未核销金额 | FNOTWRITTENOFFAMOUNTFOR | |
| FNOTWRITTENOFFAMOUNT | 未核销金额本位币 | FNOTWRITTENOFFAMOUNT | |
| FRELATEHADPAYAMOUNT_E | 收（退）款关联金额原币 | FRELATEHADPAYAMOUNT_E | |
| FEntity_FEntryID | FEntity _FEntryID | FEntity_FEntryID | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FModifyDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | AR_OtherRecAble | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FBillTypeID | 单据类型 | | |
| FDATE | 业务日期 | | |
| FENDDATE_H | 到期日 | | |
| FCONTACTUNIT | 往来单位 | | |
| FCONTACTUNITTYPE | 往来单位类型 | | |
| FCURRENCYID | 币别 | | |
| FSETTLEORGID | 结算组织 | | |
| FPayConditon | 收款条件 | | |
| FMAINBOOKSTDCURRID | 本位币 | | |
| FEXCHANGETYPE | 汇率类型 | | |
| FExchangeRate | 汇率 | | |
| FCancelDate | 作废日期 | | |
| FCreateDate | 创建日期 | | |
| FCancelStatus | 作废状态 | | |
| FModifyDate | 修改日期 | | |
| FAPPROVERID | 审核人 | | |
| FAPPROVEDATE | 审核日期 | | |
| FCancellerId | 作废人 | | |
| FModifierId | 修改人 | | |
| FCreatorId | 创建人 | | |
| FAMOUNTFOR | 总金额 | | |
| FWRITTENOFFSTATUS | 表头基本 - 收款核销状态 | | |
| FRelateHadPayAmount | 表头基本 - 收（退）款单的关联金额 | | |
| FAMOUNT | 总金额本位币 | | |
| FSOURCESYSTEM | 来源系统 | | |
| FDEPARTMENTID | 申请部门 | | |
| FSettleTypeID | 结算方式 | | |
| FWRITTENOFFAMOUNTFOR | 已收款核销金额 | | |
| FISINIT | 是否期初单据 | | |
| FACCNTTIMEJUDGETIME | 到期日计算日期 | | |
| FNOTAXAMOUNT | 不含税金额本位币 | | |
| FTAXAMOUNT | 税额本位币 | | |
| FPAYORGID | 收款组织 | | |
| FAPPLYAMOUNT_H | 表头-付款申请关联金额 | | |
| FSALEORGID | 销售组织 | | |
| FAR_OtherRemarks | 备注 | | |
| FScanPoint | 扫描点 | | |
| FIsWriteOff | 转销 | | |
| FWRITTENOFFAMOUNT | 收（退）款单关联金额本位币 | | |
| FSALEERID | 销售员 | | |
| FSALEGROUPID | 销售组 | | |
| FSALEDEPTID | 销售部门 | | |
| FOUTCONTACTTYPE | 转出往来单位类型 | | |
| FOUTCONTACTID | 转出往来单位 | | |
| FPRESETBASE1 | 预设基础资料字段1 | | |
| FPRESETBASE2 | 预设基础资料字段2 | | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | | |
| FPRESETTEXT1 | 预设文本字段1 | | |
| FPRESETTEXT2 | 预设文本字段2 | | |
| FISENTRYMATCH | 按费用项目明细收款 | | |
| FEntryID | 实体主键 | | |
| FCOSTID | 费用项目编码 | | |
| FAMOUNTFOR_D | 总金额 | | |
| FCOMMENT | 备注 | | |
| FAMOUNT_D | 总金额本位币 | | |
| FNOTAXAMOUNTFOR | 不含税金额 | | |
| FTAXAMOUNTFOR | 税额 | | |
| FNOTAXAMOUNT_D | 不含税金额本位币 | | |
| FTAXAMOUNT_D | 税额本位币 | | |
| FCOSTDEPARTMENTID | 费用承担部门 | | |
| FAPPLYAMOUNT | 付款申请关联金额 | | |
| FSOURCETYPE | 源单类型 | | |
| FSourceBillNo | 源单编号 | | |
| FINVOICETYPE | 发票类型 | | |
| FCREATEINVOICE | 已生成发票 | | |
| FEntryTaxRate | 税率(%) | | |
| FIVAmountFor | 已开票金额 | | |
| FWRITTENOFFSTATUS_E | 核销状态 | | |
| FWRITTENOFFAMOUNTFOR_E | 已核销金额 | | |
| FWRITTENOFFAMOUNT_E | 已核销金额本位币 | | |
| FNOTWRITTENOFFAMOUNTFOR | 未核销金额 | | |
| FNOTWRITTENOFFAMOUNT | 未核销金额本位币 | | |
| FRELATEHADPAYAMOUNT_E | 收（退）款关联金额原币 | | |
| FEntity _FEntryID | FEntity _FEntryID | | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：其他应收单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FDATE | 业务日期 | string | 业务日期 |
| FCONTACTUNITTYPE | 往来单位类型 | string | 往来单位类型 |
| FCONTACTUNIT | 往来单位 | string | 往来单位 |
| FCURRENCYID | 币别 | string | 币别 |
| FSETTLEORGID | 结算组织 | string | 结算组织 |
| FPAYORGID | 收款组织 | string | 收款组织 |
| FSALEORGID | 销售组织 | string | 销售组织 |
| FACCNTTIMEJUDGETIME | 到期日计算日期 | string | 到期日计算日期 |
| FMAINBOOKSTDCURRID | 本位币 | string | 本位币 |
| FEXCHANGETYPE | 汇率类型 | string | 汇率类型 |
| FCancelStatus | 作废状态 | string | 作废状态 |
| FEntity | 单据明细 | array | 单据明细 |
| FEntity.FCOSTID | 费用项目编码 | string | 费用项目编码 |
| FEntity.FCOSTDEPARTMENTID | 费用承担部门 | string | 费用承担部门 |
| FEntity.FINVOICETYPE | 发票类型 | string | 发票类型 |
| FEntity.FNOTAXAMOUNTFOR | 不含税金额 | string | 不含税金额 |
| FEntity.FCOMMENT | 备注 | string | 备注 |
| FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | string | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
数据对接效果
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
