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

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

数据源系统:阿里宜搭

宜搭是阿里巴巴自研的低代码应用搭建平台，传统情况下需要2周才能搭建完成的应用，用宜搭2小时就可完成。宜搭于2019年3月上线，用户可以在可视化界面上以拖拉拽的方式编辑和配置页面，表单和流程，并一键发布到PC和手机端。

目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

系统对接接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取阿里宜搭的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。

阿里宜搭接口明细

• API：/yida_vpc/process/getInstances.json
• NAME：搜索表单实例详情列表
• METHOD：POST

请求参数

接口字段字段名称预设值描述 appType应用IDAPP_DYCTQDDB8CX2SDQ6YRJH示例：APP_PBKT0MFBEBTDO8T7SLVP systemToken应用秘钥QQ766LD1J92V5NCVVQ5WZ20GDSL2201TCBWVK3W1 userId管理员用户钉钉ID016654026426409112钉钉的userId language语言zh_CN formUuid表单IDFORM-FV966U91LS2V8ZZZ2JLRL4GS7BE432SHUDXVK41 instanceStatus实例状态COMPLETED currentPage当前页{{PAGINATION_START_PAGE}} pageSize每页记录数{{PAGINATION_PAGE_SIZE}} originatorId数据提交人工号用户钉钉ID createFrom创建开始时间 createTo创建结束时间 modifiedFrom修改开始时间{{DAYS_AGO_1 datetime}} modifiedTo修改结束时间2025-08-25 09:24:14 searchFieldJson条件 searchFieldJson.radioField_kvxrloar申请类型客户 searchFieldJson.selectField_kvx7pmke是否借款否

响应参数

接口字段字段名称预设值描述 gmtCreate创建时间 gmtModified最近修改时间 originatorUserId创建人ID originator创建人 attachmentField_kvx7pmjz附件 imageField_kvx7pmjy图片上传 dateField_kw0bado7付款日期 selectField_kvx7pml8支付银行账号 textField_kwc795b4结算方式编码 selectField_kvx7pml7结算方式 textareaField_kvx7pmjp事由 numberField_kvxgr707核销后还需付款金额 numberField_kvxgr706核销金额 numberField_kw2uuo99总申请金额 textareaField_kvx7pmjj业务描述 textField_kw1faw4z银行账号 textField_kvx7pmiw开户行名称 textField_kvx7pmkl收款人 textField_kwc795ay客户编码 selectField_kvxrloav客户 textField_kwc795aw供应商编码 selectField_kvxrloau供应商 textField_kwbwf1sp员工编码 selectField_kvxrloas员工 radioField_kvxrloar往来单位类型 dateField_kvx7pmkc预计核销日期 selectField_kvx7pmke申请借款 selectField_kvx7pmj8付款类别 textField_kw01ezvb付款类别-文本 textField_kwc795b1申请部门编码 dateField_kvx7pmi1申请日期 selectField_kvx7pmkd申请部门 textField_kvxjvp6n部门-文本 textField_kwc795b0申请人编码 selectField_kvx6398f申请人 textField_kvxjvp6m组织-文本 textField_kwc795az组织编码 selectField_kvx6398d申请组织 tableField_kvxg1udz明细 tableField_kvxg1udz.dateField_kvx7pmka明细-预算日期 tableField_kvxg1udz.textareaField_kvx7pmjo明细-财务备注 tableField_kvxg1udz.numberField_kwd8kkl9明细-税额 tableField_kvxg1udz.numberField_kwd8kkl8明细-税率 tableField_kvxg1udz.numberField_kvx63996明细-申请金额 tableField_kvxg1udz.textField_kwc795b3明细-费用承担部门编码 tableField_kvxg1udz.selectField_kvx7pmk9明细-费用承担部门 tableField_kvxg1udz.textField_kwc795b2明细-费用项目编码 tableField_kvxg1udz.selectField_kvx63994明细-费用项目

金蝶云星空接口明细

• 调用接口：batchSave
• 接口名称：费用报销单新增
• 方法：POST

请求参数

