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

源系统:钉钉

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

写入目标:金蝶云星空

金蝶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-TH866OD15SXQ06T31UZP06CVXI3J31C6B3TPKV searchFieldJson条件object searchFieldJson.selectField_kne9dbah类型string销售收款 searchFieldJson.selectField_kzihphju部门过滤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_kne13swd附件string textField_krrik8kb月周string dateField_kzdt0hej（出纳）实际支付时间string dateField_kmrhm14u支付日期string textField_kqkdldg0收付款类型编码string selectField_kqhc3rpp名称string selectField_kqhc3rpo收付款类型string textField_kr4t0q6j开户行编码string selectField_kq97ayh5收付款账号string selectField_kq97ayh4银行名称string selectField_kq8ryql2收付款账户string textField_krltbok3收款方账号string textField_kse8m7d6收款方开户行（平台）string textField_krltbok1收款方户名string textField_kmzzc949汇款账号string textField_kse8m7d5汇款开户行（平台）string textField_kniia1wi汇款账户户名string textField_kse9l95k退款方式编码string selectField_krltbojq退款方式string textField_kse9l95j汇款方式编码string selectField_kmrhm14t汇款方式string textareaField_kmrhm14v支付备注string textField_kr0e8dd7大写金额string numberField_kmrhm14s金额string textField_kwjzqi0e费用承担部门编码string selectField_kwjzqi0d费用承担部门string textField_krvrp44e费用收款组织编码string selectField_krvrp44d费用收款组织string textField_kr4od4a5费用结算组织编码string selectField_knib34jo费用结算组织string textField_ksdy7bcw往来单位类型编码string textField_ksdy7bcv付款单位类型编码string textField_krvw0tz5往来单位编码string selectField_krvw0tz4往来单位string selectField_krvw0tz3往来单位类型string textField_kr4ijmtn付款单位编码string selectField_kqgcfms2付款单位string selectField_kr38pggy付款单位类型string selectField_kne9dbah费用类别string textField_ktuyr3cu项目决策层IDstring textField_ktuyr3ct会计IDstring textField_krk9d78n部门中所有子部门ID（报表使用）string textField_kspcvc0q流水号string selectField_kzihphju预算部门string selectField_kmrhm14p申请部门string textField_kmvrv5xl申请人string text_klkn4yn7string

金蝶云星空接口明细

调用接口：batchSave
接口名称：新增收款单
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string{{textField_kspcvc0q}} FBillTypeID单据类型stringSKDLX01_SYS FDATE日期stringfunction FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' ) FPAYORGID支付组织string{{textField_krvrp44e}} FCONTACTUNITTYPE往来单位类型string{{textField_ksdy7bcv}} FCONTACTUNIT往来单位string{{textField_kr4ijmtn}} FPAYUNITTYPE付款单位类型string{{textField_ksdy7bcv}} FPAYUNIT付款单位string{{textField_kr4ijmtn}} FSETTLEORGID结算组织string{{textField_kr4od4a5}} FEXCHANGETYPE汇率类型stringHLTX01_SYS FRECEIVEBILLENTRY分录array FRECEIVEBILLENTRY.FSETTLETYPEID结算方式string{{textField_kse9l95j}} FRECEIVEBILLENTRY.FPURPOSEID收款用途string{{textField_kqkdldg0}} FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR应收金额string{{numberField_kmrhm14s}} FRECEIVEBILLENTRY.FACCOUNTID我方银行账号string{{selectField_kq97ayh5}} FRECEIVEBILLENTRY.FCOSTDEPARTMENTID费用承担部门string{{textField_kwjzqi0e}} FRECEIVEBILLENTRY.FPOSTDATE登账日期string_function FROM_UNIXTIME( ( {{dateField_kmrhm14u}} / 1000 ) ,'%Y-%m-%d' ) FRECEIVEBILLENTRY.FCOMMENT备注string{{textareaField_kmrhm14v}} FRECEIVEBILLENTRY.F_QKZI_CheckBox是否刷单string{{radioField_l3wtnxo8_id}} FRECEIVEBILLENTRY.FREMARK备注string{{textareaField_kmrhm14v}} FRECEIVEBILLENTRY.F_QKZI_Assistant往来类型string_function case '{{selectField_l3nujj4l}}' when '否' then '" "' when '是' then '{{selectField_l2smcpih_id}}' end FRECEIVEBILLENTRY.FormId业务对象表单IdstringAR_RECEIVEBILL FRECEIVEBILLENTRY.Operation执行的操作stringBatchSave FRECEIVEBILLENTRY.IsAutoSubmitAndAudit提交并审核booltrue FRECEIVEBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

数据对接效果

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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