金蝶云星空对接打通钉钉付款单查询接口与添加审批评论接口来源系统:金蝶云星空金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。目标系统:钉钉钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。配置集成方案通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的付款单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择对应的添加审批评论接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。金蝶云星空接口明细调用接口： executeBillQuery 接口名称：付款单查询方法： POST 请求参数字段字段名称类型配置值 FPAYBILLENTRY_FEntryID FPAYBILLENTRY_FEntryID string FPAYBILLENTRY_FEntryID FID 实体主键 string FID FBillNo 单据编号 string FBillNo FDOCUMENTSTATUS 单据状态 string FDOCUMENTSTATUS FCreatorId 创建人 string FCreatorId FAPPROVERID 审核人 string FAPPROVERID FCreateDate 创建日期 string FCreateDate FSETTLEORGID 结算组织 string FSETTLEORGID.FNumber FApproveDate 审核日期 string FApproveDate FPURCHASEORGID 采购组织 string FPURCHASEORGID.FNumber FPAYTOTALAMOUNTFOR_H 表头-应付金额 string FPAYTOTALAMOUNTFOR_H FCURRENCYID 币别 string FCURRENCYID.FNumber FDATE 业务日期 string FDATE FModifyDate 修改日期 string FModifyDate FModifierId 修改人 string FModifierId FWRITTENOFFSTATUS 核销状态 string FWRITTENOFFSTATUS FBillTypeID 单据类型 string FBillTypeID.FNumber FPURCHASERID 采购员 string FPURCHASERID.FNumber FPURCHASERGROUPID 采购组 string FPURCHASERGROUPID FPURCHASEDEPTID 采购部门 string FPURCHASEDEPTID.FNumber FREALPAYAMOUNTFOR_H 表头-实付金额 string FREALPAYAMOUNTFOR_H FACCOUNTSYSTEM 会计核算体系 string FACCOUNTSYSTEM FCancellerId 作废人 string FCancellerId FCancelStatus 作废状态 string FCancelStatus FCancelDate 作废日期 string FCancelDate FCONTACTUNITTYPE 往来单位类型 string FCONTACTUNITTYPE FCONTACTUNIT 往来单位 string FCONTACTUNIT.FNumber FRECTUNITTYPE 收款单位类型 string FRECTUNITTYPE FRECTUNIT 收款单位 string FRECTUNIT.FNumber FSOURCESYSTEM 来源系统 string FSOURCESYSTEM FBUSINESSTYPE 业务类型 string FBUSINESSTYPE FISINIT 是否期初单据 string FISINIT FDepartment 部门 string FDepartment.FNumber FPAYORGID 付款组织 string FPAYORGID.FNumber FISSAMEORG 是否相同组织 string FISSAMEORG FIsCredit 是否信贷业务 string FIsCredit FSETTLERATE 结算汇率 string FSETTLERATE FPAYAMOUNTFOR 付款金额 string FPAYAMOUNTFOR FEXCHANGETYPE 汇率类型 string FEXCHANGETYPE FMAINBOOKID 本位币 string FMAINBOOKID FSETTLECUR 结算币别 string FSETTLECUR FPAYTOTALAMOUNT_H 表头-应付金额本位币 string FPAYTOTALAMOUNT_H FPAYAMOUNT 表头-付款金额本位币 string FPAYAMOUNT FREALPAYAMOUNT_H 表头-实付金额本位币 string FREALPAYAMOUNT_H FEXCHANGERATE 汇率 string FEXCHANGERATE FScanPoint 扫描点 string FScanPoint FIsWriteOff 是否转销 string FIsWriteOff FMatchMethodID 核销方式 string FMatchMethodID FREALPAY 实报实付 string FREALPAY FREMARK 备注 string FREMARK FBookingDate 期望付款日期 string FBookingDate FTHIRDBILLNO 第三方单据编号 string FTHIRDBILLNO FWBSETTLENO 流水号 string FWBSETTLENO FSETTLEMAINBOOKID 结算本位币 string FSETTLEMAINBOOKID FSETTLEEXCHANGETYPE 结算汇率类型 string FSETTLEEXCHANGETYPE FISCASHPURCHASE 现购 string FISCASHPURCHASE FOUTCONTACTID 转出往来单位 string FOUTCONTACTID.FNumber FOUTCONTACTTYPE 转出往来单位类型 string FOUTCONTACTTYPE FIsBorrow 是否其他预付 string FIsBorrow FISFROMTRADEBANK 来源交易明细 string FISFROMTRADEBANK FGYACCOUNTWATERID 管易财务流水内码 string FGYACCOUNTWATERID FISCARRYRATE 是否下推携带汇率到结算汇率 string FISCARRYRATE FGYSHOPNAME 管易对应店铺 string FGYSHOPNAME FGYCUSTOMERID 管易对应客户 string FGYCUSTOMERID FMoreReceive 多收款人 string FMoreReceive FPRESETASSISTANT1 预设辅助资料字段1 string FPRESETASSISTANT1 FPRESETASSISTANT2 预设辅助资料字段2 string FPRESETASSISTANT2 FPRESETTEXT1 预设文本字段1 string FPRESETTEXT1 FPRESETTEXT2 预设文本字段2 string FPRESETTEXT2 FPRESETBASE1 预设基础资料字段1 string FPRESETBASE1 FPRESETBASE2 预设基础资料字段2 string FPRESETBASE2 FSRCBILLNO 源单明细 string FSRCBILLNO Limit 最大行数 string {{PAGINATION_PAGE_SIZE}} StartRow 开始行索引 string {{PAGINATION_START_ROW}} TopRowCount 返回总行数 int FilterString 过滤条件 string FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDOCUMENTSTATUS='C' FieldKeys 需查询的字段key集合 array FormId 业务对象表单Id string AP_PAYBILL 响应参数字段字段名称类型配置值 FPAYBILLENTRY_FEntryID FPAYBILLENTRY_FEntryID string 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 预设辅助资料字段1 string FPRESETASSISTANT2 预设辅助资料字段2 string FPRESETTEXT1 预设文本字段1 string FPRESETTEXT2 预设文本字段2 string FPRESETBASE1 预设基础资料字段1 string FPRESETBASE2 预设基础资料字段2 string FSRCBILLNO 源单明细 string 钉钉接口明细 API： topapi/process/instance/comment/add NAME：添加审批评论 METHOD： POST 请求参数接口字段字段名称预设值描述 request 请求对象 request.process_instance_id 审批实例ID _findCollection find id from ed67b3fa-ebfd-3a8a-9ecb-2e1730f0a9e1 where business_id={{FBillNo}} 可通过调用获取审批实例ID列表接口获取。 request.text 评论的内容已审核 request.comment_userid 评论人的userid 1120181204-651141925 系统数据集成价值当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

金蝶云星空对接打通钉钉付款单查询接口与添加审批评论接口

关一帆qeasy

金蝶云星空对接打通钉钉付款单查询接口与添加审批评论接口

来源系统:金蝶云星空

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

目标系统:钉钉

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

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的付款单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择对应的添加审批评论接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

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

请求参数

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

响应参数

字段	字段名称	类型
FPAYBILLENTRY_FEntryID	FPAYBILLENTRY_FEntryID	string
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	预设辅助资料字段1	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT1	预设文本字段1	string
FPRESETTEXT2	预设文本字段2	string
FPRESETBASE1	预设基础资料字段1	string
FPRESETBASE2	预设基础资料字段2	string
FSRCBILLNO	源单明细	string

钉钉接口明细

API：topapi/process/instance/comment/add
NAME：添加审批评论
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
request	请求对象
request.process_instance_id	审批实例ID	_findCollection find id from ed67b3fa-ebfd-3a8a-9ecb-2e1730f0a9e1 where business_id={{FBillNo}}	可通过调用获取审批实例ID列表接口获取。
request.text	评论的内容	已审核
request.comment_userid	评论人的userid	1120181204-651141925

系统数据集成价值

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