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

对接系统:阿里宜搭
宜搭是阿里巴巴自研的低代码应用搭建平台,传统情况下需要2周才能搭建完成的应用,用宜搭2小时就可完成。宜搭于2019年3月上线,用户可以在可视化界面上以拖拉拽的方式编辑和配置页面,表单和流程,并一键发布到PC和手机端。
接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置方案
数据集成平台对应的配置阿里宜搭与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据阿里宜搭的接口参数要求记录在轻易云集成平台。第二步配置阿里宜搭与金蝶云星空之间的字段对应关系(更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息)第三步完成方案的检查参数设置:传递时间、重试次数、是否启动、前置条件等上线运行。



阿里宜搭接口明细
- 接口:/yida_vpc/process/getInstances.json
- 接口名称:搜索表单实例详情列表
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
appType | 应用ID | string | 示例:APP_PBKT0MFBEBTDO8T7SLVP |
systemToken | 应用秘钥 | string | |
userId | 管理员用户钉钉ID | string | 钉钉的userId |
language | 语言 | string | |
instanceStatus | 实例状态 | string | |
formUuid | 表单ID | string | |
currentPage | 当前页 | string | |
pageSize | 每页记录数 | string | |
originatorId | 数据提交人工号 | string | 用户钉钉ID |
createFrom | 创建开始时间 | string | |
createTo | 创建结束时间 | string | |
modifiedFrom | 修改开始时间 | string | |
modifiedTo | 修改结束时间 | string | |
searchFieldJson | 条件 | object | |
searchFieldJson.selectField_kmrhvbvj | 类型 | string | |
searchFieldJson.selectField_kr7m8wu7 | 部门 | string | |
响应参数
字段 | 名称 | 类型 | 描述 |
gmtCreate | 创建时间 | string | |
gmtModified | 最近修改时间 | string | |
originatorUserId | 创建人ID | string | |
originator | 创建人 | string | |
attachmentField_kne12uu3 | 附件 | string | |
textareaField_kmrhvbvq | 支付备注 | string | |
textField_kqkdnv3s | 编码 | string | |
selectField_kqhc3rpp | 收付款类型 | string | |
selectField_kqhc3rpo | 收付款类别 | string | |
dateField_kmrhvbvo | 支付日期 | string | |
textField_knjzn0o5 | 收入账户账号 | string | |
textField_knjzn0o3 | 收入账户名 | string | |
textField_knjzn0nz | 支付账户账号 | string | |
textField_knjzn0nx | 支付账户名 | string | |
textField_knjylo5i | 支付宝账号 | string | |
textField_knjylo5g | 收入账户名 | string | |
textField_kmzza7qn | 支付宝账号 | string | |
textField_knihu0wu | 支付账户名 | string | |
textField_kr4og5sm | 开户银行编码 | string | |
textField_knjylo4g | 银行卡号 | string | |
textField_knjylo4e | 开户行信息 | string | |
textField_knjylo4c | 收入账户户名 | string | |
textField_kr4og5sl | 开户银行编码 | string | |
textField_kmzza7qm | 银行卡号 | string | |
textField_knihu0wp | 开户行信息 | string | |
textField_knihu0wo | 支付账户户名 | string | |
selectField_kmrhvbvn | 支付方式 | string | |
textField_kr0e6qlb | 大写金额 | string | |
numberField_kmrhvbvm | 金额 | string | |
textField_kr7m8wu4 | 转出部门事业群负责人ID | string | |
textField_kr7m8wu3 | 转出部门事业群负责人ID | string | |
textField_kr7m8wu2 | 转入部门会计ID | string | |
textField_kr7m8wu1 | 转出部门会计ID | string | |
textField_kr7m8wu0 | 业务部门事业群负责人ID | string | |
textField_kr7m8wtz | 业务部门会计ID | string | |
textField_kr4og5so | 费用组织编码 | string | |
selectField_kno0ltaq | 费用转入组织 | string | |
selectField_kr7m8wub | 费用转入部门 | string | |
textField_kr4og5sn | 费用组织编码 | string | |
selectField_kno0ltar | 费用转出组织 | string | |
selectField_kr7m8wu9 | 费用转出部门 | string | |
textField_kr4o9odb | 费用组织编码 | string | |
selectField_knib2epo | 费用归属组织 | string | |
selectField_kr7m8wu7 | 业务所属部门 | string | |
selectField_kmrhvbvj | 转账类型 | string | |
selectField_kmvrsfhh | 申请人部门 | string | |
textField_kmvrsfhi | 申请人 | string | |
text_klkn4yn7 | | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:银行转账单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{textField_kspddqpw}}(YHZZ) | |
FCOMMENT | 备注 | {{textareaField_kmrhvbvq}} | |
FDATE | 日期 | function FROM_UNIXTIME( ( {{dateField_kmrhvbvo}} / 1000 ) ,'%Y-%m-%d' ) | |
FBillTypeID | 单据类型 | YHZZ01_SYS | |
FPAYORGID | 支付组织 | {{textField_kr4o9odb}} | |
FMAINBOOKID | 帐薄 | PRE001 | |
FEXCHANGETYPE | 汇率类型 | HLTX01_SYS | |
FEntity | 分录 | | |
FEntity.FTOBANKACNTID | 转入账户 | {{selectField_ksps9piz}} | |
FEntity.FFROMBANKACNTID | 转出账号 | {{selectField_ksps9piw}} | |
FEntity.FINCURRENCYID | 币别 | PRE001 | |
FEntity.FAmount | 金额 | {{numberField_kmrhvbvm}} | |
FEntity.FTOTALAMOUNT | 转出金额 | {{numberField_kmrhvbvm}} | |
FEntity.FOUTCURRENCYID | 转出币别 | PRE001 | |
FEntity.FEXPLANATION | 摘要 | {{textareaField_kmrhvbvq}} | |
FEntity.FINEXCHANGERATE | 转入汇率 | 1 | |
FEntity.FOUTEXCHANGERATE | 转出汇率 | | |
FEntity.FPOSTDATE | 业务日期 | {{gmtModified}} | |
FEntity.FRuZhangType | 入账类型 | _function FROM_UNIXTIME( ( {{dateField_kmrhvbvo}} / 1000 ) ,'%Y-%m-%d' ) | |
FEntity.FDeptID | 转出部门 | {{textField_kx1g8gd8}} | |
FEntity.FormId | 业务对象表单Id | CN_BANKTRANSBILL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FEntity.Operation | 执行的操作 | BatchSave | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | false | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统对接概况
可视化配置,即便是普通业务人员也可以快速轻松对接多个平台,解决企业面临的数据孤岛,数据混乱等问题,实现数据可见、可用、可运营。进行统一化,模块化,标准化的服务能力和输出,实现对业务端数据需求的精准满足和高效响应,也可以在业务数据需求的不断增加下,让企业有整套的可复用的api资产以更换,支持业务的正常运转,节省开发成本。在不同的着重点和应用上解决数据共享,实现平台之间的独立管理。
