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

对接源平台:钉钉

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

目标系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据集成方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：钉钉，并且选择对应的连接器（关于钉钉的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的获取流程实例（宜搭）接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的付款单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

钉钉接口明细

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

请求参数

字段名称类型 searchFieldJson.approvedResult流程审批结果string language语言string searchFieldJson.selectField_kmpzgwcy类型string searchFieldJson.modifiedFromTimeGMT修改时间起始值string searchFieldJson.createToTimeGMT创建时间终止值string searchFieldJson.instanceStatus实例状态string searchFieldJson.modifiedToTimeGMT修改时间终止值string systemToken应用秘钥string appType应用IDstring searchFieldJson.textField_kmvpl06z发起人string searchFieldJson.taskId任务IDstring userId用户的useridstring pageSize分页大小string searchFieldJson.createFromTimeGMT创建时间起始值string formUuid表单IDstring searchFieldJson条件object searchFieldJson.originatorId根据流程发起人工号查询string pageNumber分页页码string

响应参数

字段名称类型描述 gmtCreate创建时间string gmtModified最近修改时间string originatorUserId创建人IDstring originator创建人string attachmentField_kne126sg附件string textField_kqkdn1dv编码string selectField_kqhc3rpp名称string selectField_kqhc3rpo收付款类型string textField_ksqu3viu大写金额string numberField_ksqu3vit合计金额string textField_kr4sz8k0开户行编码string selectField_kq97ayh5支付账号string selectField_kq97ayh4银行名称string selectField_kq8ryql2支付账户string textField_krvuo78h费用付款组织编码string selectField_krvuo78g费用付款组织string textField_krvuo78f费用承担组织编码string selectField_krvuo78e费用承担组织string textField_krriis1z月周string dateField_kzdsyb61（出纳）实际支付时间string dateField_kmspmipf支付日期string textField_krbpzze3领取人IDstring selectField_krvee1yt现金领取人string textField_kr4lrrn4银行卡号（支付宝账号）string textField_kr4lrrn3开户行信息（平台）string textField_kr4lrrn2账户名（姓名）string textField_kr4lrrn1姓名（或公司名称）string selectField_kr4lrrn0银行卡号（支付宝账号）string selectField_kr4lrrmz开户行信息（平台）string selectField_kny0q3mb账户名（姓名）string textField_kr4lrrmy姓名（或公司名称）string textField_ksgsok7n支付方式编码string selectField_kr4lrrmu是否使用已有银行卡string selectField_kne6pr4e支付方式string numberField_kpt3zpsa付款笔数string textareaField_kmspmiph支付备注string textField_kr0e7mfb大写金额string numberField_krcrmkkr支付工资人数string numberField_kmspmioz金额string numberField_kt0yzsd3实付工资string numberField_l1q3dt9o公积金string numberField_kyi541jx个税string numberField_kyi541jw垫付员工工资string numberField_kyi541jv垫付员工社保string numberField_kyi541ju个人社保string numberField_kt0ymemg应发工资string textField_kzrpvdiu事业群决策层ID（工资）string textField_kzrpvdit会计主管ID（工资）string textField_kypes4pd会计主管IDstring textField_kypes4pc事业群决策层ID(除工资外)string textField_kypes4pb项目决策层IDstring textField_kypes4pa出纳IDstring textField_ksgsok7l部门IDstring textField_krbvbc29员工IDstring selectField_kzrpvdis薪金发放部门string selectField_kmpzgwcy费用类型string textField_kspd9fet流水号string textField_krk9bmwx部门中所有子部门ID（报表使用）string selectField_kmvpqskz部门组织string textField_kmvpl06z申请人string text_klkn4yn7string tableField_ksqrp4ot工资明细array tableField_ksqrp4ot.textField_ksqu3vig工资明细-支付方式编码string tableField_ksqrp4ot.textField_ksqu3vih工资明细-开户行编码string tableField_ksqrp4ot.textField_kxfehy13工资明细-费用承担部门编码string tableField_ksqrp4ot.numberField_l0bqdbt3工资明细-应付职工薪酬string tableField_ksqrp4ot.numberField_l1q3dt9p工资明细-公积金string tableField_ksqrp4ot.numberField_ksqu3vii工资明细-实付工资string tableField_ksqrp4ot.numberField_kt0ymemm工资明细-个税string tableField_ksqrp4ot.numberField_kt0ymemj工资明细-垫付员工工资string tableField_ksqrp4ot.numberField_kt0ymemi工资明细-垫付员工社保string tableField_ksqrp4ot.numberField_kt0ymemh工资明细-个人社保string tableField_ksqrp4ot.selectField_kxfehy12工资明细-费用承担部门string tableField_ksqrp4ot.selectField_ksqu3vid工资明细-支付账号string tableField_ksqrp4ot.selectField_ksqu3vie工资明细-支付账户string tableField_ksqrp4ot.selectField_ksqu3vif工资明细-支付方式string

金蝶云星空接口明细

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

请求参数

