钉钉和金蝶云星空集成接口设计
来源系统:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据集成方案配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的topapi/processinstance/get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
钉钉接口明细
- API：topapi/processinstance/get
- NAME：获取审批实例详情
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| process_code | 审批流的唯一码 | PROC-EA17A524-9921-4A19-88A7-B0D6A336A8DE |
| start_time | 审批实例开始时间。Unix时间戳，单位毫秒。 | _function ( {{LAST_SYNC_TIME}} - ( 3600 * 96) ) * 1000 |
| end_time | 审批实例结束时间，Unix时间戳，单位毫秒 | {{CURRENT_TIME}}000 |
| size | 分页参数，每页大小，最多传20。 | 20 |
| cursor | 分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。 | |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| 费用归属项目 | 费用归属项目 | |
| 报销类别 | 报销类别 | |
| TextNote_7L0ZKXODKW40 | TextNote_7L0ZKXODKW40 | |
| 行政报销类型 | 行政报销类型 | |
| 项目报销类型 | 项目报销类型 | |
| 报销明细 | 报销明细 | |
| 报销明细.费用发生日期 | 费用发生日期 | |
| 报销明细.报销金额(元) | 报销金额(元) | |
| 报销明细.费用明细 | 费用明细 | |
| 报销明细.项目费用明细 | 项目费用明细 | |
| 报销明细.项目费用明细.componentName | componentName | |
| 报销明细.项目费用明细.componentType | componentType | |
| 报销明细.项目费用明细.props | props | |
| 报销明细.项目费用明细.总金额 | 总金额 | |
| 报销明细.项目费用明细.关联审批单 | 关联审批单 | |
| 报销明细.项目费用明细.TextNote-KDE5B2G3 | TextNote-KDE5B2G3 | |
| 报销明细.项目费用明细.电子发票 | 电子发票 | |
| 报销明细.项目费用明细.收款账号 | 收款账号 | |
| 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择） | 公司帐号付款（如需公司帐号付款请选择） | |
| 报销明细.项目费用明细.报销凭证拍照上传 | 报销凭证拍照上传 | |
| 报销明细.项目费用明细.附件 | 附件 | |
| 报销明细.项目费用明细.id | id | |
| 报销明细.项目费用明细.title | title | |
| 报销明细.项目费用明细.extend | extend | |
| 报销明细.项目费用明细.extend.create_time | create_time | |
| 报销明细.项目费用明细.extend.finish_time | finish_time | |
| 报销明细.项目费用明细.extend.originator_userid | originator_userid | |
| 报销明细.项目费用明细.extend.originator_dept_id | originator_dept_id | |
| 报销明细.项目费用明细.extend.status | status | |
| 报销明细.项目费用明细.extend.result | result | |
| 报销明细.项目费用明细.extend.business_id | business_id | |
| 报销明细.项目费用明细.extend.originator_dept_name | originator_dept_name | |
| 报销明细.项目费用明细.extend.biz_action | biz_action | |
金蝶云星空接口明细
- API：batchSave
- NAME：新增付款单
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillNo | 单据编号 | {{extend.business_id}} |
| FBillTypeID | 单据类型 | FKDLX04_SYS |
| FDATE | 业务日期 | {{extend.create_time}} |
| FSETTLEORGID | 结算组织 | 10.01 |
| FPAYORGID | 付款组织 | 10.01 |
| FCURRENCYID | 币别 | PRE001 |
| FCONTACTUNITTYPE | 往来单位类型 | BD_Department |
| FCONTACTUNIT | 往来单位 | {{费用归属部门关联}} |
| FRECTUNITTYPE | 收款单位类型 | BD_Department |
| FRECTUNIT | 收款单位 | {{费用归属部门_关联}} |
| FREMARK | 备注 | {{title}}&{{项目报销类型}}&{{报销明细.费用明细}} |
| FSETTLECUR | 结算币别 | PRE001 |
| FPAYBILLENTRY | 付款单明细 | |
| FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | {{付款方式}} |
| FPAYBILLENTRY.FPURPOSEID | 付款用途 | SFKYT002 |
| FPAYBILLENTRY.FPAYTOTALAMOUNTFOR | 应付金额 | {{报销金额（元）}} |
| FPAYBILLENTRY.FCOSTID | 费用项目 | findCollection find FNumber from b02f1e34-b500-3075-8b14-08fec61d08a4 where FName={{项目报销类}} |
| FPAYBILLENTRY.FCOMMENT | 备注 | {{报销明细.费用明细}} |
| FPAYBILLENTRY.FOPPOSITEBANKACCOUNT | 对方银行账号 | {{账号}} |
| FPAYBILLENTRY.FOPPOSITECCOUNTNAME | 对方账户名称 | {{用户名}} |
| FPAYBILLENTRY.FDepartment | 部门 | _findCollection find Number from 400f56e7-e846-35e5-9017-c28fd7303fb0 where Name={{费用归属部门}} |
| FPAYBILLENTRY.FormId | 业务对象表单Id | AP_PAYBILL |
| FPAYBILLENTRY.Operation | 执行的操作 | BatchSave |
| FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | false |
| FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| callBackStrategy | 回写方案 | |
| callBackStrategy.strategyId | 方案ID | 97cce894-15a8-3c23-a1ee-0c50bbf587cf |
| callBackStrategy.id | 审批实例ID | {{id}} |
| callBackStrategy.business_id | 审批编号 | {{extend.business_id}} |
| callBackStrategy.name | 收款信息 | {{收款信息.name}} |
| callBackStrategy.originator_userid | 发起人 | {{extend.originator_userid}} |
系统数据对接
采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
