从钉钉到金蝶云星空通过接口配置打通数据
来源系统:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
接入系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：钉钉，并且选择对应的连接器（关于钉钉的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的获取流程实例（宜搭）接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的费用报销单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
钉钉接口明细
- 接口：v1.0/yida/processes/instances
- 接口名称：获取流程实例（宜搭）
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| pageNumber | 分页页码 | string | 分页页码 |
| pageSize | 分页大小 | string | 分页大小 |
| appType | 应用ID | string | 应用ID |
| systemToken | 应用秘钥 | string | 应用秘钥 |
| userId | 用户的userid | string | 用户的userid |
| language | 语言 | string | 语言，取值：zh_CN：中文（默认值）en_US：英文 |
| formUuid | 表单ID | string | 表单ID |
| searchFieldJson | 条件 | object | |
| searchFieldJson.radioField_kmr4161k | 类型 | string | |
| searchFieldJson.numberField_kmr5pxpw | 报销金额 | string | |
| searchFieldJson.originatorId | 根据流程发起人工号查询 | string | 根据流程发起人工号查询 |
| searchFieldJson.createFromTimeGMT | 创建时间起始值 | string | 创建时间起始值 |
| searchFieldJson.createToTimeGMT | 创建时间终止值 | string | 创建时间终止值 |
| searchFieldJson.modifiedFromTimeGMT | 修改时间起始值 | string | 修改时间起始值 |
| searchFieldJson.modifiedToTimeGMT | 修改时间终止值 | string | 修改时间终止值 |
| searchFieldJson.taskId | 任务ID | string | 任务ID |
| searchFieldJson.instanceStatus | 实例状态 | string | 实例状态 |
| searchFieldJson.approvedResult | 流程审批结果 | 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
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillNo | 单据编号 | string | |
| FOrgID | 申请组织 | string | |
| FProposerID | 申请人 | string | |
| FRequestDeptID | 申请部门 | string | |
| FExpenseDeptID | 费用承担部门 | string | |
| FCurrencyID | 币别 | string | |
| FExchangeTypeID | 汇率类型 | string | |
| FDate | 日期 | string | |
| FCausa | 事由 | string | |
| FExpenseOrgId | 费用承担组织 | string | |
| FLocCurrencyID | 本位币 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FPayOrgId | 付款组织 | string | |
| FPaySettlleTypeID | 结算方式 | string | |
| FBankAccountT | 银行账号 | string | |
| FBankAccountNameT | 银行账户名称 | string | |
| FBankBranchT | 开户银行 | string | |
| FBillTypeID | 单据类型 | string | |
| FEntity | 明细 | array | |
| FEntity.FExpID | 费用项目 | string | |
| FEntity.FExpenseAmount | 金额 | string | |
| FEntity.FExpenseDeptEntryID | 承担部门 | string | |
| FEntity.FTaxSubmitAmt | 费用金额 | string | |
| FEntity.FTaxAmt | 税额 | string | |
| FEntity.F_CheckBox | 是否充值到补单平台 | string | |
| FEntity.FRemark | 备注 | string | |
| FEntity.FEntity_Link | 关联关系 | array | |
| FEntity.FEntity_Link.FEntity_Link_FRuleId | 单据转换内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSTableName | 单据实体表名 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSBillId | 上游单据内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSId | 上游单据实体内码 | string | |
| FEntity.FPayBox | 申请付款 | string | |
| FEntity.FRealPay | 实报实付 | string | |
| FEntity.FSourceNo | 鸿巢单据编号 | string | |
| FEntity.F_QKZI_Base | 我方银行账号 | string | |
| FEntity.F_QKZI_Assistant | 往来类型 | string | |
| FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | string | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统集成总览
通过数据集成平台可视化的快速配置调用接口打通钉钉与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。
