钉钉、金蝶云星空通过接口配置数据对接
数据源平台:钉钉
钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
多系统对接方案配置
数据集成平台对应的配置钉钉与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据钉钉的接口参数要求记录在轻易云集成平台。第二步配置钉钉与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
钉钉接口明细
- 接口：v1.0/yida/processes/instances
- 接口名称：获取流程实例（宜搭）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| searchFieldJson.createToTimeGMT | 创建时间终止值 | string |
| systemToken | 应用秘钥 | string |
| searchFieldJson.createFromTimeGMT | 创建时间起始值 | string |
| pageSize | 分页大小 | string |
| searchFieldJson.modifiedFromTimeGMT | 修改时间起始值 | string |
| searchFieldJson.numberField_kpte5p5m | 退还余额数目 | string |
| searchFieldJson.instanceStatus | 实例状态 | string |
| userId | 用户的userid | string |
| searchFieldJson.modifiedToTimeGMT | 修改时间终止值 | string |
| formUuid | 表单ID | string |
| searchFieldJson.selectField_kzfbcx6p | 部门过滤 | string |
| searchFieldJson.selectField_kps4ziqh | 是否退还余额 | string |
| language | 语言 | string |
| searchFieldJson.originatorId | 根据流程发起人工号查询 | string |
| appType | 应用ID | string |
| pageNumber | 分页页码 | string |
| searchFieldJson.approvedResult | 流程审批结果 | string |
| searchFieldJson.radioField_kmr4161k | 费用报销类型 | string |
| searchFieldJson | 条件 | object |
| searchFieldJson.taskId | 任务ID | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| gmtCreate | 创建时间 | string | |
| gmtModified | 最近修改时间 | string | |
| originatorUserId | 创建人ID | string | |
| 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 | 领取人ID | string | |
| selectField_krve6zzy | 现金领取人 | string | |
| textField_ksgrs1iz | 支付方式编码 | string | |
| selectField_kqusm5fn | 是否使用已有银行卡（账号） | string | |
| selectField_kmr5pxpu | 付款方式 | string | |
| textField_kymewuyd | 同类型是否超额 | string | |
| numberField_kpte5p5m | 退回余额的金额数目 | string | |
| selectField_kniak1fg | 费用承担组织1 | string | |
| 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_l08vqg06 | OA培训需求审批单号 | string | |
| textField_ksi8nb3c | 关联表单ID | string | |
| 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 ID | string | |
| textField_krk95hr8 | 部门中所有子部门ID（报表使用） | string | |
| textField_krluijmr | 会计主管ID | string | |
| textField_kre9gcbl | 项目决策层ID | string | |
| textField_kr347dt3 | 负责会计 | string | |
| textField_kr1x1q52 | 部门ID（实报实销） | string | |
| textField_kspfxn6p | 流水号 | string | |
| textField_krjzbmom | 员工ID | string | |
| selectField_kmvrn6yn | 申请部门 | string | |
| textField_kmvrjgt5 | 申请人姓名 | string | |
| text_klkn4yn7 | |
| tableField_kne0yabj | | array | |
| 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 | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：付款退款单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FREFUNDBILLENTRY.FNOTE | 备注 | string |
| FREFUNDBILLENTRY.F_QKZI_Assistant | 往来类型 | string |
| FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool |
| FDepartment | 部门 | string |
| FDATE | 业务日期 | string |
| FBillTypeID | 单据类型 | string |
| FREFUNDBILLENTRY.Operation | 执行的操作 | string |
| FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | string |
| FREFUNDBILLENTRY | 退款单明细 | array |
| FPAYUNITTYPE | 付款单位类型 | string |
| FCONTACTUNIT | 往来单位 | string |
| FPAYUNIT | 付款单位 | string |
| FSETTLECUR | 结算币别 | string |
| FSETTLEORGID | 结算组织 | string |
| FEXCHANGETYPE | 汇率类型 | string |
| FCONTACTUNITTYPE | 往来单位类型 | string |
| FPAYORGID | 付款组织 | string |
| FREFUNDBILLENTRY.FEXPENSEDEPTID_E | 费用承担部门 | string |
| FREMARK | 备注 | string |
| FREFUNDBILLENTRY.FPURPOSEID | 原付款用途 | string |
| FREFUNDBILLENTRY.F_QKZI_Base | 费用项目 | string |
| FREFUNDBILLENTRY.FormId | 业务对象表单Id | string |
| FREFUNDBILLENTRY.F_QKZI_Base1 | 承担部门 | string |
| FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | bool |
| FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | string |
| FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E | 退款金额 | string |
| FCURRENCYID | 币别 | string |
| FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 表体-应退金额 | string |
| FBUSINESSTYPE | 业务类型 | string |
| FBillNo | 单据编号 | string |
数据对接价值
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