字段字段名称类型配置值 FBillNo单据编号string{{textField_kspd9fet}}（FKD） FCURRENCYID币别stringPRE001 FDATE业务日期string_function FROM_UNIXTIME( ( {{dateField_kmspmipf}} / 1000 ) ,'%Y-%m-%d' ) FBillTypeID单据类型stringFKDLX03_SYS FCONTACTUNITTYPE往来单位类型stringBD_Empinfo FCONTACTUNIT往来单位string{{textField_krbvbc29}} FRECTUNITTYPE收款单位类型stringBD_Empinfo FRECTUNIT收款单位string{{textField_krbvbc29}} FBUSINESSTYPE业务类型string3 FPAYORGID付款组织string{{textField_krvuo78h}} FPAYAMOUNTFOR付款金额string{{numberField_kmspmioz}} FEXCHANGETYPE汇率类型stringHLTX01_SYS FSETTLECUR结算币别stringPRE001 FREMARK备注string{{textareaField_kmspmiph}} FPAYBILLENTRY付款单明细arraytableField_ksqrp4ot FPAYBILLENTRY.FSETTLETYPEID结算方式string{{tableField_ksqrp4ot.textField_ksqu3vig}} FPAYBILLENTRY.FACCOUNTID我方银行账号string{{tableField_ksqrp4ot.selectField_ksqu3vid}} FPAYBILLENTRY.FPAYTOTALAMOUNTFOR付款金额string{{tableField_ksqrp4ot.numberField_ksqu3vii}} FPAYBILLENTRY.FPURPOSEID收付款用途stringP0900 FPAYBILLENTRY.FCOMMENT备注string{{textareaField_kmspmiph}} FPAYBILLENTRY.F_Social_Security个人社保string{{tableField_ksqrp4ot.numberField_kt0ymemh}} FPAYBILLENTRY.F_Advance_SocialSecurity垫付员工社保string{{tableField_ksqrp4ot.numberField_kt0ymemi}} FPAYBILLENTRY.F_Other_Deductions员工其他扣款string{{tableField_ksqrp4ot.numberField_kt0ymemj}} FPAYBILLENTRY.F_Individual_Tax个税string{{tableField_ksqrp4ot.numberField_kt0ymemm}} FPAYBILLENTRY.F_provident_fund公积金string{{tableField_ksqrp4ot.numberField_l1q3dt9p}} FPAYBILLENTRY.FormId业务对象表单IdstringAP_PAYBILL FPAYBILLENTRY.Operation执行的操作stringBatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核boolfalse FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

响应参数

字段字段名称类型配置值 FBillNo单据编号string FCURRENCYID币别string FDATE业务日期string FBillTypeID单据类型string FCONTACTUNITTYPE往来单位类型string FCONTACTUNIT往来单位string FRECTUNITTYPE收款单位类型string FRECTUNIT收款单位string FBUSINESSTYPE业务类型string FDepartment部门string FPAYORGID付款组织array FSETTLERATE结算汇率string FPAYAMOUNTFOR付款金额string FEXCHANGETYPE汇率类型string FSETTLECUR结算币别string FEXCHANGERATE汇率string FREMARK备注string FBookingDate期望付款日期string FTHIRDBILLNO第三方单据编号string FIsBorrow是否其他预付string FPRESETASSISTANT1预设辅助资料字段1string FPRESETASSISTANT2预设辅助资料字段2string FPRESETTEXT1预设文本字段1string FPRESETTEXT2预设文本字段2string FPRESETBASE1预设基础资料字段1string FPRESETBASE2预设基础资料字段2string FPAYBILLENTRY付款单明细array FPAYBILLENTRY.FSETTLETYPEID结算方式string FPAYBILLENTRY.FOPPOSITECCOUNTNAME对方账户名称string FPAYBILLENTRY.FHANDLINGCHARGEFOR手续费string FPAYBILLENTRY.FCOSTID费用项目string FPAYBILLENTRY.FPAYAMOUNTFOR_E付款金额string FPAYBILLENTRY.FISPOST是否登账string FPAYBILLENTRY.FPOSTDATE登账日期string FPAYBILLENTRY.FMATERIALID物料编码string FPAYBILLENTRY.FEXPENSEDEPTID_E费用承担部门string FPAYBILLENTRY.FPayType支付类型string FPAYBILLENTRY.FPRICE含税单价string FPAYBILLENTRY.FQTY数量string FPAYBILLENTRY.FTaxAmt税额string FPAYBILLENTRY.FCOMMENT备注string FPAYBILLENTRY.FPAYBILLSRCENTRY_Link关联关系表array FPAYBILLENTRY.FPAYBILLSRCENTRY_Link.FPAYBILLSRCENTRY_Link_FRuleId转换规则string FPAYBILLENTRY.FPAYBILLSRCENTRY_Link.FPAYBILLSRCENTRY_Link_FSTableName源单表string FPAYBILLENTRY.FPAYBILLSRCENTRY_Link.FPAYBILLSRCENTRY_Link_FSBillId源单内码string FPAYBILLENTRY.FPAYBILLSRCENTRY_Link.FPAYBILLSRCENTRY_Link_FSId源单分录内码string

系统数据对接

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

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