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

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

接入系统：金蝶云星空

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

对接目标系统:钉钉

钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。

数据接口配置方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：付款单查询，目标系统：钉钉，目标系统 API添加审批评论。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：付款单查询
• METHOD：POST

请求参数

接口字段名称预设值 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryID FID实体主键FID FBillNo单据编号FBillNo FDOCUMENTSTATUS单据状态FDOCUMENTSTATUS FCreatorId创建人FCreatorId FAPPROVERID审核人FAPPROVERID FCreateDate创建日期FCreateDate FSETTLEORGID结算组织FSETTLEORGID.FNumber FApproveDate审核日期FApproveDate FPURCHASEORGID采购组织FPURCHASEORGID.FNumber FPAYTOTALAMOUNTFOR_H表头-应付金额FPAYTOTALAMOUNTFOR_H FCURRENCYID币别FCURRENCYID.FNumber FDATE业务日期FDATE FModifyDate修改日期FModifyDate FModifierId修改人FModifierId FWRITTENOFFSTATUS核销状态FWRITTENOFFSTATUS FBillTypeID单据类型FBillTypeID.FNumber FPURCHASERID采购员FPURCHASERID.FNumber FPURCHASERGROUPID采购组FPURCHASERGROUPID FPURCHASEDEPTID采购部门FPURCHASEDEPTID.FNumber FREALPAYAMOUNTFOR_H表头-实付金额FREALPAYAMOUNTFOR_H FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM FCancellerId作废人FCancellerId FCancelStatus作废状态FCancelStatus FCancelDate作废日期FCancelDate FCONTACTUNITTYPE往来单位类型FCONTACTUNITTYPE FCONTACTUNIT往来单位FCONTACTUNIT.FNumber FRECTUNITTYPE收款单位类型FRECTUNITTYPE FRECTUNIT收款单位FRECTUNIT.FNumber FSOURCESYSTEM来源系统FSOURCESYSTEM FBUSINESSTYPE业务类型FBUSINESSTYPE FISINIT是否期初单据FISINIT FDepartment部门FDepartment.FNumber FPAYORGID付款组织FPAYORGID.FNumber FISSAMEORG是否相同组织FISSAMEORG FIsCredit是否信贷业务FIsCredit FSETTLERATE结算汇率FSETTLERATE FPAYAMOUNTFOR付款金额FPAYAMOUNTFOR FEXCHANGETYPE汇率类型FEXCHANGETYPE FMAINBOOKID本位币FMAINBOOKID FSETTLECUR结算币别FSETTLECUR FPAYTOTALAMOUNT_H表头-应付金额本位币FPAYTOTALAMOUNT_H FPAYAMOUNT表头-付款金额本位币FPAYAMOUNT FREALPAYAMOUNT_H表头-实付金额本位币FREALPAYAMOUNT_H FEXCHANGERATE汇率FEXCHANGERATE FScanPoint扫描点FScanPoint FIsWriteOff是否转销FIsWriteOff FMatchMethodID核销方式FMatchMethodID FREALPAY实报实付FREALPAY FREMARK备注FREMARK FBookingDate期望付款日期FBookingDate FTHIRDBILLNO第三方单据编号FTHIRDBILLNO FWBSETTLENO流水号FWBSETTLENO FSETTLEMAINBOOKID结算本位币FSETTLEMAINBOOKID FSETTLEEXCHANGETYPE结算汇率类型FSETTLEEXCHANGETYPE FISCASHPURCHASE现购FISCASHPURCHASE FOUTCONTACTID转出往来单位FOUTCONTACTID.FNumber FOUTCONTACTTYPE转出往来单位类型FOUTCONTACTTYPE FIsBorrow是否其他预付FIsBorrow FISFROMTRADEBANK来源交易明细FISFROMTRADEBANK FGYACCOUNTWATERID管易财务流水内码FGYACCOUNTWATERID FISCARRYRATE是否下推携带汇率到结算汇率FISCARRYRATE FGYSHOPNAME管易对应店铺FGYSHOPNAME FGYCUSTOMERID管易对应客户FGYCUSTOMERID FMoreReceive多收款人FMoreReceive FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FPRESETBASE1预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FSRCBILLNO源单明细FSRCBILLNO Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合 FormId业务对象表单IdAP_PAYBILL

响应参数

接口字段名称预设值 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryID FID实体主键 FBillNo单据编号 FDOCUMENTSTATUS单据状态 FCreatorId创建人 FAPPROVERID审核人 FCreateDate创建日期 FSETTLEORGID结算组织 FApproveDate审核日期 FPURCHASEORGID采购组织 FPAYTOTALAMOUNTFOR_H表头-应付金额 FCURRENCYID币别 FDATE业务日期 FModifyDate修改日期 FModifierId修改人 FWRITTENOFFSTATUS核销状态 FBillTypeID单据类型 FPURCHASERID采购员 FPURCHASERGROUPID采购组 FPURCHASEDEPTID采购部门 FREALPAYAMOUNTFOR_H表头-实付金额 FACCOUNTSYSTEM会计核算体系 FCancellerId作废人 FCancelStatus作废状态 FCancelDate作废日期 FCONTACTUNITTYPE往来单位类型 FCONTACTUNIT往来单位 FRECTUNITTYPE收款单位类型 FRECTUNIT收款单位 FSOURCESYSTEM来源系统 FBUSINESSTYPE业务类型 FISINIT是否期初单据 FDepartment部门 FPAYORGID付款组织 FISSAMEORG是否相同组织 FIsCredit是否信贷业务 FSETTLERATE结算汇率 FPAYAMOUNTFOR付款金额 FEXCHANGETYPE汇率类型 FMAINBOOKID本位币 FSETTLECUR结算币别 FPAYTOTALAMOUNT_H表头-应付金额本位币 FPAYAMOUNT表头-付款金额本位币 FREALPAYAMOUNT_H表头-实付金额本位币 FEXCHANGERATE汇率 FScanPoint扫描点 FIsWriteOff是否转销 FMatchMethodID核销方式 FREALPAY实报实付 FREMARK备注 FBookingDate期望付款日期 FTHIRDBILLNO第三方单据编号 FWBSETTLENO流水号 FSETTLEMAINBOOKID结算本位币 FSETTLEEXCHANGETYPE结算汇率类型 FISCASHPURCHASE现购 FOUTCONTACTID转出往来单位 FOUTCONTACTTYPE转出往来单位类型 FIsBorrow是否其他预付 FISFROMTRADEBANK来源交易明细 FGYACCOUNTWATERID管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率 FGYSHOPNAME管易对应店铺 FGYCUSTOMERID管易对应客户 FMoreReceive多收款人 FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2 FSRCBILLNO源单明细

钉钉接口明细

• 调用接口：topapi/process/instance/comment/add
• 接口名称：添加审批评论
• 方法：POST

请求参数

字段字段名称类型配置值 request请求对象object request.process_instance_id审批实例IDstring_findCollection find id from 2d06007e-3df8-33fa-9643-34b3d2382170 where 单据编号={{FSRCBILLNO}} request.text评论的内容string已同步 request.comment_userid评论人的useridstring133726334231994775

数据对接效果

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。