阿里宜搭和金蝶云星空接口打通对接实战
数据源系统:阿里宜搭
宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台,可让用户通过简单的拖拽、配置即可完成应用搭建,为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间,助力企业数字化升级。
对接目标平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据对接方案
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:阿里宜搭,然后选择对应的连接器。选择对应的/yida_vpc/form/searchFormDatas.json作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
阿里宜搭接口明细
- 接口:/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 | |
searchFieldJson.selectField_kvx7pmke | 是否借款 | 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
请求参数
字段 | 名称 | 类型 | 描述 |
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如:PUR_PurchaseOrder |
FEntity.Operation | 执行的操作 | string | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
数据对接价值
通过数据集成平台可视化的快速配置调用接口打通阿里宜搭与金蝶云星空之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
系统数据对接方案元数据代码