接口配置打通钉钉和金蝶云星空数据对接

接口配置打通钉钉和金蝶云星空数据对接

接入系统：金蝶云星空

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

集成系统:钉钉

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

数据接口配置方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：钉钉，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

• 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源单明细

钉钉接口明细

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

请求参数

接口字段名称预设值 request请求对象 request.process_instance_id审批实例ID_findCollection find id from 53770c7f-a5f4-3e9a-9a3d-77aad4a8acff where 单据编号={{FSRCBILLNO}} request.text评论的内容已作废 request.comment_userid评论人的userid133726334231994775

系统对接总览

从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。