阿里宜搭与金蝶云星空对接集成搜索表单实例详情列表打通费用报销单新增
对接系统：阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台，可让用户通过简单的拖拽、配置即可完成应用搭建，为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间，助力企业数字化升级。
集成系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据对接方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：阿里宜搭，并且选择对应的连接器（关于阿里宜搭的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的搜索表单实例详情列表接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的费用报销单新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
阿里宜搭接口明细
- API：/yida_vpc/process/getInstances.json
- NAME：搜索表单实例详情列表
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| appType | 应用ID | APP_DYCTQDDB8CX2SDQ6YRJH | 示例：APP_PBKT0MFBEBTDO8T7SLVP |
| systemToken | 应用秘钥 | QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 | |
| userId | 管理员用户钉钉ID | 016654026426409112 | 钉钉的userId |
| language | 语言 | zh_CN | |
| formUuid | 表单ID | FORM-FV966U91LS2V8ZZZ2JLRL4GS7BE432SHUDXVK41 | |
| instanceStatus | 实例状态 | COMPLETED | |
| currentPage | 当前页 | {{PAGINATION_START_PAGE}} | |
| pageSize | 每页记录数 | {{PAGINATION_PAGE_SIZE}} | |
| originatorId | 数据提交人工号 | | 用户钉钉ID |
| createFrom | 创建开始时间 | | |
| createTo | 创建结束时间 | | |
| modifiedFrom | 修改开始时间 | {{DAYS_AGO_1 date}} | |
| modifiedTo | 修改结束时间 | {{CURRENT_TIME date}} | |
| searchFieldJson | 条件 | | |
| searchFieldJson.radioField_kvxrloar | 申请类型 | 员工 | |
| searchFieldJson.selectField_kvx7pmke | 是否借款 | 否 | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| gmtCreate | 创建时间 | | |
| gmtModified | 最近修改时间 | | |
| originatorUserId | 创建人ID | | |
| originator | 创建人 | | |
| attachmentField_kvx7pmjz | 附件 | | |
| imageField_kvx7pmjy | 图片上传 | | |
| dateField_kw0bado7 | 付款日期 | | |
| selectField_kvx7pml8 | 支付银行账号 | | |
| textField_kwc795b4 | 结算方式编码 | | |
| selectField_kvx7pml7 | 结算方式 | | |
| textareaField_kvx7pmjp | 事由 | | |
| numberField_kvxgr707 | 核销后还需付款金额 | | |
| numberField_kvxgr706 | 核销金额 | | |
| numberField_kw2uuo99 | 总申请金额 | | |
| textareaField_kvx7pmjj | 业务描述 | | |
| textField_kw1faw4z | 银行账号 | | |
| textField_kvx7pmiw | 开户行名称 | | |
| textField_kvx7pmkl | 收款人 | | |
| textField_kwc795ay | 客户编码 | | |
| selectField_kvxrloav | 客户 | | |
| textField_kwc795aw | 供应商编码 | | |
| selectField_kvxrloau | 供应商 | | |
| textField_kwbwf1sp | 员工编码 | | |
| selectField_kvxrloas | 员工 | | |
| radioField_kvxrloar | 往来单位类型 | | |
| dateField_kvx7pmkc | 预计核销日期 | | |
| selectField_kvx7pmke | 申请借款 | | |
| selectField_kvx7pmj8 | 付款类别 | | |
| textField_kw01ezvb | 付款类别-文本 | | |
| textField_kwc795b1 | 申请部门编码 | | |
| dateField_kvx7pmi1 | 申请日期 | | |
| selectField_kvx7pmkd | 申请部门 | | |
| textField_kvxjvp6n | 部门-文本 | | |
| textField_kwc795b0 | 申请人编码 | | |
| selectField_kvx6398f | 申请人 | | |
| textField_kvxjvp6m | 组织-文本 | | |
| textField_kwc795az | 组织编码 | | |
| selectField_kvx6398d | 申请组织 | | |
| tableField_kvxg1udz | 明细 | | |
| tableField_kvxg1udz.dateField_kvx7pmka | 明细-预算日期 | | |
| tableField_kvxg1udz.textareaField_kvx7pmjo | 明细-财务备注 | | |
| tableField_kvxg1udz.numberField_kwd8kkl9 | 明细-税额 | | |
| tableField_kvxg1udz.numberField_kwd8kkl8 | 明细-税率 | | |
| tableField_kvxg1udz.numberField_kvx63996 | 明细-申请金额 | | |
| tableField_kvxg1udz.textField_kwc795b3 | 明细-费用承担部门编码 | | |
| tableField_kvxg1udz.selectField_kvx7pmk9 | 明细-费用承担部门 | | |
| tableField_kvxg1udz.textField_kwc795b2 | 明细-费用项目编码 | | |
| tableField_kvxg1udz.selectField_kvx63994 | 明细-费用项目 | | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：费用报销单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FProposerID | 申请人 | string | |
| FRequestDeptID | 申请部门 | string | |
| FExpenseDeptID | 承担部门 | string | |
| FCurrencyID | 币别 | string | |
| FExchangeTypeID | 汇率类型 | string | |
| FOrgID | 申请组织 | string | |
| FDate | 日期 | string | |
| FExpenseOrgId | 费用承担组织 | string | |
| FLocCurrencyID | 本位币 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FBillTypeID | 单据类型 | string | |
| F_YDID | 宜搭ID | string | |
| FCausa | 事由 | string | |
| FACCOUNTID | 银行账号 | string | |
| FEntity | 明细 | array | |
| FEntity.FExpID | 费用项目 | string | |
| FEntity.FExpenseAmount | 金额 | string | |
| FEntity.FExpenseDeptEntryID | 费用承担部门 | string | |
| FEntity.FTaxRate | 税率% | string | |
| FEntity.FEntity_Link | 关联关系表 | array | |
| FEntity.FEntity_Link.FLinkId | 实体主键 | string | |
| FEntity.FEntity_Link.FEntity_Link_FFlowId | 业务流程图 | string | |
| FEntity.FEntity_Link.FEntity_Link_FFlowLineId | 推进路线 | string | |
| FEntity.FEntity_Link.FEntity_Link_FRuleId | 转换规则 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSTableId | 源单表内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSTableName | 源单表 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSBillId | 源单内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSId | 源单分录内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSrcOffSetAmountOld | 原始携带量 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSrcOffSetAmount | 修改携带量 | string | |
| FEntity.FEntity_Link.FEntity_Link_FRELRQAMOUNTOld | 原始携带量 | string | |
| FEntity.FEntity_Link.FEntity_Link_FRELRQAMOUNT | 修改携带量 | string | |
| FEntity.FEntity_Link.FRemark | 备注 | string | |
| FEntity.FPaySettlleTypeID | 结算方式 | string | |
| FEntity.F_PAEZ_Base | 部门/店长审批 | string | |
| FEntity.F_PAEZ_Date | 付款日期 | string | |
| FEntity.FYDNUM1 | 宜搭流水号 | string | |
| FEntity.F_PAEZ_Assistant | 付款类别 | string | |
| FEntity.FPayOrgId | 付款组织 | string | |
| FEntity.FPayBox | 申请付款 | string | |
| FEntity.F_PAEZ_Remarks | 业务备注 | string | |
| FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | string | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
系统对接概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
