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

关一帆qeasy

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

接通系统：钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

对接目标平台:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

多系统对接方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取钉钉的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

钉钉接口明细

API：topapi/processinstance/get
NAME：获取审批实例详情
METHOD：POST

请求参数

接口字段字段名称预设值描述 process_code审批流的唯一码PROC-B1959981-2CB9-42E9-A054-A975492A5DBB start_time审批实例开始时间。Unix时间戳，单位毫秒。{{LAST_SYNC_TIME}}000 end_time审批实例结束时间，Unix时间戳，单位毫秒{{CURRENT_TIME}}000 size分页参数，每页大小，最多传20。20 cursor分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。

响应参数

接口字段字段名称预设值描述费用归属项目费用归属项目autoFillResponse 报销类别报销类别_autoFillResponse TextNote_7L0ZKXODKW40TextNote_7L0ZKXODKW40autoFillResponse 行政报销类型行政报销类型_autoFillResponse 项目报销类型项目报销类型autoFillResponse 报销明细报销明细_autoFillResponse 报销明细.费用发生日期费用发生日期autoFillResponse 报销明细.报销金额(元)报销金额(元)_autoFillResponse 报销明细.费用明细费用明细autoFillResponse 报销明细.项目费用明细项目费用明细_autoFillResponse 报销明细.项目费用明细.componentNamecomponentNameautoFillResponse 报销明细.项目费用明细.componentTypecomponentType_autoFillResponse 报销明细.项目费用明细.propspropsautoFillResponse 报销明细.项目费用明细.总金额总金额_autoFillResponse 报销明细.项目费用明细.关联审批单关联审批单autoFillResponse 报销明细.项目费用明细.TextNote-KDE5B2G3TextNote-KDE5B2G3_autoFillResponse 报销明细.项目费用明细.电子发票电子发票autoFillResponse 报销明细.项目费用明细.收款账号收款账号_autoFillResponse 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）公司帐号付款（如需公司帐号付款请选择）autoFillResponse 报销明细.项目费用明细.报销凭证拍照上传报销凭证拍照上传_autoFillResponse 报销明细.项目费用明细.附件附件autoFillResponse 报销明细.项目费用明细.idid_autoFillResponse 报销明细.项目费用明细.titletitleautoFillResponse 报销明细.项目费用明细.extendextend_autoFillResponse 报销明细.项目费用明细.extend.create_timecreate_timeautoFillResponse 报销明细.项目费用明细.extend.finish_timefinish_time_autoFillResponse 报销明细.项目费用明细.extend.originator_useridoriginator_useridautoFillResponse 报销明细.项目费用明细.extend.originator_dept_idoriginator_dept_id_autoFillResponse 报销明细.项目费用明细.extend.statusstatusautoFillResponse 报销明细.项目费用明细.extend.resultresult_autoFillResponse 报销明细.项目费用明细.extend.business_idbusiness_idautoFillResponse 报销明细.项目费用明细.extend.originator_dept_nameoriginator_dept_name_autoFillResponse 报销明细.项目费用明细.extend.biz_actionbiz_action_autoFillResponse

金蝶云星空接口明细

调用接口：batchSave
接口名称：[标准][付款申请单新增]-v1
方法：POST

请求参数

字段字段名称类型配置值 FID单据编号stringfindCollection find FID from b91e58dd-b358-385e-a6e9-58ae2b8c37ff where FBillNo={{Number}} F_VAOJ_HKSX货款属性string_function case '{{货款属性}}' when '成品' then 'CP' else 'FL' end FREMARK备注string{{title}}-{{收款人（公司名称）}}-{{备注}} FBillNo单据编号string{{business_id}} FormId业务对象表单IdstringAP_PAYBILL Operation执行的操作stringBatchSave IsAutoSubmitAndAudit提交并审核boolfalse IsVerifyBaseDataField验证基础资料boolfalse NeedUpDateFieldsNeedUpDateFieldsstringF_VAOJ_HKSX,FREMARK,FBillNo

响应参数

字段字段名称类型配置值 callBackStrategy回写方案object callBackStrategy.strategyId方案IDstringed67b3fa-ebfd-3a8a-9ecb-2e1730f0a9e1 callBackStrategy.id审批实例IDstring{{id}} callBackStrategy.business_id审批编号string{{extend.business_id}}

系统数据集成价值

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。