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

对接系统钉钉

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

写入目标:金蝶云星空

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

接口方案配置

数据集成平台对应的配置钉钉与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据钉钉的接口参数要求记录在轻易云集成平台。第二步配置钉钉与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

钉钉接口明细

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

请求参数

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

响应参数

字段名称类型描述 gmtCreate创建时间string gmtModified最近修改时间string originatorUserId创建人IDstring originator创建人string textField_krric5sp月周string dateField_kzdsnfz6（出纳）实际支付时间string dateField_knjy3x23支付日期string textField_kr4souex银行编码string selectField_kq97ayh5支付账号string selectField_kq97ayh4银行名称string selectField_kq8ryql2支付账户string selectField_ksu2g8j8费用付款组织string textField_kqvme8kb银行账号（支付宝账号）string textField_kquqcu4u开户行信息（平台）string textField_kquqcu4t账户名（姓名）string textField_kquqcu4s姓名（或公司名称）string selectField_kqusm5fz银行账号（支付宝账号）string selectField_kqusm5fy开户行信息（平台）string selectField_kqusm5fx账户名（姓名）string textField_kqusm5fo姓名（或公司名称）string textareaField_kmr5pxq5报销备注string textField_kqkdpdhd编码string selectField_kqhc3rpp名称string selectField_kqhc3rpo收付款类型string textField_krve6zzz领取人IDstring selectField_krve6zzy现金领取人string textField_ksgrs1iz支付方式编码string selectField_kqusm5fn是否使用已有银行卡（账号）string selectField_kmr5pxpu付款方式string textField_kymewuyd同类型是否超额string numberField_kpte5p5m退回余额的金额数目string selectField_kniak1fg费用承担组织1string selectField_kps4ziqh是否退回余额string textField_kr0e3y5s大写金额string numberField_kmr5pxpw报销金额string textField_ktwpaca7原借款单付款组织编码string textField_ksib71rm费用结算组织编码string selectField_krln85xv费用结算组织string selectField_l08vqg09是培训费吗string textField_kre7ut6w是否个税报销string textField_l08vqg06OA培训需求审批单号string textField_ksi8nb3c关联表单IDstring associationFormField_kmr5pxq3关联表单string textField_kxsqd7f2当前月份string selectField_kzfbcx6p预算部门string selectField_knjrgyjy费用类型string numberField_kniuzfrc总借支金额string numberField_kniuzfra其他专项费用已借支金额string numberField_kniuzfr8运营费用已借支金额string numberField_kniuzfr6管理费用已借支金额string numberField_kneagd39总借支金额string numberField_kn74cez2其他专项费用已借支金额string numberField_kn74cez1运营费用已借支金额string numberField_kn74cez0管理费用已借支金额string textField_kqi4t37d人员层级string textField_ksgtesv1部门ID（借款核销）string selectField_knfsj0nc借支人部门string textField_kmvrjgt7借支人姓名string selectField_koxm6nvm预算类型string radioField_kmr4161k费用报销类型string textField_krx3gzsq财务BP IDstring textField_krk95hr8部门中所有子部门ID（报表使用）string textField_krluijmr会计主管IDstring textField_kre9gcbl项目决策层IDstring textField_kr347dt3负责会计string textField_kr1x1q52部门ID（实报实销）string textField_kspfxn6p流水号string textField_krjzbmom员工IDstring selectField_kmvrn6yn申请部门string textField_kmvrjgt5申请人姓名string text_klkn4yn7 tableField_kne0yabjarray tableField_kne0yabj.attachmentField_kne0yabk-附件string tableField_kne0yabj.tableField_kq1n8j5t费用明细array tableField_kne0yabj.tableField_kq1n8j5t.textField_kqlroj9m费用明细-金蝶费用科目编码string tableField_kne0yabj.tableField_kq1n8j5t.textField_kwjzbbra费用明细-费用承担部门编码string tableField_kne0yabj.tableField_kq1n8j5t.textField_kr4n1l6c费用明细-费用组织编码string tableField_kne0yabj.tableField_kq1n8j5t.textField_kxsqd7ey费用明细-预算科目编码string tableField_kne0yabj.tableField_kq1n8j5t.radioField_ks9mggs7费用明细-是否充值到补单平台string tableField_kne0yabj.tableField_kq1n8j5t.numberField_kxsqd7ez费用明细-可用余额string tableField_kne0yabj.tableField_kq1n8j5t.numberField_kq1n8j60费用明细-金额string tableField_kne0yabj.tableField_kq1n8j5t.selectField_kwjzbbr9费用明细-费用承担部门string tableField_kne0yabj.tableField_kq1n8j5t.selectField_kwlrelvy费用明细-费用承担组织string tableField_kne0yabj.tableField_kq1n8j5t.textField_kveog2i7费用明细-费用项目说明string tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1i费用明细-费用项目string tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1j费用明细-费用类别string

金蝶云星空接口明细

API：batchSave
NAME：费用报销单新增
METHOD：POST

请求参数

接口字段名称预设值 FBillNo单据编号 FOrgID申请组织{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kr4n1l6c}} FProposerID申请人{{textField_krjzbmom}} FRequestDeptID申请部门{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kwjzbbra}} FExpenseDeptID费用承担部门{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kwjzbbra}} FCurrencyID币别PRE001 FExchangeTypeID汇率类型HLTX01_SYS FDate日期function FROM_UNIXTIME( ( {{dateField_kzdsnfz6}} / 1000 ) ,'%Y-%m-%d' ) FCausa事由{{textareaField_kmr5pxq5}} FExpenseOrgId费用承担组织{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kr4n1l6c}} FLocCurrencyID本位币PRE001 FCONTACTUNITTYPE往来单位类型BD_Empinfo FCONTACTUNIT往来单位{{textField_krjzbmom}} FPayOrgId付款组织{{textField_ksib71rm}} FPaySettlleTypeID结算方式JSFS04_SYS FBankAccountT银行账号{{selectField_kq97ayh5}} FBankAccountNameT银行账户名称{{selectField_kq8ryql2}} FBankBranchT开户银行{{selectField_kq97ayh4}} F_QKZI_Base我方银行账号{{selectField_kq97ayh5}} FBillTypeID单据类型FYBXD001_SYS FEntity明细tableField_kq1n8j5t FEntity.FExpID费用项目{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kqlroj9m}} FEntity.FExpenseAmount金额{{tableField_kq1n8j5t.tableField_kq1n8j5t_numberField_kq1n8j60}} FEntity.FExpenseDeptEntryID承担部门{{tableField_kq1n8j5t.tableField_kq1n8j5t_textField_kwjzbbra}} FEntity.FTaxSubmitAmt费用金额{{tableField_kq1n8j5t.tableField_kq1n8j5t_numberField_kq1n8j60}} FEntity.FTaxAmt税额 FEntity.FCheckBox是否充值到补单平台{{tableField_kq1n8j5t.tableField_kq1n8j5t_radioField_ks9mggs7}} FEntity.FRemark备注{{textareaField_kmr5pxq5}} FEntity.FPayBox申请付款true FEntity.FRealPay实报实付true FEntity.FSourceNo鸿巢单据编号{{textField_kspfxn6p}}（FYSQ） FEntity.F_QKZI_Assistant往来类型_function case '{{selectField_l3mh2g4o}}' when '否' then '" "' when '是' then '{{selectField_l3lf264c_id}}' end FEntity.FormId业务对象表单IdER_ExpReimbursement FEntity.Operation执行的操作BatchSave FEntity.IsAutoSubmitAndAudit提交并审核false FEntity.IsVerifyBaseDataField验证基础资料false

数据对接效果

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。

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