钉钉和金蝶云星空单据接口集成
接通系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:钉钉
钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
多系统对接方案配置
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的付款申请单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择对应的发起审批实例(官方)接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：付款申请单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FEACHBANKACCOUNT | 对方银行账号 | string |
| FEXPECTPAYDATE | 期望付款日期 | string |
| FORDERENTRYID | 订单明细内码 | string |
| FDEPARTMENT | 部门 | string |
| FPURCHASERID | 采购员 | string |
| FRECTUNIT | 收款单位 | string |
| FMAINBOOKID | 本位币 | string |
| FilterString | 过滤条件 | string |
| FCANCELLERID | 作废人 | string |
| FSETTLERATE | 结算汇率 | string |
| FCANCELDATE | 作废日期 | string |
| FMATERIALSEQ | 订单行号 | string |
| FPURCHASEORDERNO | 订单号 | string |
| FAPPROVEDATE | 审核日期 | string |
| F_VAOJ_FQR | 发起人 | string |
| FCONTACTUNIT | 往来单位 | string |
| FIsCredit | 是否信贷业务 | string |
| FApplyPclAmount | 申请还本金额 | string |
| FCOMMENT | 备注（作废） | string |
| TopRowCount | 返回总行数 | int |
| FDATE | 申请日期 | string |
| FMODIFIERID | 修改人 | string |
| FCONTACTUNITTYPE | 往来单位类型 | string |
| FBillNo | 单据编号 | string |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | string |
| FQTY | 数量 | string |
| FPURCHASEDEPTID | 采购部门 | string |
| FDOCUMENTSTATUS | 单据状态 | string |
| FMATERIALNAME | 物料名称 | string |
| F_VAOJ_HKSX | 货款属性 | string |
| FCREATEDATE | 创建日期 | string |
| FPURCHASERGROUPID | 采购组 | string |
| Limit | 最大行数 | string |
| FIsBorrow | 是否其他预付 | string |
| FSETTLEORGID | 结算组织 | string |
| FEXCHANGERATE | 汇率 | string |
| FSRCBILLNO | 源单编号 | string |
| FAPPLYAMOUNT | 申请付款金额本位币 | string |
| FBILLTYPEID | 单据类型 | string |
| FPRICE | 含税单价 | string |
| FSwiftCode | SwiftCode | string |
| FWritePclAmount | 关联付利息金额 | string |
| FRELATEPAYAMOUNT | 付退款关联金额 | string |
| FSALEGROUPID | 销售组 | string |
| FACCOUNTSYSTEM | 会计核算体系 | string |
| FCOSTID | 费用项目 | string |
| FID | 实体主键 | string |
| FREALAPPLYAMOUNTFOR | 实际申请金额 | string |
| FCREATORID | 创建人 | string |
| FMODIFYDATE | 修改日期 | string |
| FENDDATE | 到期日 | string |
| FRECTUNITTYPE | 收款单位类型 | string |
| FAPPLYORGID | 申请组织 | string |
| FCURRENCYID | 币别 | string |
| FSOURCESYSTEM | 来源系统 | string |
| StartRow | 开始行索引 | string |
| FPAYORGID | 付款组织 | string |
| FAPPLYAMOUNTFOR_H | 申请付款金额 | string |
| FCLOSERID | 关闭人 | string |
| FPAYPURPOSEID | 付款用途 | string |
| FEXPENSEDEPTID | 费用承担部门 | string |
| FBankActID | 银行账号 | string |
| FCANCELSTATUS | 作废状态 | string |
| FPURCHASEORGID | 采购组织 | string |
| FEXCHANGETYPE | 汇率类型 | string |
| FPAYAMOUNTFOR | 应付金额 | string |
| FRELATEREFUNDAMOUNT | 作废—收款退款关联金额 | string |
| FSALEDEPTID | 销售部门 | string |
| FPRICEUNITID | 计价单位 | string |
| FPAYAMOUNTFOR_H | 应付金额 | string |
| FTAXAMOUNT | 税额 | string |
| FARPURPOSEID | 收款用途 | string |
| FMATERIALID | 物料编码 | string |
| FApplyInstAmount | 申请付利息金额 | string |
| FUnpaidAmount | 未付款金额 | string |
| FSALEERID | 销售员 | string |
| FScanPoint | 扫描点 | string |
| FSETTLETYPEID | 结算方式 | string |
| FAPPROVERID | 审核人 | string |
| FSRCROWID | 源单行内码 | string |
| FBUSINESSTYPE | 业务类型 | string |
| FCLOSESTATUS | 关闭状态 | string |
| FieldKeys | 需查询的字段key集合 | array |
| FRELATEPAYQTY | 付(退)款关联数量 | string |
| FEACHCCOUNTNAME | 对方账户名称 | string |
| FBankDetail | 银行网点 | string |
| FEACHBANKNAME | 对方开户行 | string |
| FSOURCETYPE | 源单类型 | string |
| FormId | 业务对象表单Id | string |
| FPAYAPPLYENTRY_FEntryID | FPAYAPPLYENTRY_FEntryID | string |
| FDescription | 备注 | string |
| FSALEORGID | 销售组织 | string |
| FCLOSEDATE | 关闭日期 | string |
| FSETTLECUR | 结算币别 | string |
| F_VAOJ_Remarks | 备注 | string |
| FMoreReceive | 多收款人 | string |
| FAPPLYAMOUNTFOR | 申请付款金额 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDOCUMENTSTATUS | 单据状态 | string | |
| FCREATORID | 创建人 | string | |
| FAPPROVERID | 审核人 | string | |
| FCREATEDATE | 创建日期 | string | |
| FSETTLEORGID | 结算组织 | string | |
| FAPPROVEDATE | 审核日期 | string | |
| FPURCHASEORGID | 采购组织 | string | |
| FPAYAMOUNTFOR_H | 应付金额 | string | |
| FCURRENCYID | 币别 | string | |
| FDATE | 申请日期 | string | |
| FMODIFYDATE | 修改日期 | string | |
| FMODIFIERID | 修改人 | string | |
| FBILLTYPEID | 单据类型 | string | |
| FPURCHASERID | 采购员 | string | |
| FPURCHASEDEPTID | 采购部门 | string | |
| FAPPLYAMOUNTFOR_H | 申请付款金额 | string | |
| FACCOUNTSYSTEM | 会计核算体系 | string | |
| FCANCELLERID | 作废人 | string | |
| FCANCELSTATUS | 作废状态 | string | |
| FCANCELDATE | 作废日期 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FRECTUNITTYPE | 收款单位类型 | string | |
| FRECTUNIT | 收款单位 | string | |
| FBUSINESSTYPE | 业务类型 | string | |
| FDEPARTMENT | 部门 | string | |
| FPAYORGID | 付款组织 | string | |
| FSALEORGID | 销售组织 | string | |
| FSALEDEPTID | 销售部门 | string | |
| FSALEERID | 销售员 | string | |
| FMAINBOOKID | 本位币 | string | |
| FEXCHANGERATE | 汇率 | string | |
| FEXCHANGETYPE | 汇率类型 | string | |
| FSOURCESYSTEM | 来源系统 | string | |
| FIsCredit | 是否信贷业务 | string | |
| FBankActID | 银行账号 | string | |
| FAPPLYORGID | 申请组织 | string | |
| FScanPoint | 扫描点 | string | |
| FCLOSESTATUS | 关闭状态 | string | |
| FCLOSERID | 关闭人 | string | |
| FCLOSEDATE | 关闭日期 | string | |
| FSETTLECUR | 结算币别 | string | |
| FREALAPPLYAMOUNTFOR | 实际申请金额 | string | |
| FSETTLERATE | 结算汇率 | string | |
| FAPPLYAMOUNT | 申请付款金额本位币 | string | |
| FPURCHASERGROUPID | 采购组 | string | |
| FSALEGROUPID | 销售组 | string | |
| FIsBorrow | 是否其他预付 | string | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | string | |
| FMoreReceive | 多收款人 | string | |
| FPAYAPPLYENTRY_FEntryID | FPAYAPPLYENTRY_FEntryID | string | |
| FSETTLETYPEID | 结算方式 | string | |
| FPAYAMOUNTFOR | 应付金额 | string | |
| FEACHBANKACCOUNT | 对方银行账号 | string | |
| FAPPLYAMOUNTFOR | 申请付款金额 | string | |
| FPAYPURPOSEID | 付款用途 | string | |
| FARPURPOSEID | 收款用途 | string | |
| FSOURCETYPE | 源单类型 | string | |
| FSRCBILLNO | 源单编号 | string | |
| FENDDATE | 到期日 | string | |
| FEXPECTPAYDATE | 期望付款日期 | string | |
| FEACHCCOUNTNAME | 对方账户名称 | string | |
| FEACHBANKNAME | 对方开户行 | string | |
| FCOMMENT | 备注（作废） | string | |
| FSRCROWID | 源单行内码 | string | |
| FRELATEPAYAMOUNT | 付退款关联金额 | string | |
| FRELATEREFUNDAMOUNT | 作废—收款退款关联金额 | string | |
| FCOSTID | 费用项目 | string | |
| FApplyPclAmount | 申请还本金额 | string | |
| FApplyInstAmount | 申请付利息金额 | string | |
| FWritePclAmount | 关联付利息金额 | string | |
| FDescription | 备注 | string | |
| FMATERIALID | 物料编码 | string | |
| FMATERIALNAME | 物料名称 | string | |
| FPURCHASEORDERNO | 订单号 | string | |
| FMATERIALSEQ | 订单行号 | string | |
| FORDERENTRYID | 订单明细内码 | string | |
| FPRICE | 含税单价 | string | |
| FQTY | 数量 | string | |
| FPRICEUNITID | 计价单位 | string | |
| FRELATEPAYQTY | 付(退)款关联数量 | string | |
| FUnpaidAmount | 未付款金额 | string | |
| FSwiftCode | SwiftCode | string | |
| FTAXAMOUNT | 税额 | string | |
| FBankDetail | 银行网点 | string | |
| FEXPENSEDEPTID | 费用承担部门 | string | |
| F_VAOJ_FQR | 发起人 | string | |
| F_VAOJ_HKSX | 货款属性 | string | |
| F_VAOJ_Remarks | 备注 | string | |
钉钉接口明细
- API：topapi/processinstance/create
- NAME：发起审批实例(官方)
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| process_code | 审批流的唯一码 | PROC-22EDF4E6-5CC9-4712-B9A3-34AEAF37B8AC |
| originator_user_id | 发起人 | findCollection find user_id from 57556c0f-b9ed-38ce-a3d3-d3ad742b0e0d where name={{F_VAOJ_FQR}} |
| dept_id | 发起人所在部门 | _findCollection find leader_in_dept.0.dept_id from 57556c0f-b9ed-38ce-a3d3-d3ad742b0e0d where name={{F_VAOJ_FQR}} |
| form_component_values | 审批流表单参数 | |
| form_component_values.单据编号 |
| form_component_values.货款所属项目 | | {{FSETTLEORGID}} |
| form_component_values.供应商名称 |
| form_component_values.付款时间 | | {{FCREATEDATE date}} |
| form_component_values.货款属性 |
| form_component_values.备注 | | 备注为：{{F_VAOJ_Remarks}} |
| form_component_values.付款金额（元） |
| form_component_values.收款人（公司名称） | | {{FEACHCCOUNTNAME}} |
| form_component_values.收款人帐号 | | {{FEACHBANKACCOUNT}} |
系统数据集成价值
基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到钉钉， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。