字段字段名称类型配置值 FProposerID申请人string{{textField_kwc795b0}} FRequestDeptID申请部门string{{textField_kwc795b1}} FExpenseDeptID承担部门string{{textField_kwc795b1}} FCurrencyID币别stringPRE001 FExchangeTypeID汇率类型stringHLTX01_SYS FOrgID申请组织string{{textField_kwc795az}} FDate日期stringfunction FROM_UNIXTIME( ( {{dateField_kvx7pmi1}} / 1000 ) ,'%Y-%m-%d' ) FExpenseOrgId费用承担组织string{{textField_kwc795az}} FLocCurrencyID本位币stringPRE001 FCONTACTUNITTYPE往来单位类型stringBD_Customer FCONTACTUNIT往来单位string{{textField_kwc795ay}} FBillTypeID单据类型stringFYBXD001_SYS F_YDID宜搭IDstring{{id}} FCausa事由string{{textareaField_kvx7pmjp}} FACCOUNTID银行账号string{{selectField_kvx7pml8}} FEntity明细arraytableField_kvxg1udz FEntity.FExpID费用项目string{{tableField_kvxg1udz.textField_kwc795b2}} FEntity.FExpenseAmount金额string{{tableField_kvxg1udz.numberField_kvx63996}} FEntity.FExpenseDeptEntryID费用承担部门string{{tableField_kvxg1udz.textField_kwc795b3}} FEntity.FTaxRate税率%string{{tableField_kvxg1udz.numberField_kwd8kkl8}} 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转换规则string1 FEntity.FEntity_Link.FEntity_Link_FSTableId源单表内码string FEntity.FEntity_Link.FEntity_Link_FSTableName源单表stringT_ER_ExpenseRequestEntry FEntity.FEntity_Link.FEntity_Link_FSBillId源单内码string_findCollection find FID from d86e94d8-cf1a-350e-b9bc-3595158d90b1 where F_YDID={{id}} FExpenseItemIDFNumber={{tableField_kvxg1udz.textField_kwc795b2}} FEntity.FEntity_Link.FEntity_Link_FSId源单分录内码stringfindCollection find FEntity_FEntryID from d86e94d8-cf1a-350e-b9bc-3595158d90b1 where F_YDID={{id}} FExpenseItemIDFNumber={{tableField_kvxg1udz.textField_kwc795b2}} FEntity.FEntity_Link.FEntity_Link_FSrcOffSetAmountOld原始携带量string FEntity.FEntity_Link.FEntity_Link_FSrcOffSetAmount修改携带量string{{tableField_kvxg1udz.numberField_kvx63996}} FEntity.FEntity_Link.FEntity_Link_FRELRQAMOUNTOld原始携带量string FEntity.FEntity_Link.FEntity_Link_FRELRQAMOUNT修改携带量string{{tableField_kvxg1udz.numberField_kvx63996}} FEntity.FEntity_Link.FRemark备注string{{tableField_kvxg1udz.textareaField_kvx7pmjo}} FEntity.FPaySettlleTypeID结算方式string{{textField_kwc795b4}} FEntity.F_PAEZ_Base部门/店长审批stringtest钉钉测试 FEntity.F_PAEZ_Date付款日期string_function FROM_UNIXTIME( ( {{dateField_kw0bado7}} / 1000 ) ,'%Y-%m-%d' ) FEntity.FYDNUM1宜搭流水号string{{textField_kwn9b11j}} FEntity.F_PAEZ_Assistant付款类别string_function case '{{selectField_kvx7pmj8}}' when '费用' then '006' when '借款-返现、补价差' then '004' when '' then '借款-经营投入' else '001' end FEntity.FPayOrgId付款组织string{{textField_kwc795az}} FEntity.FPayBox申请付款stringtrue FEntity.F_PAEZ_Remarks业务备注string{{textareaField_kvx7pmjj}} FEntity.FormId业务对象表单IdstringER_ExpReimbursement FEntity.Operation执行的操作stringBatchSave FEntity.IsAutoSubmitAndAudit提交并审核booltrue FEntity.IsVerifyBaseDataField验证基础资料boolfalse

数据对接价值

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。