钉钉搭和金蝶云星空接口打通对接实战

数据源系统:阿里宜搭

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

对接目标系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：阿里宜搭，然后选择对应的连接器。选择对应的/yida_vpc/form/searchFormDatas.json作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

阿里宜搭接口明细

• 调用接口：/v1/process/getInstances.json

• 接口名称：搜索表单实例详情列表

• 方法：GET

请求参数

字段	字段名称	类型	配置值
appType	应用ID	string	APP_KFJOIBQ7VRMTDLQSLKQG
systemToken	应用秘钥	string	JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO
userId	管理员用户钉钉ID	string	16000443318138909
language	语言	string	zh_CN
formUuid	表单ID	string	FORM-XJ866N71KSXQZ14A13OWC45AMJIJ3YBK9PXPKI7
instanceStatus	实例状态	string	COMPLETED
currentPage	当前页	string	{{PAGINATION_START_PAGE}}
pageSize	每页记录数	string	{{PAGINATION_PAGE_SIZE}}
originatorId	数据提交人工号	string
createFrom	创建开始时间	string	2021-12-01 16:00:00
createTo	创建结束时间	string	2031-12-28 16:00:00
modifiedFrom	修改开始时间	string
modifiedTo	修改结束时间	string
searchFieldJson	条件	object
searchFieldJson.radioField_kmr4161k	类型	string	实报实销
searchFieldJson.selectField_kmvrn6yn	部门过滤	string	浪鲸项目部
searchFieldJson.textField_kmvrjgt5	申请人	string
searchFieldJson.approvedResult	审批结果	string	agree

响应参数

字段	字段名称	类型	配置值
gmtCreate	创建时间	string
gmtModified	最近修改时间	string
originatorUserId	创建人ID	string
originator	创建人	string
textareaField_kmr5pxq5	报销备注	string
textField_krric5sp	月周	string
dateField_knjy3x23	支付日期	string
textField_kr4souex	开户行编码	string
selectField_kq97ayh5	支付账号	string
selectField_kq97ayh4	银行名称	string
selectField_kq8ryql2	支付账户	string
textField_kqvme8kb	银行账号（支付宝账号）	string
textField_kquqcu4u	开户行信息（平台）	string
textField_kquqcu4t	账户名（姓名）	string
textField_kquqcu4s	姓名（或公司名称）	string
selectField_kqusm5fz	银行账号（支付宝账号）	string
selectField_kqusm5fy	开户行信息（平台）	string
selectField_kqusm5fx	账户名（姓名）	string
textField_kqusm5fo	姓名（或公司名称）	string
textField_kqkdpdhd	编码	string
selectField_kqhc3rpp	名称	string
selectField_kqhc3rpo	收付款类型	string
textField_krve6zzz	领取人ID	string
selectField_krve6zzy	现金领取人	string
textField_ksgrs1iz	支付方式编码	string
selectField_kqusm5fn	是否使用已有银行卡（账号）	string
selectField_kmr5pxpu	付款方式	string
numberField_kpte5p5m	退回余额的金额数目	string
selectField_kps4ziqh	是否退回余额	string
textField_kr0e3y5s	大写金额	string
numberField_kmr5pxpw	报销金额	string
selectField_knjrgyjy	费用类型	string
selectField_krln85xv	费用结算组织	string
associationFormField_kmr5pxq3	关联表单	string
numberField_kniuzfrc	总借支金额	string
numberField_kniuzfra	其他专项费用已借支金额	string
numberField_kniuzfr8	运营费用已借支金额	string
numberField_kniuzfr6	管理费用已借支金额	string
numberField_kneagd39	总借支金额	string
numberField_kn74cez2	其他专项费用已借支金额	string
numberField_kn74cez1	运营费用已借支金额	string
numberField_kn74cez0	管理费用已借支金额	string
textField_kqi4t37d	人员层级	string
selectField_koxm6nvm	借款类型	string
textField_ksgtesv1	部门ID（借款核销）	string
selectField_knfsj0nc	借支人部门	string
textField_kmvrjgt7	借支人姓名	string
radioField_kmr4161k	费用报销类型	string
textField_krx3gzsq	财务BP ID	string
textField_krk95hr8	部门中所有子部门ID（报表使用）	string
textField_krluijmr	会计主管ID	string
textField_kre9gcbl	项目决策层ID	string
textField_kre7ut6w	是否个税报销	string
textField_kr347dt3	负责会计	string
textField_kr1x1q52	部门ID（实报实销）	string
textField_krjzbmom	员工ID	string
selectField_kmvrn6yn	费用结算部门	string
textField_kmvrjgt5	申请人姓名	string
text_klkn4yn7
tableField_kne0yabj		array
tableField_kne0yabj.attachmentField_kne0yabk	-附件	string
tableField_kne0yabj.tableField_kq1n8j5t		array
tableField_kne0yabj.tableField_kq1n8j5t.textField_kqlroj9m	-金蝶费用科目编码	string
tableField_kne0yabj.tableField_kq1n8j5t.textField_kr4n1l6c	-费用组织编码	string
tableField_kne0yabj.tableField_kq1n8j5t.radioField_ks9mggs7	-是否充值到补单平台	string
tableField_kne0yabj.tableField_kq1n8j5t.numberField_kq1n8j60	-金额	string
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kniak1fg	-费用归属组织	string
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1i	-费用项目	string
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1j	-费用类别	string
tableField_kne0yabj.tableField_kq1n8j5t.textField_ks7fr3y1	-费用类型	string

金蝶云星空接口明细

• 接口：batchSave

• 接口名称：费用报销单新增

• 接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string
FOrgID	申请组织	string
FProposerID	申请人	string
FRequestDeptID	申请部门	string
FExpenseDeptEntryID	部门	string
FExpenseDeptID	费用承担部门	string
FCurrencyID	币别	string
FExchangeTypeID	汇率类型	string
FDate	日期	string
FCausa	事由	string
FExpenseOrgId	费用承担组织	string
FLocCurrencyID	本位币	string
FCONTACTUNITTYPE	往来单位类型	string
FCONTACTUNIT	往来单位	string
FPayOrgId	付款组织	string
FPaySettlleTypeID	结算方式	string
FBankAccountT	银行账号	string
FBankAccountNameT	银行账户名称	string
FBankBranchT	开户银行	string
FBillTypeID	单据类型	string
FEntity	明细	array
FEntity.FExpID	费用项目	string
FEntity.FExpenseAmount	金额	string
FEntity.FExpenseDeptID	承担部门	string
FEntity.FTaxSubmitAmt	费用金额	string
FEntity.FTaxAmt	税额	string
FEntity.F_PAEZ_CheckBox	是否充值到补单平台	string
FEntity.FRemark	备注	string
FEntity.FPayBox	申请付款	string
FEntity.FRealPay	实报实付	string
FEntity.F_PAEZ_SourceNo	鸿巢单据编号	string
FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如 UR_PurchaseOrder
FEntity.Operation	执行的操作	string
FEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统对接概况

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与阿里宜搭之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。