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

数据源平台:钉钉

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

对接目标系统:金蝶云星空

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

数据接口配置方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：钉钉的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

钉钉接口明细

调用接口：v1.0/yida/processes/instances
接口名称：获取流程实例（宜搭）
方法：POST

请求参数

字段字段名称类型配置值 pageNumber分页页码string{{PAGINATION_START_PAGE}} pageSize分页大小string{{PAGINATION_PAGE_SIZE}} appType应用IDstringAPP_KFJOIBQ7VRMTDLQSLKQG systemToken应用秘钥stringJR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO userId用户的useridstring16000443318138909 language语言string formUuid表单IDstringFORM-AS966RD17QWQX5X6Z2AIS2KTRREV19BBZ2SPK75 searchFieldJson条件object searchFieldJson.selectField_kmrhvbvj类型string跨组织转账 searchFieldJson.originatorId根据流程发起人工号查询string searchFieldJson.createFromTimeGMT创建时间起始值string_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00') searchFieldJson.createToTimeGMT创建时间终止值string{{CURRENT_TIME datetime}} searchFieldJson.modifiedFromTimeGMT修改时间起始值string searchFieldJson.modifiedToTimeGMT修改时间终止值string searchFieldJson.taskId任务IDstring searchFieldJson.instanceStatus实例状态stringCOMPLETED searchFieldJson.approvedResult流程审批结果stringagree

响应参数

字段字段名称类型配置值 gmtCreate创建时间string gmtModified最近修改时间string originatorUserId创建人IDstring originator创建人string attachmentField_kne12uu3附件string textField_kqkdnv3s编码string selectField_kqhc3rpp名称string selectField_kqhc3rpo收付款类型string textField_krrih8ma月周string dateField_kzdsw3ks（出纳）实际支付时间string dateField_kmrhvbvo支付日期string textField_knjylo4g银行卡号（支付宝账号）string textField_knjylo4e开户行信息（平台）string textField_knjylo4c收入账户户名string textField_kmzza7qm银行卡号（支付宝账号）string textField_knihu0wp开户行信息（平台）string textField_knihu0wo支付账户户名string textField_kr4og5sm收入银行编码string selectField_ksps9piz银行卡号（支付宝账号）string selectField_ksps9piy开户行信息（平台）string selectField_ksps9pix收入账户户名string textField_kr4og5sl支付银行编码string selectField_ksps9piw银行卡号（支付宝账号）string selectField_ksps9piv开户行信息（平台）string selectField_ksps9piu支付账户户名string selectField_kmrhvbvn支付方式string textareaField_kmrhvbvq支付备注string textField_kr0e6qlb大写金额string numberField_kmrhvbvm金额string textField_kr7m8wu4转出部门事业群负责人IDstring textField_kr7m8wu3转出部门事业群负责人IDstring textField_kr7m8wu2转入部门会计IDstring textField_kr7m8wu1转出部门会计IDstring textField_kr7m8wu0业务部门事业群负责人IDstring textField_kr7m8wtz业务部门会计IDstring textField_kr4og5so费用转入组织编码string selectField_kno0ltaq费用转入组织string selectField_kr7m8wub费用转入部门string textField_kr4og5sn费用转出组织编码string selectField_kno0ltar费用转出组织string selectField_kr7m8wu9费用转出部门string textField_kr4o9odb费用组织编码string selectField_knib2epo费用归属组织string selectField_kr7m8wu7业务所属部门string textField_kx1g8gd8费用转出部门编码string selectField_kx1g8gd6费用转出部门string selectField_kmrhvbvj转账类型string textField_kspddqpw流水号string textField_krk99pjb部门中所有子部门ID（报表使用）string selectField_kmvrsfhh申请人部门string textField_kmvrsfhi申请人string text_klkn4yn7string

金蝶云星空接口明细

接口：batchSave
接口名称：资金调拨单新增
接口方法：POST

请求参数

字段名称类型描述 FBillNo单据编号string FBillTypeID类型string FDate日期string FFundsOrgID资金组织string FPayOrgID转出组织string FBankID转出银行string FBankActID转出银行账号string FCURRENCYID币别string FSettleTypeID结算方式string FMAINBOOKID帐薄string FEXCHANGETYPE汇率类型string FFUNDSTRANSFENTRY单据体array FFUNDSTRANSFENTRY.FReceiveOrgId收款组织string FFUNDSTRANSFENTRY.FEntryBankID银行string FFUNDSTRANSFENTRY.FENTRYBANKActID银行账号string FFUNDSTRANSFENTRY.FAmount金额string FFUNDSTRANSFENTRY.FAMOUNT_LC本位币string FFUNDSTRANSFENTRY.FCOMMENT备注string FFUNDSTRANSFENTRY.FDescription摘要string FFUNDSTRANSFENTRY.F_QKZI_Assistant1往来类型string FFUNDSTRANSFENTRY.F_QKZI_Base借出部门string FFUNDSTRANSFENTRY.FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder FFUNDSTRANSFENTRY.Operation执行的操作string FFUNDSTRANSFENTRY.IsAutoSubmitAndAudit提交并审核bool FFUNDSTRANSFENTRY.IsVerifyBaseDataField验证基础资料bool是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统对接总览

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