阿里宜搭和金蝶云星空接口打通对接实战
数据源系统:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台，可让用户通过简单的拖拽、配置即可完成应用搭建，为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间，助力企业数字化升级。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：阿里宜搭，然后选择对应的连接器。选择对应的/yida_vpc/form/searchFormDatas.json作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
阿里宜搭接口明细
- 调用接口：/v1/process/getInstances.json
- 接口名称：搜索表单实例详情列表
- 方法：GET
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| appType | 应用ID | string | APP_KFJOIBQ7VRMTDLQSLKQG |
| systemToken | 应用秘钥 | string | JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
| userId | 管理员用户钉钉ID | string | 16000443318138909 |
| language | 语言 | string | zh_CN |
| formUuid | 表单ID | string | FORM-XJ866N71KSXQZ14A13OWC45AMJIJ3YBK9PXPKI7 |
| instanceStatus | 实例状态 | string | COMPLETED |
| currentPage | 当前页 | string | {{PAGINATION_START_PAGE}} |
| pageSize | 每页记录数 | string | {{PAGINATION_PAGE_SIZE}} |
| originatorId | 数据提交人工号 | string | |
| createFrom | 创建开始时间 | string | 2021-12-01 16:00:00 |
| createTo | 创建结束时间 | string | 2031-12-28 16:00:00 |
| modifiedFrom | 修改开始时间 | string | |
| modifiedTo | 修改结束时间 | string | |
| searchFieldJson | 条件 | object | |
| searchFieldJson.radioField_kmr4161k | 类型 | string | 实报实销 |
| searchFieldJson.selectField_kmvrn6yn | 部门过滤 | string | 浪鲸项目部 |
| searchFieldJson.textField_kmvrjgt5 | 申请人 | string | |
| searchFieldJson.approvedResult | 审批结果 | string | agree |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| gmtCreate | 创建时间 | string | |
| gmtModified | 最近修改时间 | string | |
| originatorUserId | 创建人ID | string | |
| originator | 创建人 | string | |
| textareaField_kmr5pxq5 | 报销备注 | string | |
| textField_krric5sp | 月周 | string | |
| dateField_knjy3x23 | 支付日期 | string | |
| textField_kr4souex | 开户行编码 | string | |
| selectField_kq97ayh5 | 支付账号 | string | |
| selectField_kq97ayh4 | 银行名称 | string | |
| selectField_kq8ryql2 | 支付账户 | 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 | |
| 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 | |
| numberField_kpte5p5m | 退回余额的金额数目 | string | |
| selectField_kps4ziqh | 是否退回余额 | string | |
| textField_kr0e3y5s | 大写金额 | string | |
| numberField_kmr5pxpw | 报销金额 | string | |
| selectField_knjrgyjy | 费用类型 | string | |
| selectField_krln85xv | 费用结算组织 | string | |
| associationFormField_kmr5pxq3 | 关联表单 | 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 | |
| selectField_koxm6nvm | 借款类型 | string | |
| textField_ksgtesv1 | 部门ID（借款核销） | string | |
| selectField_knfsj0nc | 借支人部门 | string | |
| textField_kmvrjgt7 | 借支人姓名 | string | |
| radioField_kmr4161k | 费用报销类型 | string | |
| textField_krx3gzsq | 财务BP ID | string | |
| textField_krk95hr8 | 部门中所有子部门ID（报表使用） | string | |
| textField_krluijmr | 会计主管ID | string | |
| textField_kre9gcbl | 项目决策层ID | string | |
| textField_kre7ut6w | 是否个税报销 | string | |
| textField_kr347dt3 | 负责会计 | string | |
| textField_kr1x1q52 | 部门ID（实报实销） | string | |
| textField_krjzbmom | 员工ID | string | |
| selectField_kmvrn6yn | 费用结算部门 | string | |
| textField_kmvrjgt5 | 申请人姓名 | string | |
| text_klkn4yn7 | string | ||
| 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_kr4n1l6c | -费用组织编码 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.radioField_ks9mggs7 | -是否充值到补单平台 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.numberField_kq1n8j60 | -金额 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.selectField_kniak1fg | -费用归属组织 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1i | -费用项目 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1j | -费用类别 | string | |
| tableField_kne0yabj.tableField_kq1n8j5t.textField_ks7fr3y1 | -费用类型 | string |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：费用报销单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| FBillNo | 单据编号 | string | |
| FOrgID | 申请组织 | string | |
| FProposerID | 申请人 | string | |
| FRequestDeptID | 申请部门 | string | |
| FExpenseDeptEntryID | 部门 | 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.FExpenseDeptID | 承担部门 | string | |
| FEntity.FTaxSubmitAmt | 费用金额 | string | |
| FEntity.FTaxAmt | 税额 | string | |
| FEntity.F_PAEZ_CheckBox | 是否充值到补单平台 | string | |
| FEntity.FRemark | 备注 | string | |
| FEntity.FPayBox | 申请付款 | string | |
| FEntity.FRealPay | 实报实付 | string | |
| FEntity.F_PAEZ_SourceNo | 鸿巢单据编号 | string | |
| FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | string | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统对接概况
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与阿里宜搭之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
