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

数据源平台:钉钉

钉钉（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

响应参数

字段名称类型描述费用归属项目费用归属项目stringautoFillResponse 报销类别报销类别string_autoFillResponse TextNote_7L0ZKXODKW40TextNote_7L0ZKXODKW40stringautoFillResponse 行政报销类型行政报销类型string_autoFillResponse 项目报销类型项目报销类型stringautoFillResponse 报销明细报销明细array_autoFillResponse 报销明细.费用发生日期费用发生日期stringautoFillResponse 报销明细.报销金额(元)报销金额(元)string_autoFillResponse 报销明细.费用明细费用明细stringautoFillResponse 报销明细.项目费用明细项目费用明细array_autoFillResponse 报销明细.项目费用明细.componentNamecomponentNamestringautoFillResponse 报销明细.项目费用明细.componentTypecomponentTypestring_autoFillResponse 报销明细.项目费用明细.propspropsstringautoFillResponse 报销明细.项目费用明细.总金额总金额string_autoFillResponse 报销明细.项目费用明细.关联审批单关联审批单stringautoFillResponse 报销明细.项目费用明细.TextNote-KDE5B2G3TextNote-KDE5B2G3string_autoFillResponse 报销明细.项目费用明细.电子发票电子发票stringautoFillResponse 报销明细.项目费用明细.收款账号收款账号string_autoFillResponse 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）公司帐号付款（如需公司帐号付款请选择）stringautoFillResponse 报销明细.项目费用明细.报销凭证拍照上传报销凭证拍照上传string_autoFillResponse 报销明细.项目费用明细.附件附件stringautoFillResponse 报销明细.项目费用明细.ididstring_autoFillResponse 报销明细.项目费用明细.titletitlestringautoFillResponse 报销明细.项目费用明细.extendextendobject_autoFillResponse 报销明细.项目费用明细.extend.create_timecreate_timestringautoFillResponse 报销明细.项目费用明细.extend.finish_timefinish_timestring_autoFillResponse 报销明细.项目费用明细.extend.originator_useridoriginator_useridstringautoFillResponse 报销明细.项目费用明细.extend.originator_dept_idoriginator_dept_idstring_autoFillResponse 报销明细.项目费用明细.extend.statusstatusstringautoFillResponse 报销明细.项目费用明细.extend.resultresultstring_autoFillResponse 报销明细.项目费用明细.extend.business_idbusiness_idstringautoFillResponse 报销明细.项目费用明细.extend.originator_dept_nameoriginator_dept_namestring_autoFillResponse 报销明细.项目费用明细.extend.biz_actionbiz_actionstring_autoFillResponse

金蝶云星空接口明细

API：batchSave
NAME：[标准][付款申请单新增]-v1
METHOD：POST

请求参数

接口字段字段名称预设值描述 FID单据编号_findCollection find FID from 85a16772-5481-3a9b-ad07-eb7f0ddd2587 where FBillNo={{单据编号}}单据编号 F_VAOJ_TDD是否同步钉钉已同步单据类型 FormId业务对象表单IdCN_PAYAPPLY必须填写金蝶的表单ID如😛UR_PurchaseOrder Operation执行的操作BatchSave IsAutoSubmitAndAudit提交并审核false IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） NeedUpDateFieldsNeedUpDateFieldsF_VAOJ_TDD

系统数据集成价值

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通钉钉到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。