钉钉和金蝶云星空接口打通对接实战

数据源平台:钉钉
钉钉(DingTalk)是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台,提供PC版,Web版和手机版,有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
对接系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置方案
数据集成平台对应的配置钉钉与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据钉钉的接口参数要求记录在轻易云集成平台。第二步配置钉钉与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。

钉钉接口明细
- 接口:topapi/processinstance/get
- 接口名称:获取审批实例详情
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
process_code | 审批流的唯一码 | string | |
start_time | 审批实例开始时间。Unix时间戳,单位毫秒。 | string | |
end_time | 审批实例结束时间,Unix时间戳,单位毫秒 | string | |
size | 分页参数,每页大小,最多传20。 | string | |
cursor | 分页查询的游标,最开始传0,后续传返回参数中的next_cursor值。 | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
费用归属项目 | 费用归属项目 | string | autoFillResponse |
报销类别 | 报销类别 | string | _autoFillResponse |
TextNote_7L0ZKXODKW40 | TextNote_7L0ZKXODKW40 | string | autoFillResponse |
行政报销类型 | 行政报销类型 | string | _autoFillResponse |
项目报销类型 | 项目报销类型 | string | autoFillResponse |
报销明细 | 报销明细 | array | _autoFillResponse |
报销明细.费用发生日期 | 费用发生日期 | string | autoFillResponse |
报销明细.报销金额(元) | 报销金额(元) | string | _autoFillResponse |
报销明细.费用明细 | 费用明细 | string | autoFillResponse |
报销明细.项目费用明细 | 项目费用明细 | array | _autoFillResponse |
报销明细.项目费用明细.componentName | componentName | string | autoFillResponse |
报销明细.项目费用明细.componentType | componentType | string | _autoFillResponse |
报销明细.项目费用明细.props | props | string | autoFillResponse |
报销明细.项目费用明细.总金额 | 总金额 | string | _autoFillResponse |
报销明细.项目费用明细.关联审批单 | 关联审批单 | string | autoFillResponse |
报销明细.项目费用明细.TextNote-KDE5B2G3 | TextNote-KDE5B2G3 | string | _autoFillResponse |
报销明细.项目费用明细.电子发票 | 电子发票 | string | autoFillResponse |
报销明细.项目费用明细.收款账号 | 收款账号 | string | _autoFillResponse |
报销明细.项目费用明细.公司帐号付款(如需公司帐号付款请选择) | 公司帐号付款(如需公司帐号付款请选择) | string | autoFillResponse |
报销明细.项目费用明细.报销凭证拍照上传 | 报销凭证拍照上传 | string | _autoFillResponse |
报销明细.项目费用明细.附件 | 附件 | string | autoFillResponse |
报销明细.项目费用明细.id | id | string | _autoFillResponse |
报销明细.项目费用明细.title | title | string | autoFillResponse |
报销明细.项目费用明细.extend | extend | object | _autoFillResponse |
报销明细.项目费用明细.extend.create_time | create_time | string | autoFillResponse |
报销明细.项目费用明细.extend.finish_time | finish_time | string | _autoFillResponse |
报销明细.项目费用明细.extend.originator_userid | originator_userid | string | autoFillResponse |
报销明细.项目费用明细.extend.originator_dept_id | originator_dept_id | string | _autoFillResponse |
报销明细.项目费用明细.extend.status | status | string | autoFillResponse |
报销明细.项目费用明细.extend.result | result | string | _autoFillResponse |
报销明细.项目费用明细.extend.business_id | business_id | string | autoFillResponse |
报销明细.项目费用明细.extend.originator_dept_name | originator_dept_name | string | _autoFillResponse |
报销明细.项目费用明细.extend.biz_action | biz_action | string | _autoFillResponse |
金蝶云星空接口明细
- API:batchSave
- NAME:[标准][付款申请单新增]-v1
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FID | 单据编号 | _findCollection find FID from 85a16772-5481-3a9b-ad07-eb7f0ddd2587 where FBillNo={{单据编号}} | 单据编号 |
F_VAOJ_TDD | 是否同步钉钉 | 已同步 | 单据类型 |
FormId | 业务对象表单Id | CN_PAYAPPLY | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
Operation | 执行的操作 | BatchSave | |
IsAutoSubmitAndAudit | 提交并审核 | false | |
IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
NeedUpDateFields | NeedUpDateFields | F_VAOJ_TDD | |
系统数据集成价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通钉钉到金蝶云星空之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。


