金蝶云星空和钉钉集成接口设计

金蝶云星空和钉钉集成接口设计

数据源系统:金蝶云星空

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

对接系统：钉钉

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

数据集成方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的付款单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择对应的添加审批评论接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：付款单查询
• 方法：POST

请求参数

字段字段名称类型配置值 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryIDstringFPAYBILLENTRY_FEntryID FID实体主键stringFID FBillNo单据编号stringFBillNo FDOCUMENTSTATUS单据状态stringFDOCUMENTSTATUS FCreatorId创建人stringFCreatorId FAPPROVERID审核人stringFAPPROVERID FCreateDate创建日期stringFCreateDate FSETTLEORGID结算组织stringFSETTLEORGID.FNumber FApproveDate审核日期stringFApproveDate FPURCHASEORGID采购组织stringFPURCHASEORGID.FNumber FPAYTOTALAMOUNTFOR_H表头-应付金额stringFPAYTOTALAMOUNTFOR_H FCURRENCYID币别stringFCURRENCYID.FNumber FDATE业务日期stringFDATE FModifyDate修改日期stringFModifyDate FModifierId修改人stringFModifierId FWRITTENOFFSTATUS核销状态stringFWRITTENOFFSTATUS FBillTypeID单据类型stringFBillTypeID.FNumber FPURCHASERID采购员stringFPURCHASERID.FNumber FPURCHASERGROUPID采购组stringFPURCHASERGROUPID FPURCHASEDEPTID采购部门stringFPURCHASEDEPTID.FNumber FREALPAYAMOUNTFOR_H表头-实付金额stringFREALPAYAMOUNTFOR_H FACCOUNTSYSTEM会计核算体系stringFACCOUNTSYSTEM FCancellerId作废人stringFCancellerId FCancelStatus作废状态stringFCancelStatus FCancelDate作废日期stringFCancelDate FCONTACTUNITTYPE往来单位类型stringFCONTACTUNITTYPE FCONTACTUNIT往来单位stringFCONTACTUNIT.FNumber FRECTUNITTYPE收款单位类型stringFRECTUNITTYPE FRECTUNIT收款单位stringFRECTUNIT.FNumber FSOURCESYSTEM来源系统stringFSOURCESYSTEM FBUSINESSTYPE业务类型stringFBUSINESSTYPE FISINIT是否期初单据stringFISINIT FDepartment部门stringFDepartment.FNumber FPAYORGID付款组织stringFPAYORGID.FNumber FISSAMEORG是否相同组织stringFISSAMEORG FIsCredit是否信贷业务stringFIsCredit FSETTLERATE结算汇率stringFSETTLERATE FPAYAMOUNTFOR付款金额stringFPAYAMOUNTFOR FEXCHANGETYPE汇率类型stringFEXCHANGETYPE FMAINBOOKID本位币stringFMAINBOOKID FSETTLECUR结算币别stringFSETTLECUR FPAYTOTALAMOUNT_H表头-应付金额本位币stringFPAYTOTALAMOUNT_H FPAYAMOUNT表头-付款金额本位币stringFPAYAMOUNT FREALPAYAMOUNT_H表头-实付金额本位币stringFREALPAYAMOUNT_H FEXCHANGERATE汇率stringFEXCHANGERATE FScanPoint扫描点stringFScanPoint FIsWriteOff是否转销stringFIsWriteOff FMatchMethodID核销方式stringFMatchMethodID FREALPAY实报实付stringFREALPAY FREMARK备注stringFREMARK FBookingDate期望付款日期stringFBookingDate FTHIRDBILLNO第三方单据编号stringFTHIRDBILLNO FWBSETTLENO流水号stringFWBSETTLENO FSETTLEMAINBOOKID结算本位币stringFSETTLEMAINBOOKID FSETTLEEXCHANGETYPE结算汇率类型stringFSETTLEEXCHANGETYPE FISCASHPURCHASE现购stringFISCASHPURCHASE FOUTCONTACTID转出往来单位stringFOUTCONTACTID.FNumber FOUTCONTACTTYPE转出往来单位类型stringFOUTCONTACTTYPE FIsBorrow是否其他预付stringFIsBorrow FISFROMTRADEBANK来源交易明细stringFISFROMTRADEBANK FGYACCOUNTWATERID管易财务流水内码stringFGYACCOUNTWATERID FISCARRYRATE是否下推携带汇率到结算汇率stringFISCARRYRATE FGYSHOPNAME管易对应店铺stringFGYSHOPNAME FGYCUSTOMERID管易对应客户stringFGYCUSTOMERID FMoreReceive多收款人stringFMoreReceive FPRESETASSISTANT1预设辅助资料字段1stringFPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2stringFPRESETASSISTANT2 FPRESETTEXT1预设文本字段1stringFPRESETTEXT1 FPRESETTEXT2预设文本字段2stringFPRESETTEXT2 FPRESETBASE1预设基础资料字段1stringFPRESETBASE1 FPRESETBASE2预设基础资料字段2stringFPRESETBASE2 FSRCBILLNO源单明细stringFSRCBILLNO Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDOCUMENTSTATUS='C' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringAP_PAYBILL

响应参数

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

钉钉接口明细

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

请求参数

字段名称类型 request.comment_userid评论人的useridstring request.text评论的内容string request.process_instance_id审批实例IDstring request请求对象object

数据对接效果

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