从钉钉到金蝶云星空通过接口配置打通数据源系统:钉钉钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。对接目标平台:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据对接方案系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：钉钉的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试钉钉接口明细 API： v1.0/yida/processes/instances NAME：获取流程实例（宜搭） METHOD： POST 请求参数接口字段字段名称预设值描述 pageNumber 分页页码 {{PAGINATION_START_PAGE}} 分页页码 pageSize 分页大小 {{PAGINATION_PAGE_SIZE}} 分页大小 appType 应用ID APP_KFJOIBQ7VRMTDLQSLKQG 应用ID systemToken 应用秘钥 JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO 应用秘钥 userId 用户的userid 16000443318138909 用户的userid language 语言语言，取值：zh_CN：中文（默认值）en_US：英文 formUuid 表单ID FORM-SF7668D1WSXQMDD91CVY2DE8N31A3SO3O2TPKI 表单ID searchFieldJson 条件 searchFieldJson.tableField_ks8du8cn 费用类型其他业务退款 searchFieldJson.selectField_kzfbjzzc 部门 searchFieldJson.originatorId 根据流程发起人工号查询根据流程发起人工号查询 searchFieldJson.createFromTimeGMT 创建时间起始值 _function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00') 创建时间起始值 searchFieldJson.createToTimeGMT 创建时间终止值 {{CURRENT_TIME datetime}} 创建时间终止值 searchFieldJson.modifiedFromTimeGMT 修改时间起始值修改时间起始值 searchFieldJson.modifiedToTimeGMT 修改时间终止值修改时间终止值 searchFieldJson.taskId 任务ID 任务ID searchFieldJson.instanceStatus 实例状态 COMPLETED 实例状态 searchFieldJson.approvedResult 流程审批结果 agree 流程审批结果响应参数接口字段字段名称预设值描述 gmtCreate 创建时间 gmtModified 最近修改时间 originatorUserId 创建人ID originator 创建人 attachmentField_kne10frr 附件 textField_krrifpia 月周 dateField_kzdss937 （出纳）实际支付时间 dateField_kmtur42b 支付日期 textField_kr0e5cz1 大写金额 numberField_kmtur429 付款金额 textField_krvc4smc 领取人ID selectField_krvc4smd 现金领取人 textField_knilr38e 店铺名称 textField_kr4srb6g 银行编码 selectField_kq97ayh5 支付账号 selectField_kq97ayh4 银行名称 selectField_kq8ryql2 支付账户 selectField_ksvm8emp 使用组织 selectField_kq97ayh7 收款账号 selectField_kq97ayh6 开户行 textField_kr3bzvp9 供应商编码 selectField_kq8ryqku 账户名称 selectField_kqtes7jf 供应商公司名称 textField_kqvmf2oz 银行账号（支付宝账号） textField_kquqiisq 开户行信息（平台） textField_kquqiisp 账户名（姓名） textField_kquqiiso 姓名（或公司名称） selectField_kqusyuon 银行账号（支付宝账号） selectField_kqusyuom 开户行信息（平台） selectField_kqusyuol 账户名（姓名） textField_kqusyukd 姓名（或公司名称） textField_ksgrv3w7 支付方式编码 selectField_kqusyukc 是否使用已有银行卡（账号） selectField_kmtur42a 支付方式 textareaField_kmtur42c 支付备注 textField_kymd8lvh 是否超额 selectField_kusbhpna 是否有其他业务退款 textField_krvn3q2s 费用付款组织编码 selectField_krvn3q2r 费用付款组织 textField_ksi9cvxv 收款单位编码 textField_ksi9cvxu 收款单位类型编码 textField_ksi9cvxt 往来单位编码 textField_ksi9cvxs 往来单位类型编码 selectField_ksi9cvru 收款单位 selectField_ksi9cvxw 收款单位类型 selectField_ksi9cvrs 往来单位 selectField_ksi9cvrr 往来单位类型 textField_kxsr74nn 当前月份 selectField_kzfbjzzc 预算部门 textField_kqhqqhxg 人员层级 selectField_knb5wqws 费用分类 textField_kznt0sx9 (IT资产预算)项目经营层 textField_kznskx5a 会计节点（IT资产预算） textField_kzmc9fvi 供应链款专用经营层ID textField_kt88xy7u 收付款类型 textField_krx3qkwl 财务BP ID textField_ksgrv3w5 部门ID textField_kr1wqtgr 部门中所有子部门ID（报表使用） textField_krfqhwq1 会计主管ID textField_kren2tv6 事业群负责人ID textField_kren2tv5 项目决策层ID textField_krfqhwq2 出纳ID textField_kren2tv4 会计ID textField_kspditvc 流水号 textField_krjzfufc 员工ID selectField_kmvrqh6p 申请部门 textField_kmvrqh6o 申请人姓名 text_klkn4yn7 tableField_ks8du8cn 付款信息 tableField_ks8du8cn.textField_kr4o8bn3 付款信息-费用结算组织编码 tableField_ks8du8cn.textField_kqhmwk8r 付款信息-费用项目金蝶编码 tableField_ks8du8cn.textField_kqkdoig6 付款信息-付款用途编码 tableField_ks8du8cn.textField_kwjzl5jv 付款信息-费用承担部门编码 tableField_ks8du8cn.textField_kxsr74np 付款信息-预算科目编码 tableField_ks8du8cn.selectField_kqhc3rpp 付款信息-付款用途 tableField_ks8du8cn.numberField_kxsr74no 付款信息-可用余额 tableField_ks8du8cn.numberField_ks8du8cr 付款信息-金额 tableField_ks8du8cn.selectField_kwjzl5ju 付款信息-费用承担部门 tableField_ks8du8cn.selectField_knib19yl 付款信息-费用承担组织 tableField_ks8du8cn.textField_kveoi7y9 付款信息-费用项目说明 tableField_ks8du8cn.selectField_ks8du8cq 付款信息-费用项目 tableField_ks8du8cn.selectField_ks8du8cp 付款信息-费用类别金蝶云星空接口明细调用接口： batchSave 接口名称：付款退款单新增方法： POST 请求参数字段字段名称类型配置值 FBillNo 单据编号 string {{textField_kspditvc}}（FKTK） FSETTLEORGID 结算组织 string {{tableField_ks8du8cn.textField_kr4o8bn3}} FEXCHANGETYPE 汇率类型 string HLTX01_SYS FDATE 业务日期 string function FROM_UNIXTIME( ( {{dateField_kzdss937}} / 1000 ) ,'%Y-%m-%d' ) FCURRENCYID 币别 string PRE001 FBillTypeID 单据类型 string FKTKDLX02_SYS FBUSINESSTYPE 业务类型 string 3 FCONTACTUNITTYPE 往来单位类型 string {{textField_ksi9cvxu}} FCONTACTUNIT 往来单位 string {{textField_ksi9cvxv}} FPAYUNITTYPE 付款单位类型 string {{textField_ksi9cvxu}} FPAYUNIT 付款单位 string {{textField_ksi9cvxv}} FDepartment 部门 string {{tableField_ks8du8cn.textField_kwjzl5jv}} F_QKZI_Assistant 往来类型 string _function case '{{selectField_l3nw36ir}}' when '否' then ' ' when '是' then '{{selectField_l358521u_id}}' end FPAYORGID 付款组织 string {{textField_krvn3q2s}} FSETTLECUR 结算币别 string PRE001 FREMARK 备注 string {{textareaField_kmtur42c}} FREFUNDBILLENTRY 退款单明细 array tableField_ks8du8cn FREFUNDBILLENTRY.FSETTLETYPEID 结算方式 string {{textField_ksgrv3w7}} FREFUNDBILLENTRY.FREFUNDAMOUNTFOR 表体-应退金额 string {{tableField_ks8du8cn.numberField_ks8du8cr}} FREFUNDBILLENTRY.FNOTE 备注 string {{textareaField_kmtur42c}} FREFUNDBILLENTRY.FACCOUNTID 我方银行账号 string {{selectField_kq97ayh5}} FREFUNDBILLENTRY.FEXPENSEDEPTID_E 费用承担部门 string {{tableField_ks8du8cn.textField_kwjzl5jv}} FREFUNDBILLENTRY.FPURPOSEID 原付款用途 string {{tableField_ks8du8cn.textField_kqkdoig6}} FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E 退款金额 string {{tableField_ks8du8cn.numberField_ks8du8cr}} FREFUNDBILLENTRY.F_QKZI_Base 费用项目编码 string {{tableField_ks8du8cn.textField_kqhmwk8r}} FREFUNDBILLENTRY.F_QKZI_Base1 费用承担部门 string {{tableField_ks8du8cn.textField_kwjzl5jv}} FREFUNDBILLENTRY.FormId 业务对象表单Id string AP_REFUNDBILL FREFUNDBILLENTRY.Operation 执行的操作 string BatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit 提交并审核 bool true FREFUNDBILLENTRY.IsVerifyBaseDataField 验证基础资料 bool false 数据对接效果通过数据集成平台可视化的快速配置调用接口打通钉钉与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

