阿里宜搭和金蝶云星空接口打通对接实战

来源系统:阿里宜搭
宜搭是阿里巴巴自研的低代码应用搭建平台,传统情况下需要2周才能搭建完成的应用,用宜搭2小时就可完成。宜搭于2019年3月上线,用户可以在可视化界面上以拖拉拽的方式编辑和配置页面,表单和流程,并一键发布到PC和手机端。
对接目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:阿里宜搭的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:金蝶云星空,把获取的数据组装成目标系统需要的格式进行写入。

阿里宜搭接口明细
- 调用接口:/yida_vpc/process/getInstances.json
- 接口名称:搜索表单实例详情列表
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| appType | 应用ID | string | APP_DYCTQDDB8CX2SDQ6YRJH |
| systemToken | 应用秘钥 | string | QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 |
| userId | 管理员用户钉钉ID | string | 016654026426409112 |
| language | 语言 | string | zh_CN |
| formUuid | 表单ID | string | FORM-FV966U91LS2V8ZZZ2JLRL4GS7BE432SHUDXVK41 |
| instanceStatus | 实例状态 | string | COMPLETED |
| currentPage | 当前页 | string | {{PAGINATION_START_PAGE}} |
| pageSize | 每页记录数 | string | {{PAGINATION_PAGE_SIZE}} |
| originatorId | 数据提交人工号 | string | |
| createFrom | 创建开始时间 | string | |
| createTo | 创建结束时间 | string | |
| modifiedFrom | 修改开始时间 | string | {{LAST_SYNC_TIME date}} |
| modifiedTo | 修改结束时间 | string | 2025-08-25 09:24:14 |
| searchFieldJson | 条件 | object | |
| searchFieldJson.radioField_kvxrloar | 申请类型 | string | 供应商 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| gmtCreate | 创建时间 | string | |
| gmtModified | 最近修改时间 | string | |
| originatorUserId | 创建人ID | string | |
| originator | 创建人 | string | |
| attachmentField_kvx7pmjz | 附件 | string | |
| imageField_kvx7pmjy | 图片上传 | string | |
| dateField_kw0bado7 | 付款日期 | string | |
| selectField_kvx7pml8 | 支付银行账号 | string | |
| textField_kwc795b4 | 结算方式编码 | string | |
| selectField_kvx7pml7 | 结算方式 | string | |
| textareaField_kvx7pmjp | 事由 | string | |
| numberField_kvxgr707 | 核销后还需付款金额 | string | |
| numberField_kvxgr706 | 核销金额 | string | |
| numberField_kw2uuo99 | 总申请金额 | string | |
| textareaField_kvx7pmjj | 业务描述 | string | |
| textField_kw1faw4z | 银行账号 | string | |
| textField_kvx7pmiw | 开户行名称 | string | |
| textField_kvx7pmkl | 收款人 | string | |
| textField_kwc795ay | 客户编码 | string | |
| selectField_kvxrloav | 客户 | string | |
| textField_kwc795aw | 供应商编码 | string | |
| selectField_kvxrloau | 供应商 | string | |
| textField_kwbwf1sp | 员工编码 | string | |
| selectField_kvxrloas | 员工 | string | |
| radioField_kvxrloar | 往来单位类型 | string | |
| dateField_kvx7pmkc | 预计核销日期 | string | |
| selectField_kvx7pmke | 申请借款 | string | |
| selectField_kvx7pmj8 | 付款类别 | string | |
| textField_kw01ezvb | 付款类别-文本 | string | |
| textField_kwc795b1 | 申请部门编码 | string | |
| dateField_kvx7pmi1 | 申请日期 | string | |
| selectField_kvx7pmkd | 申请部门 | string | |
| textField_kvxjvp6n | 部门-文本 | string | |
| textField_kwc795b0 | 申请人编码 | string | |
| selectField_kvx6398f | 申请人 | string | |
| textField_kvxjvp6m | 组织-文本 | string | |
| textField_kwc795az | 组织编码 | string | |
| selectField_kvx6398d | 申请组织 | string | |
| tableField_kvxg1udz | 明细 | array | |
| tableField_kvxg1udz.dateField_kvx7pmka | 明细-预算日期 | string | |
| tableField_kvxg1udz.textareaField_kvx7pmjo | 明细-财务备注 | string | |
| tableField_kvxg1udz.numberField_kwd8kkl9 | 明细-税额 | string | |
| tableField_kvxg1udz.numberField_kwd8kkl8 | 明细-税率 | string | |
| tableField_kvxg1udz.numberField_kvx63996 | 明细-申请金额 | string | |
| tableField_kvxg1udz.textField_kwc795b3 | 明细-费用承担部门编码 | string | |
| tableField_kvxg1udz.selectField_kvx7pmk9 | 明细-费用承担部门 | string | |
| tableField_kvxg1udz.textField_kwc795b2 | 明细-费用项目编码 | string | |
| tableField_kvxg1udz.selectField_kvx63994 | 明细-费用项目 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:费用申请新增
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| FDate | 日期 | function FROM_UNIXTIME( ( {{dateField_kvx7pmi1}} / 1000 ) ,'%Y-%m-%d' ) | |
| FStaffID | 申请人 | {{textField_kwc795b0}} | |
| FDeptID | 申请部门 | {{textField_kwc795b1}} | |
| FReason | 事由 | {{textareaField_kvx7pmjp}} | |
| FOrgID | 申请组织 | {{textField_kwc795az}} | |
| FCurrencyID | 币别 | PRE001 | |
| FSettleTypeID | 结算方式 | {{textField_kwc795b4}} | |
| FPayOrgID | 付款组织 | {{textField_kwc795az}} | |
| FIsBorrow | 申请借款 | _function case '{{selectField_kvx7pmke}}' when '是' then 'true' when '否' then 'false' else 'false' end | |
| FTOCONTACTUNITTYPE | 往来单位类型 | BD_Supplier | |
| FTOCONTACTUNIT | 往来单位 | {{textField_kwc795aw}} | |
| FLocCurrencyID | 本位币 | PRE001 | |
| FExchangeRate | 汇率 | 1 | |
| FExchangeTypeID | 汇率类型 | HLTX01_SYS | |
| FBillTypeID | 单据类型 | FYSQ001_SYS | |
| F_PAEZ_Base1 | 部门经理/店长审核 | test钉钉测试 | |
| F_PAEZ_Assistant | 付款类别 | {{textField_kwn8dvvc}} | |
| F_PAEZ_Text | 收款方 | {{textField_kvx7pmkl}} | |
| F_PAEZ_Text1 | 开户行名称 | {{textField_kvx7pmiw}} | |
| F_PAEZ_Text11 | 收款银行账号 | {{textField_kw1faw4z}} | |
| F_YDID | 宜搭ID | {{id}} | |
| FYDNUM1 | 流水号 | {{textField_kwn9b11j}} | |
| FACCOUNTID | 银行账号 | {{selectField_kvx7pml8}} | |
| F_PAEZ_Remarks | 业务备注 | {{textareaField_kvx7pmjj}} | |
| FEntity | 明细 | tableField_kvxg1udz | |
| FEntity.FExpenseItemID | 费用项目 | {{tableField_kvxg1udz.textField_kwc795b2}} | |
| FEntity.FOrgAmount | 金额 | {{tableField_kvxg1udz.numberField_kvx63996}} | |
| FEntity.FRemark | 备注 | {{tableField_kvxg1udz.textareaField_kvx7pmjo}} | |
| FEntity.FTAXRATE | 税率% | {{tableField_kvxg1udz.numberField_kwd8kkl8}} | |
| FEntity.FTaxAmt | 税额 | {{tableField_kvxg1udz.numberField_kwd8kkl9}} | |
| FEntity.F_PAEZ_Date1 | 预算日期 | function FROM_UNIXTIME( ( {{tableField_kvxg1udz.dateField_kvx7pmka}} / 1000 ) ,'%Y-%m-%d' ) | |
| FEntity.FEntryCostDeptID | 费用承担部门 | {{tableField_kvxg1udz.textField_kwc795b3}} | |
| FEntity.F_PAEZ_Date | 付款日期 | _function FROM_UNIXTIME( ( {{dateField_kw0bado7}} / 1000 ) ,'%Y-%m-%d' ) | |
| FEntity.F_PAEZ_Base | 结算方式1 | {{textField_kwc795b4}} | |
| FEntity.FCostOrgID | 费用承担组织 | {{textField_kwc795az}} | |
| FEntity.FRefundDate | FRefundDate | _function FROM_UNIXTIME( ( {{dateField_kvx7pmi1}} / 1000 ) ,'%Y-%m-%d' ) | |
| FEntity.FormId | 业务对象表单Id | ER_ExpenseRequest | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | BatchSave | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统集成总览
采集并引入全业务、多终端、多形态的数据,经过处理以及对应平台接口的数据结构适配,形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施,将沉淀的业务数据进入到平台进行体系化的加工,再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。
