钉钉和金蝶云星空接口打通对接实战
源系统:钉钉
钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：钉钉接口：获取审批实例详情通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：新增付款单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
钉钉接口明细
- API：topapi/processinstance/get
- NAME：获取审批实例详情
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| process_code | 审批流的唯一码 | PROC-69D355CE-45DE-4372-9D3B-E4DCABCA57AA |
| start_time | 审批实例开始时间。Unix时间戳，单位毫秒。 | 1659024000000 |
| end_time | 审批实例结束时间，Unix时间戳，单位毫秒 | 1659110400000 |
| 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 | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：新增付款单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FDATE | 业务日期 | string |
| FRECTUNIT | 收款单位 | string |
| FPAYBILLENTRY.FPAYTOTALAMOUNTFOR | 应付金额 | string |
| FPAYBILLENTRY.Operation | 执行的操作 | string |
| FPAYBILLENTRY | 付款单明细 | array |
| FPAYBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool |
| FCONTACTUNITTYPE | 往来单位类型 | string |
| FPAYBILLENTRY.FDepartment | 部门 | string |
| FSETTLECUR | 结算币别 | string |
| FCONTACTUNIT | 往来单位 | string |
| FBillNo | 单据编号 | string |
| FPAYBILLENTRY.FCOSTID | 费用项目 | string |
| FPAYBILLENTRY.FormId | 业务对象表单Id | string |
| FCURRENCYID | 币别 | string |
| FPAYBILLENTRY.FOPPOSITECCOUNTNAME | 对方账户名称 | string |
| FPAYBILLENTRY.FCOMMENT | 备注 | string |
| FBillTypeID | 单据类型 | string |
| FPAYORGID | 付款组织 | string |
| FSETTLEORGID | 结算组织 | string |
| FPAYBILLENTRY.FSETTLETYPEID | 结算方式 | string |
| FPAYBILLENTRY.FPURPOSEID | 付款用途 | string |
| FPAYBILLENTRY.FOPPOSITEBANKACCOUNT | 对方银行账号 | string |
| FPAYBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool |
| FREMARK | 备注 | string |
| FRECTUNITTYPE | 收款单位类型 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| callBackStrategy | 回写方案 | object | |
| callBackStrategy.strategyId | 方案ID | string | |
| callBackStrategy.id | 审批实例ID | string | |
| callBackStrategy.business_id | 审批编号 | string | |
| callBackStrategy.name | 收款信息 | string | |
| callBackStrategy.originator_userid | 发起人 | string | |
数据对接价值
使用全界面可视化配置集成流，快速应对企业的集成需求使得钉钉与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。