从钉钉到金蝶云星空通过接口配置打通数据

汪淼_轻易云

从钉钉到金蝶云星空通过接口配置打通数据

源系统:钉钉

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

对接目标平台:金蝶云星空

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

数据对接方案

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

钉钉接口明细

API：v1.0/yida/processes/instances
NAME：获取流程实例（宜搭）
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
pageNumber	分页页码	{{PAGINATION_START_PAGE}}	分页页码
pageSize	分页大小	{{PAGINATION_PAGE_SIZE}}	分页大小
appType	应用ID	APP_KFJOIBQ7VRMTDLQSLKQG	应用ID
systemToken	应用秘钥	JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO	应用秘钥
userId	用户的userid	16000443318138909	用户的userid
language	语言		语言，取值：zh_CN：中文（默认值）en_US：英文
formUuid	表单ID	FORM-SF7668D1WSXQMDD91CVY2DE8N31A3SO3O2TPKI	表单ID
searchFieldJson	条件
searchFieldJson.tableField_ks8du8cn	费用类型	其他业务退款
searchFieldJson.selectField_kzfbjzzc	部门
searchFieldJson.originatorId	根据流程发起人工号查询		根据流程发起人工号查询
searchFieldJson.createFromTimeGMT	创建时间起始值	_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00')	创建时间起始值
searchFieldJson.createToTimeGMT	创建时间终止值	{{CURRENT_TIME datetime}}	创建时间终止值
searchFieldJson.modifiedFromTimeGMT	修改时间起始值		修改时间起始值
searchFieldJson.modifiedToTimeGMT	修改时间终止值		修改时间终止值
searchFieldJson.taskId	任务ID		任务ID
searchFieldJson.instanceStatus	实例状态	COMPLETED	实例状态
searchFieldJson.approvedResult	流程审批结果	agree	流程审批结果

