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

数据源平台:阿里宜搭
宜搭为广大企业提供一套低成本的企业应用搭建解决方案。自2019年3月上云以来,宜搭已持续服务数百位合作伙伴,涉及新零售、医疗、银行、制造、酒店等多个行业领域。
对接目标平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:阿里宜搭的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试

阿里宜搭接口明细
- 接口:/yida_vpc/process/getInstances.json
- 接口名称:搜索表单实例详情列表
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| appType | 应用ID | string | 示例:APP_PBKT0MFBEBTDO8T7SLVP |
| systemToken | 应用秘钥 | string | |
| userId | 管理员用户钉钉ID | string | 钉钉的userId |
| language | 语言 | string | |
| formUuid | 表单ID | string | |
| instanceStatus | 实例状态 | string | |
| currentPage | 当前页 | string | |
| pageSize | 每页记录数 | string | |
| originatorId | 数据提交人工号 | string | 用户钉钉ID |
| createFrom | 创建开始时间 | string | |
| createTo | 创建结束时间 | string | |
| modifiedFrom | 修改开始时间 | string | |
| modifiedTo | 修改结束时间 | string | |
| 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 | |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:费用申请新增
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| FDate | 日期 | string | function FROM_UNIXTIME( ( {{dateField_kvx7pmi1}} / 1000 ) ,'%Y-%m-%d' ) |
| FStaffID | 申请人 | string | {{textField_kwc795b0}} |
| FDeptID | 申请部门 | string | {{textField_kwc795b1}} |
| FReason | 事由 | string | {{textareaField_kvx7pmjp}} |
| FOrgID | 申请组织 | string | {{textField_kwc795az}} |
| FCurrencyID | 币别 | string | PRE001 |
| FSettleTypeID | 结算方式 | string | {{textField_kwc795b4}} |
| FPayOrgID | 付款组织 | string | {{textField_kwc795az}} |
| FIsBorrow | 申请借款 | string | _function case '{{selectField_kvx7pmke}}' when '是' then 'true' when '否' then 'false' else 'false' end |
| FTOCONTACTUNITTYPE | 往来单位类型 | string | BD_Customer |
| FTOCONTACTUNIT | 往来单位 | string | {{textField_kwc795ay}} |
| FLocCurrencyID | 本位币 | string | PRE001 |
| FExchangeRate | 汇率 | string | 1 |
| FExchangeTypeID | 汇率类型 | string | HLTX01_SYS |
| FBillTypeID | 单据类型 | string | FYSQ001_SYS |
| F_PAEZ_Base1 | 部门经理/店长审核 | string | test钉钉测试 |
| F_PAEZ_Assistant | 付款类别 | string | {{textField_kwn8dvvc}} |
| F_PAEZ_Text | 收款方 | string | {{textField_kvx7pmkl}} |
| F_PAEZ_Text1 | 开户行名称 | string | {{textField_kvx7pmiw}} |
| F_PAEZ_Text11 | 收款银行账号 | string | {{textField_kw1faw4z}} |
| F_YDID | 宜搭ID | string | {{id}} |
| FACCOUNTID | 银行账号 | string | {{selectField_kvx7pml8}} |
| F_PAEZ_Remarks | 业务备注 | string | {{textareaField_kvx7pmjj}} |
| FEntity | 明细 | array | tableField_kvxg1udz |
| FEntity.FExpenseItemID | 费用项目 | string | {{tableField_kvxg1udz.textField_kwc795b2}} |
| FEntity.FOrgAmount | 金额 | string | {{tableField_kvxg1udz.numberField_kvx63996}} |
| FEntity.FRemark | 备注 | string | {{tableField_kvxg1udz.textareaField_kvx7pmjo}} |
| FEntity.FTAXRATE | 税率% | string | {{tableField_kvxg1udz.numberField_kwd8kkl8}} |
| FEntity.FTaxAmt | 税额 | string | {{tableField_kvxg1udz.numberField_kwd8kkl9}} |
| FEntity.F_PAEZ_Date1 | 预算日期 | string | function FROM_UNIXTIME( ( {{tableField_kvxg1udz.dateField_kvx7pmka}} / 1000 ) ,'%Y-%m-%d' ) |
| FEntity.FEntryCostDeptID | 费用承担部门 | string | {{tableField_kvxg1udz.textField_kwc795b3}} |
| FEntity.FYDNUM1 | 流水号 | string | {{textField_kwn9b11j}} |
| FEntity.F_PAEZ_Date | 付款日期 | string | _function FROM_UNIXTIME( ( {{dateField_kw0bado7}} / 1000 ) ,'%Y-%m-%d' ) |
| FEntity.F_PAEZ_Base | 结算方式1 | string | {{textField_kwc795b4}} |
| FEntity.FormId | 业务对象表单Id | string | ER_ExpenseRequest |
| FEntity.Operation | 执行的操作 | string | BatchSave |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接概况
通过无代码的数据集成与数据建模的智能数据管道技术,帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中,并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接阿里宜搭和金蝶云星空,使得单据无缝互通。打造企业内部数据一体化,让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通,同时支持供应链数据分析流程自动化,结果推送,推进相关供应链问题优化。及时打通供应链孤岛,实现数据驱动供应链协同,进一步提升企业竞争力。


