金蝶云星空与钉钉对接集成付款申请单查询打通发起审批实例(官方)

汪淼_轻易云

金蝶云星空与钉钉对接集成付款申请单查询打通发起审批实例(官方)

对接系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

接入系统：钉钉

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

数据接口配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将金蝶云星空、钉钉之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

金蝶云星空接口明细

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

请求参数

字段字段名称类型配置值 FID实体主键stringFID FBillNo单据编号stringFBillNo FDOCUMENTSTATUS单据状态stringFDOCUMENTSTATUS FCREATORID创建人stringFCREATORID FAPPROVERID审核人stringFAPPROVERID FCREATEDATE创建日期stringFCREATEDATE FSETTLEORGID结算组织stringFSETTLEORGID.fname FAPPROVEDATE审核日期stringFAPPROVEDATE FPURCHASEORGID采购组织stringFPURCHASEORGID FPAYAMOUNTFOR_H应付金额stringFPAYAMOUNTFOR_H FCURRENCYID币别stringFCURRENCYID FDATE申请日期stringFDATE FMODIFYDATE修改日期stringFMODIFYDATE FMODIFIERID修改人stringFMODIFIERID FBILLTYPEID单据类型stringFBILLTYPEID.fnumber FPURCHASERID采购员stringFPURCHASERID FPURCHASEDEPTID采购部门stringFPURCHASEDEPTID FAPPLYAMOUNTFOR_H申请付款金额stringFAPPLYAMOUNTFOR_H FACCOUNTSYSTEM会计核算体系stringFACCOUNTSYSTEM FCANCELLERID作废人stringFCANCELLERID FCANCELSTATUS作废状态stringFCANCELSTATUS FCANCELDATE作废日期stringFCANCELDATE FCONTACTUNITTYPE往来单位类型stringFCONTACTUNITTYPE FCONTACTUNIT往来单位stringFCONTACTUNIT.fname FRECTUNITTYPE收款单位类型stringFRECTUNITTYPE FRECTUNIT收款单位stringFRECTUNIT FBUSINESSTYPE业务类型stringFBUSINESSTYPE FDEPARTMENT部门stringFDEPARTMENT FPAYORGID付款组织stringFPAYORGID.fnumber FSALEORGID销售组织stringFSALEORGID FSALEDEPTID销售部门stringFSALEDEPTID FSALEERID销售员stringFSALEERID FMAINBOOKID本位币stringFMAINBOOKID FEXCHANGERATE汇率stringFEXCHANGERATE FEXCHANGETYPE汇率类型stringFEXCHANGETYPE FSOURCESYSTEM来源系统stringFSOURCESYSTEM FIsCredit是否信贷业务stringFIsCredit FBankActID银行账号stringFBankActID FAPPLYORGID申请组织stringFAPPLYORGID.fnumber FScanPoint扫描点stringFScanPoint FCLOSESTATUS关闭状态stringFCLOSESTATUS FCLOSERID关闭人stringFCLOSERID FCLOSEDATE关闭日期stringFCLOSEDATE FSETTLECUR结算币别stringFSETTLECUR.Fnumber FREALAPPLYAMOUNTFOR实际申请金额stringFREALAPPLYAMOUNTFOR FSETTLERATE结算汇率stringFSETTLERATE FAPPLYAMOUNT申请付款金额本位币stringFAPPLYAMOUNT FPURCHASERGROUPID采购组stringFPURCHASERGROUPID FSALEGROUPID销售组stringFSALEGROUPID FIsBorrow是否其他预付stringFIsBorrow FISCARRYRATE是否下推携带汇率到结算汇率stringFISCARRYRATE FMoreReceive多收款人stringFMoreReceive FPAYAPPLYENTRY_FEntryIDFPAYAPPLYENTRY_FEntryIDstringFPAYAPPLYENTRY_FEntryID FSETTLETYPEID结算方式stringFSETTLETYPEID FPAYAMOUNTFOR应付金额stringFPAYAMOUNTFOR FEACHBANKACCOUNT对方银行账号stringFEACHBANKACCOUNT FAPPLYAMOUNTFOR申请付款金额stringFAPPLYAMOUNTFOR FPAYPURPOSEID付款用途stringFPAYPURPOSEID FARPURPOSEID收款用途stringFARPURPOSEID FSOURCETYPE源单类型stringFSOURCETYPE FSRCBILLNO源单编号stringFSRCBILLNO FENDDATE到期日stringFENDDATE FEXPECTPAYDATE期望付款日期stringFEXPECTPAYDATE FEACHCCOUNTNAME对方账户名称stringFEACHCCOUNTNAME FEACHBANKNAME对方开户行stringFEACHBANKNAME FCOMMENT备注（作废）stringFCOMMENT FSRCROWID源单行内码stringFSRCROWID FRELATEPAYAMOUNT付退款关联金额stringFRELATEPAYAMOUNT FRELATEREFUNDAMOUNT作废—收款退款关联金额stringFRELATEREFUNDAMOUNT FCOSTID费用项目stringFCOSTID FApplyPclAmount申请还本金额stringFApplyPclAmount FApplyInstAmount申请付利息金额stringFApplyInstAmount FWritePclAmount关联付利息金额stringFWritePclAmount FDescription备注stringFDescription FMATERIALID物料编码stringFMATERIALID FMATERIALNAME物料名称stringFMATERIALNAME FPURCHASEORDERNO订单号stringFPURCHASEORDERNO FMATERIALSEQ订单行号stringFMATERIALSEQ FORDERENTRYID订单明细内码stringFORDERENTRYID FPRICE含税单价stringFPRICE FQTY数量stringFQTY FPRICEUNITID计价单位stringFPRICEUNITID FRELATEPAYQTY付(退)款关联数量stringFRELATEPAYQTY FUnpaidAmount未付款金额stringFUnpaidAmount FSwiftCodeSwiftCodestringFSwiftCode FTAXAMOUNT税额stringFTAXAMOUNT FBankDetail银行网点stringFBankDetail FEXPENSEDEPTID费用承担部门stringFEXPENSEDEPTID F_VAOJ_FQR发起人stringF_VAOJ_FQR.fname F_VAOJ_HKSX货款属性stringF_VAOJ_HKSX F_VAOJ_Remarks备注stringF_VAOJ_Remarks Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringCN_PAYAPPLY