响应参数

接口字段	字段名称	预设值	描述
gmtCreate	创建时间
gmtModified	最近修改时间
originatorUserId	创建人ID
originator	创建人
attachmentField_kne10frr	附件
textField_krrifpia	月周
dateField_kzdss937	（出纳）实际支付时间
dateField_kmtur42b	支付日期
textField_kr0e5cz1	大写金额
numberField_kmtur429	付款金额
textField_krvc4smc	领取人ID
selectField_krvc4smd	现金领取人
textField_knilr38e	店铺名称
textField_kr4srb6g	银行编码
selectField_kq97ayh5	支付账号
selectField_kq97ayh4	银行名称
selectField_kq8ryql2	支付账户
selectField_ksvm8emp	使用组织
selectField_kq97ayh7	收款账号
selectField_kq97ayh6	开户行
textField_kr3bzvp9	供应商编码
selectField_kq8ryqku	账户名称
selectField_kqtes7jf	供应商公司名称
textField_kqvmf2oz	银行账号（支付宝账号）
textField_kquqiisq	开户行信息（平台）
textField_kquqiisp	账户名（姓名）
textField_kquqiiso	姓名（或公司名称）
selectField_kqusyuon	银行账号（支付宝账号）
selectField_kqusyuom	开户行信息（平台）
selectField_kqusyuol	账户名（姓名）
textField_kqusyukd	姓名（或公司名称）
textField_ksgrv3w7	支付方式编码
selectField_kqusyukc	是否使用已有银行卡（账号）
selectField_kmtur42a	支付方式
textareaField_kmtur42c	支付备注
textField_kymd8lvh	是否超额
selectField_kusbhpna	是否有其他业务退款
textField_krvn3q2s	费用付款组织编码
selectField_krvn3q2r	费用付款组织
textField_ksi9cvxv	收款单位编码
textField_ksi9cvxu	收款单位类型编码
textField_ksi9cvxt	往来单位编码
textField_ksi9cvxs	往来单位类型编码
selectField_ksi9cvru	收款单位
selectField_ksi9cvxw	收款单位类型
selectField_ksi9cvrs	往来单位
selectField_ksi9cvrr	往来单位类型
textField_kxsr74nn	当前月份
selectField_kzfbjzzc	预算部门
textField_kqhqqhxg	人员层级
selectField_knb5wqws	费用分类
textField_kznt0sx9	(IT资产预算)项目经营层
textField_kznskx5a	会计节点（IT资产预算）
textField_kzmc9fvi	供应链款专用经营层ID
textField_kt88xy7u	收付款类型
textField_krx3qkwl	财务BP ID
textField_ksgrv3w5	部门ID
textField_kr1wqtgr	部门中所有子部门ID（报表使用）
textField_krfqhwq1	会计主管ID
textField_kren2tv6	事业群负责人ID
textField_kren2tv5	项目决策层ID
textField_krfqhwq2	出纳ID
textField_kren2tv4	会计ID
textField_kspditvc	流水号
textField_krjzfufc	员工ID
selectField_kmvrqh6p	申请部门
textField_kmvrqh6o	申请人姓名
text_klkn4yn7
tableField_ks8du8cn	付款信息
tableField_ks8du8cn.textField_kr4o8bn3	付款信息-费用结算组织编码
tableField_ks8du8cn.textField_kqhmwk8r	付款信息-费用项目金蝶编码
tableField_ks8du8cn.textField_kqkdoig6	付款信息-付款用途编码
tableField_ks8du8cn.textField_kwjzl5jv	付款信息-费用承担部门编码
tableField_ks8du8cn.textField_kxsr74np	付款信息-预算科目编码
tableField_ks8du8cn.selectField_kqhc3rpp	付款信息-付款用途
tableField_ks8du8cn.numberField_kxsr74no	付款信息-可用余额
tableField_ks8du8cn.numberField_ks8du8cr	付款信息-金额
tableField_ks8du8cn.selectField_kwjzl5ju	付款信息-费用承担部门
tableField_ks8du8cn.selectField_knib19yl	付款信息-费用承担组织
tableField_ks8du8cn.textField_kveoi7y9	付款信息-费用项目说明
tableField_ks8du8cn.selectField_ks8du8cq	付款信息-费用项目
tableField_ks8du8cn.selectField_ks8du8cp	付款信息-费用类别

