钉钉和金蝶云星空集成接口设计
1 comments
钉钉和金蝶云星空集成接口设计
对接源平台:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
对接系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：钉钉，并且选择对应的连接器（关于钉钉的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的获取审批实例详情接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的新增付款单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
钉钉接口明细
- API：topapi/processinstance/get
- NAME：获取审批实例详情
- METHOD：POST
请求参数
接口字段名称预设值 process_code审批流的唯一码PROC-C20F7186-8491-4D6D-B0BC-35AE79450B42 start_time审批实例开始时间。Unix时间戳，单位毫秒。1657123200000 end_time审批实例结束时间，Unix时间戳，单位毫秒1657209600000 size分页参数，每页大小，最多传20。20 cursor分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。响应参数
接口字段名称预设值 费用归属项目费用归属项目 报销类别报销类别 TextNote_7L0ZKXODKW40TextNote_7L0ZKXODKW40 行政报销类型行政报销类型 项目报销类型项目报销类型 报销明细报销明细 报销明细.费用发生日期费用发生日期 报销明细.报销金额(元)报销金额(元) 报销明细.费用明细费用明细 报销明细.项目费用明细项目费用明细 报销明细.项目费用明细.componentNamecomponentName 报销明细.项目费用明细.componentTypecomponentType 报销明细.项目费用明细.propsprops 报销明细.项目费用明细.总金额总金额 报销明细.项目费用明细.关联审批单关联审批单 报销明细.项目费用明细.TextNote-KDE5B2G3TextNote-KDE5B2G3 报销明细.项目费用明细.电子发票电子发票 报销明细.项目费用明细.收款账号收款账号 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）公司帐号付款（如需公司帐号付款请选择） 报销明细.项目费用明细.报销凭证拍照上传报销凭证拍照上传 报销明细.项目费用明细.附件附件 报销明细.项目费用明细.idid 报销明细.项目费用明细.titletitle 报销明细.项目费用明细.extendextend 报销明细.项目费用明细.extend.create_timecreate_time 报销明细.项目费用明细.extend.finish_timefinish_time 报销明细.项目费用明细.extend.originator_useridoriginator_userid 报销明细.项目费用明细.extend.originator_dept_idoriginator_dept_id 报销明细.项目费用明细.extend.statusstatus 报销明细.项目费用明细.extend.resultresult 报销明细.项目费用明细.extend.business_idbusiness_id 报销明细.项目费用明细.extend.originator_dept_nameoriginator_dept_name 报销明细.项目费用明细.extend.biz_actionbiz_action金蝶云星空接口明细
- 调用接口：batchSave
- 接口名称：新增付款单
- 方法：POST
请求参数
字段字段名称类型配置值 FBillNo单据编号string{{extend.business_id}} FBillTypeID单据类型stringFKDLX01_SYS FDATE业务日期string{{extend.finish_time}} FSETTLEORGID结算组织stringfindCollection find Number from 400f56e7-e846-35e5-9017-c28fd7303fb0 where Name={{费用归属部门}} FPAYORGID付款组织string_findCollection find Number from 400f56e7-e846-35e5-9017-c28fd7303fb0 where Name={{费用归属部门}} FCURRENCYID币别stringPRE001 FCONTACTUNITTYPE往来单位类型stringBD_Supplier FCONTACTUNIT往来单位stringfindCollection find FNumber from e3fb9252-4cce-32f4-bccf-2792bac19e8d where FName={{月结货款明细.供应商名称}} FRECTUNITTYPE收款单位类型stringBD_Supplier FRECTUNIT收款单位string_findCollection find FNumber from e3fb9252-4cce-32f4-bccf-2792bac19e8d where FName={{月结货款明细.供应商名称}} FSETTLECUR结算币别stringPRE001 FREMARK备注string{{title}}-{{项目报销类型}}-{{报销明细.费用明细}} FPAYBILLENTRY付款单明细array月结货款明细 FPAYBILLENTRY.FSETTLETYPEID结算方式stringfindCollection find Number from 04463531-c6b1-3e53-b5d7-9d456a92d4cf where Name={{付款方式new}} FPAYBILLENTRY.FPURPOSEID付款用途stringSFKYT08_SYS FPAYBILLENTRY.FPAYTOTALAMOUNTFOR应付金额string{{月结货款明细.金额（元）}} FPAYBILLENTRY.FCOSTID费用项目stringfindCollection find FNumber from b02f1e34-b500-3075-8b14-08fec61d08a4 where FName={{项目报销类型}} FPAYBILLENTRY.FCOMMENT备注string{{报销明细.费用明细}} FPAYBILLENTRY.FOPPOSITEBANKACCOUNT对方银行账号string_function CASE LOCATE('ALIPAY_ACCOUNT','{{收款信息.identityType}}') WHEN 0 THEN '{{收款信息.cardNo}}' ELSE '{{收款信息.logonId}}' END FPAYBILLENTRY.FOPPOSITECCOUNTNAME对方账户名称string{{收款信息.name}} FPAYBILLENTRY.FDepartment部门string_findCollection find Number from 400f56e7-e846-35e5-9017-c28fd7303fb0 where Name={{费用归属部门}} FPAYBILLENTRY.FormId业务对象表单IdstringAP_PAYBILL FPAYBILLENTRY.Operation执行的操作stringBatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit提交并审核boolfalse FPAYBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse响应参数
字段字段名称类型配置值 callBackStrategy回写方案object callBackStrategy.strategyId方案IDstring950d161e-e92d-3d49-9d70-342c1503f694 callBackStrategy.id审批实例IDstring{{id}} callBackStrategy.business_id审批编号string{{extend.business_id}} callBackStrategy.name收款信息string{{收款信息.name}}系统对接概况
大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。
