钉钉和金蝶云星空集成接口设计

对接系统钉钉

钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。

写入目标:金蝶云星空

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

数据接口配置

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的topapi/processinstance/get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

钉钉接口明细

调用接口：topapi/processinstance/get
接口名称：获取审批实例详情
方法：POST

请求参数

字段字段名称类型配置值 process_code审批流的唯一码stringPROC-C20F7186-8491-4D6D-B0BC-35AE79450B42 start_time审批实例开始时间。Unix时间戳，单位毫秒。string_function ( {{LAST_SYNC_TIME}} - ( 3600 * 96) ) * 1000 end_time审批实例结束时间，Unix时间戳，单位毫秒string{{CURRENT_TIME}}000 size分页参数，每页大小，最多传20。string20 cursor分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。string

响应参数

字段字段名称类型配置值费用归属项目费用归属项目string 报销类别报销类别string TextNote_7L0ZKXODKW40TextNote_7L0ZKXODKW40string 行政报销类型行政报销类型string 项目报销类型项目报销类型string 报销明细报销明细array 报销明细.费用发生日期费用发生日期string 报销明细.报销金额(元)报销金额(元)string 报销明细.费用明细费用明细string 报销明细.项目费用明细项目费用明细array 报销明细.项目费用明细.componentNamecomponentNamestring 报销明细.项目费用明细.componentTypecomponentTypestring 报销明细.项目费用明细.propspropsstring 报销明细.项目费用明细.总金额总金额string 报销明细.项目费用明细.关联审批单关联审批单string 报销明细.项目费用明细.TextNote-KDE5B2G3TextNote-KDE5B2G3string 报销明细.项目费用明细.电子发票电子发票string 报销明细.项目费用明细.收款账号收款账号string 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）公司帐号付款（如需公司帐号付款请选择）string 报销明细.项目费用明细.报销凭证拍照上传报销凭证拍照上传string 报销明细.项目费用明细.附件附件string 报销明细.项目费用明细.ididstring 报销明细.项目费用明细.titletitlestring 报销明细.项目费用明细.extendextendobject 报销明细.项目费用明细.extend.create_timecreate_timestring 报销明细.项目费用明细.extend.finish_timefinish_timestring 报销明细.项目费用明细.extend.originator_useridoriginator_useridstring 报销明细.项目费用明细.extend.originator_dept_idoriginator_dept_idstring 报销明细.项目费用明细.extend.statusstatusstring 报销明细.项目费用明细.extend.resultresultstring 报销明细.项目费用明细.extend.business_idbusiness_idstring 报销明细.项目费用明细.extend.originator_dept_nameoriginator_dept_namestring 报销明细.项目费用明细.extend.biz_actionbiz_actionstring

金蝶云星空接口明细

接口：batchSave
接口名称：新增付款单
接口方法：POST

请求参数

字段名称类型 FSETTLECUR结算币别string FREMARK备注string FCONTACTUNIT往来单位string FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料bool FBillNo单据编号string FSETTLEORGID结算组织string FPAYBILLENTRY.FSETTLETYPEID结算方式string FPAYBILLENTRY.FOPPOSITECCOUNTNAME对方账户名称string FBillTypeID单据类型string FPAYBILLENTRY.FCOMMENT备注string FPAYBILLENTRY.FormId业务对象表单Idstring FPAYBILLENTRY.Operation执行的操作string FPAYBILLENTRY.FCOSTID费用项目string FPAYBILLENTRY付款单明细array FCURRENCYID币别string FPAYBILLENTRY.FPURPOSEID付款用途string FRECTUNITTYPE收款单位类型string FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核bool FPAYBILLENTRY.FDepartment部门string FDATE业务日期string FRECTUNIT收款单位string FPAYORGID付款组织string FCONTACTUNITTYPE往来单位类型string FPAYBILLENTRY.FOPPOSITEBANKACCOUNT对方银行账号string FPAYBILLENTRY.FPAYTOTALAMOUNTFOR应付金额string

响应参数

字段名称类型描述 callBackStrategy回写方案object callBackStrategy.strategyId方案IDstring callBackStrategy.id审批实例IDstring callBackStrategy.business_id审批编号string callBackStrategy.name收款信息string callBackStrategy.originator_userid发起人string

系统数据集成价值

将传统的统计分析转变为预测分析，从被动分析到主动分析，从非实时分析转变为实时分析，从结构化的数据变成多元化的数据。精准查询数据流同步状况，实时监管队列任务以及数据资产的有序管理。为业务赋能，降本增效，让企业能够更加合理的布局团队；结合业务需求实现与OA，CRM，WMS等系统之间的数据交流与同步，为企业定制自定义的数据管理方案，用技术拓展商业边界，为新业务、新部门提供成长空间。

钉钉和金蝶云星空集成接口设计