阿里宜搭和金蝶云星空接口打通对接实战|轻易云数据集成平台

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

数据源系统:阿里宜搭

宜搭是阿里巴巴自研的基于钉钉和阿里云的低代码平台，可让用户通过简单的拖拽、配置即可完成应用搭建，为每个组织提供低门槛、高效率的数字化业务应用生产新模式。有效缩减企业应用开发时间，助力企业数字化升级。

对接目标平台:金蝶云星空

金蝶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（非必录）

数据对接价值

通过数据集成平台可视化的快速配置调用接口打通阿里宜搭与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。