金蝶云星空接口明细

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

请求参数

字段	字段名称	类型	配置值
FBillNo	单据编号	string	{{textField_kspditvc}}（FKTK）
FSETTLEORGID	结算组织	string	{{tableField_ks8du8cn.textField_kr4o8bn3}}
FEXCHANGETYPE	汇率类型	string	HLTX01_SYS
FDATE	业务日期	string	function FROM_UNIXTIME( ( {{dateField_kzdss937}} / 1000 ) ,'%Y-%m-%d' )
FCURRENCYID	币别	string	PRE001
FBillTypeID	单据类型	string	FKTKDLX02_SYS
FBUSINESSTYPE	业务类型	string	3
FCONTACTUNITTYPE	往来单位类型	string	{{textField_ksi9cvxu}}
FCONTACTUNIT	往来单位	string	{{textField_ksi9cvxv}}
FPAYUNITTYPE	付款单位类型	string	{{textField_ksi9cvxu}}
FPAYUNIT	付款单位	string	{{textField_ksi9cvxv}}
FDepartment	部门	string	{{tableField_ks8du8cn.textField_kwjzl5jv}}
F_QKZI_Assistant	往来类型	string	_function case '{{selectField_l3nw36ir}}' when '否' then ' ' when '是' then '{{selectField_l358521u_id}}' end
FPAYORGID	付款组织	string	{{textField_krvn3q2s}}
FSETTLECUR	结算币别	string	PRE001
FREMARK	备注	string	{{textareaField_kmtur42c}}
FREFUNDBILLENTRY	退款单明细	array	tableField_ks8du8cn
FREFUNDBILLENTRY.FSETTLETYPEID	结算方式	string	{{textField_ksgrv3w7}}
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR	表体-应退金额	string	{{tableField_ks8du8cn.numberField_ks8du8cr}}
FREFUNDBILLENTRY.FNOTE	备注	string	{{textareaField_kmtur42c}}
FREFUNDBILLENTRY.FACCOUNTID	我方银行账号	string	{{selectField_kq97ayh5}}
FREFUNDBILLENTRY.FEXPENSEDEPTID_E	费用承担部门	string	{{tableField_ks8du8cn.textField_kwjzl5jv}}
FREFUNDBILLENTRY.FPURPOSEID	原付款用途	string	{{tableField_ks8du8cn.textField_kqkdoig6}}
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E	退款金额	string	{{tableField_ks8du8cn.numberField_ks8du8cr}}
FREFUNDBILLENTRY.F_QKZI_Base	费用项目编码	string	{{tableField_ks8du8cn.textField_kqhmwk8r}}
FREFUNDBILLENTRY.F_QKZI_Base1	费用承担部门	string	{{tableField_ks8du8cn.textField_kwjzl5jv}}
FREFUNDBILLENTRY.FormId	业务对象表单Id	string	AP_REFUNDBILL
FREFUNDBILLENTRY.Operation	执行的操作	string	BatchSave
FREFUNDBILLENTRY.IsAutoSubmitAndAudit	提交并审核	bool	true
FREFUNDBILLENTRY.IsVerifyBaseDataField	验证基础资料	bool	false

数据对接效果

通过数据集成平台可视化的快速配置调用接口打通钉钉与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。