阿里宜搭和金蝶云星空接口打通对接实战
对接系统：阿里宜搭
宜搭是阿里巴巴自研的低代码应用搭建平台，传统情况下需要2周才能搭建完成的应用，用宜搭2小时就可完成。宜搭于2019年3月上线，用户可以在可视化界面上以拖拉拽的方式编辑和配置页面，表单和流程，并一键发布到PC和手机端。
写入目标:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
多系统对接方案配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：阿里宜搭接口：搜索表单实例详情列表通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：费用申请新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
阿里宜搭接口明细
- 接口：/yida_vpc/process/getInstances.json
- 接口名称：搜索表单实例详情列表
- 接口方法：POST
请求参数
字段名称类型描述
appType应用IDstring示例：APP_PBKT0MFBEBTDO8T7SLVP
systemToken应用秘钥string
userId管理员用户钉钉IDstring钉钉的userId
language语言string
formUuid表单IDstring
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创建人IDstring
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
金蝶云星空接口明细
- API：batchSave
- NAME：费用申请新增
- METHOD：POST
请求参数
接口字段字段名称预设值描述
FDate日期
function FROM_UNIXTIME( ( {{dateField_kvx7pmi1}} / 1000 ) ,'%Y-%m-%d' )
FStaffID申请人{{textField_kwc795b0}}
FDeptID申请部门{{textField_kwc795b1}}
FReason事由{{textareaField_kvx7pmjp}}
FOrgID申请组织{{textField_kwc795az}}
FCurrencyID币别PRE001
FSettleTypeID结算方式{{textField_kwc795b4}}
FPayOrgID付款组织{{textField_kwc795az}}
FIsBorrow申请借款_function case '{{selectField_kvx7pmke}}' when '是' then 'true' when '否' then 'false' else 'false' end
FTOCONTACTUNITTYPE往来单位类型BD_Empinfo
FTOCONTACTUNIT往来单位{{textField_kwbwf1sp}}
FLocCurrencyID本位币PRE001
FExchangeRate汇率1
FExchangeTypeID汇率类型HLTX01_SYS
FBillTypeID单据类型FYSQ001_SYS
F_PAEZ_Base1部门经理/店长审核test钉钉测试
F_PAEZ_Assistant付款类别{{textField_kwn8dvvc}}
F_PAEZ_Text收款方{{textField_kvx7pmkl}}
F_PAEZ_Text1开户行名称{{textField_kvx7pmiw}}
F_PAEZ_Text11收款银行账号{{textField_kw1faw4z}}
F_YDID宜搭ID{{id}}
FEntity明细tableField_kvxg1udz
FEntity.FExpenseItemID费用项目{{tableField_kvxg1udz.textField_kwc795b2}}
FEntity.FOrgAmount金额{{tableField_kvxg1udz.numberField_kvx63996}}
FEntity.FRemark备注{{tableField_kvxg1udz.textareaField_kvx7pmjo}}
FEntity.FTAXRATE税率%{{tableField_kvxg1udz.numberField_kwd8kkl8}}
FEntity.FTaxAmt税额{{tableField_kvxg1udz.numberField_kwd8kkl9}}
FEntity.F_PAEZ_Date1预算日期
function FROM_UNIXTIME( ( {{tableField_kvxg1udz.dateField_kvx7pmka}} / 1000 ) ,'%Y-%m-%d' )
FEntity.FEntryCostDeptID费用承担部门{{tableField_kvxg1udz.textField_kwc795b3}}
FEntity.F_PAEZ_Remarks业务备注{{textareaField_kvx7pmjj}}
FEntity.FACCOUNTID银行账号{{selectField_kvx7pml8}}
FEntity.FYDNUM1宜搭流水号{{textField_kwn9b11j}}
FEntity.F_PAEZ_Date付款日期_function FROM_UNIXTIME( ( {{dateField_kw0bado7}} / 1000 ) ,'%Y-%m-%d' )
FEntity.F_PAEZ_Base结算方式1{{textField_kwc795b4}}
FEntity.FormId业务对象表单IdER_ExpenseRequest必须填写金蝶的表单ID如😛UR_PurchaseOrder
FEntity.Operation执行的操作BatchSave
FEntity.IsAutoSubmitAndAudit提交并审核true
FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）
响应参数
接口字段字段名称预设值描述
FIDFID
F_YDID宜搭ID
系统对接总览
数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