响应参数

字段字段名称类型配置值 FID实体主键string FBillNo单据编号string FDOCUMENTSTATUS单据状态string FCREATORID创建人string FAPPROVERID审核人string FCREATEDATE创建日期string FSETTLEORGID结算组织string FAPPROVEDATE审核日期string FPURCHASEORGID采购组织string FPAYAMOUNTFOR_H应付金额string FCURRENCYID币别string FDATE申请日期string FMODIFYDATE修改日期string FMODIFIERID修改人string FBILLTYPEID单据类型string FPURCHASERID采购员string FPURCHASEDEPTID采购部门string FAPPLYAMOUNTFOR_H申请付款金额string FACCOUNTSYSTEM会计核算体系string FCANCELLERID作废人string FCANCELSTATUS作废状态string FCANCELDATE作废日期string FCONTACTUNITTYPE往来单位类型string FCONTACTUNIT往来单位string FRECTUNITTYPE收款单位类型string FRECTUNIT收款单位string FBUSINESSTYPE业务类型string FDEPARTMENT部门string FPAYORGID付款组织string FSALEORGID销售组织string FSALEDEPTID销售部门string FSALEERID销售员string FMAINBOOKID本位币string FEXCHANGERATE汇率string FEXCHANGETYPE汇率类型string FSOURCESYSTEM来源系统string FIsCredit是否信贷业务string FBankActID银行账号string FAPPLYORGID申请组织string FScanPoint扫描点string FCLOSESTATUS关闭状态string FCLOSERID关闭人string FCLOSEDATE关闭日期string FSETTLECUR结算币别string FREALAPPLYAMOUNTFOR实际申请金额string FSETTLERATE结算汇率string FAPPLYAMOUNT申请付款金额本位币string FPURCHASERGROUPID采购组string FSALEGROUPID销售组string FIsBorrow是否其他预付string FISCARRYRATE是否下推携带汇率到结算汇率string FMoreReceive多收款人string FPAYAPPLYENTRY_FEntryIDFPAYAPPLYENTRY_FEntryIDstring FSETTLETYPEID结算方式string FPAYAMOUNTFOR应付金额string FEACHBANKACCOUNT对方银行账号string FAPPLYAMOUNTFOR申请付款金额string FPAYPURPOSEID付款用途string FARPURPOSEID收款用途string FSOURCETYPE源单类型string FSRCBILLNO源单编号string FENDDATE到期日string FEXPECTPAYDATE期望付款日期string FEACHCCOUNTNAME对方账户名称string FEACHBANKNAME对方开户行string FCOMMENT备注（作废）string FSRCROWID源单行内码string FRELATEPAYAMOUNT付退款关联金额string FRELATEREFUNDAMOUNT作废—收款退款关联金额string FCOSTID费用项目string FApplyPclAmount申请还本金额string FApplyInstAmount申请付利息金额string FWritePclAmount关联付利息金额string FDescription备注string FMATERIALID物料编码string FMATERIALNAME物料名称string FPURCHASEORDERNO订单号string FMATERIALSEQ订单行号string FORDERENTRYID订单明细内码string FPRICE含税单价string FQTY数量string FPRICEUNITID计价单位string FRELATEPAYQTY付(退)款关联数量string FUnpaidAmount未付款金额string FSwiftCodeSwiftCodestring FTAXAMOUNT税额string FBankDetail银行网点string FEXPENSEDEPTID费用承担部门string F_VAOJ_FQR发起人string F_VAOJ_HKSX货款属性string F_VAOJ_Remarks备注stringF_VAOJ_Remarks

钉钉接口明细

API：topapi/processinstance/create
NAME：发起审批实例(官方)
METHOD：POST

请求参数

接口字段字段名称预设值描述 process_code审批流的唯一码PROC-22EDF4E6-5CC9-4712-B9A3-34AEAF37B8ACprocess_code在审批流程编辑页面的URL网址中获取。 originator_user_id发起人findCollection find user_id from 57556c0f-b9ed-38ce-a3d3-d3ad742b0e0d where name={{F_VAOJ_FQR}}审批实例发起人的userid。 dept_id发起人所在部门_findCollection find leader_in_dept.0.dept_id from 57556c0f-b9ed-38ce-a3d3-d3ad742b0e0d where name={{F_VAOJ_FQR}}发起人所在的部门，如果发起人属于根部门，传-1。 form_component_values审批流表单参数 form_component_values.单据编号 form_component_values.货款所属项目{{FSETTLEORGID}} form_component_values.供应商名称 form_component_values.付款时间{{FCREATEDATE date}} form_component_values.货款属性 form_component_values.备注备注为：{{F_VAOJ_Remarks}} form_component_values.付款金额（元） form_component_values.收款人（公司名称）{{FEACHCCOUNTNAME}} form_component_values.收款人帐号{{FEACHBANKACCOUNT}}

数据对接效果

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。