钉钉和金蝶云星空接口打通对接实战接通系统：钉钉钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。写入目标:金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。配置集成方案通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：钉钉接口：获取审批实例详情通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：新增付款单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况钉钉接口明细调用接口： topapi/processinstance/get 接口名称：获取审批实例详情方法： POST 请求参数字段字段名称类型配置值 process_code 审批流的唯一码 string PROC-12B1B605-2D28-43FE-80FB-13ECE6165313 start_time 审批实例开始时间。Unix时间戳，单位毫秒。 string _function ( {{LAST_SYNC_TIME}} - ( 3600 * 96) ) * 1000 end_time 审批实例结束时间，Unix时间戳，单位毫秒 string {{CURRENT_TIME}}000 size 分页参数，每页大小，最多传20。 string 20 cursor 分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。 string 响应参数字段字段名称类型配置值费用归属项目费用归属项目 string 报销类别报销类别 string TextNote_7L0ZKXODKW40 TextNote_7L0ZKXODKW40 string 行政报销类型行政报销类型 string 项目报销类型项目报销类型 string 报销明细报销明细 array 报销明细.费用发生日期费用发生日期 string 报销明细.报销金额(元) 报销金额(元) string 报销明细.费用明细费用明细 string 报销明细.项目费用明细项目费用明细 array 报销明细.项目费用明细.componentName componentName string 报销明细.项目费用明细.componentType componentType string 报销明细.项目费用明细.props props string 报销明细.项目费用明细.总金额总金额 string 报销明细.项目费用明细.关联审批单关联审批单 string 报销明细.项目费用明细.TextNote-KDE5B2G3 TextNote-KDE5B2G3 string 报销明细.项目费用明细.电子发票电子发票 string 报销明细.项目费用明细.收款账号收款账号 string 报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）公司帐号付款（如需公司帐号付款请选择） string 报销明细.项目费用明细.报销凭证拍照上传报销凭证拍照上传 string 报销明细.项目费用明细.附件附件 string 报销明细.项目费用明细.id id string 报销明细.项目费用明细.title title string 报销明细.项目费用明细.extend extend object 报销明细.项目费用明细.extend.create_time create_time string 报销明细.项目费用明细.extend.finish_time finish_time string 报销明细.项目费用明细.extend.originator_userid originator_userid string 报销明细.项目费用明细.extend.originator_dept_id originator_dept_id string 报销明细.项目费用明细.extend.status status string 报销明细.项目费用明细.extend.result result string 报销明细.项目费用明细.extend.business_id business_id string 报销明细.项目费用明细.extend.originator_dept_name originator_dept_name string 报销明细.项目费用明细.extend.biz_action biz_action string 金蝶云星空接口明细 API： batchSave NAME：新增付款单 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{extend.business_id}} 单据编号 FBillTypeID 单据类型 FKDLX01_SYS 单据类型 FDATE 业务日期 {{extend.finish_time}} 业务日期 FSETTLEORGID 结算组织 findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}} 100 FPAYORGID 付款组织 _findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}} 100 FCURRENCYID 币别 PRE001 币别 FCONTACTUNITTYPE 往来单位类型 BD_Supplier 往来单位类型 FCONTACTUNIT 往来单位 CS 往来单位 FRECTUNITTYPE 收款单位类型 BD_Supplier 收款单位类型 FRECTUNIT 收款单位 CS FSETTLECUR 结算币别 PRE001 结算币别 FREMARK 备注 {{title}}-{{月结货款明细.0.企业客户TextField-K2U5DHAA}}-{{备注}} 备注 FPAYBILLENTRY 付款单明细 FPAYBILLENTRY.FSETTLETYPEID 结算方式 findCollection find Number from 04463531-c6b1-3e53-b5d7-9d456a92d4cf where Name={{付款方式 new}} FPAYBILLENTRY.FPURPOSEID 付款用途 SFKYT08_SYS FPAYBILLENTRY.FPAYTOTALAMOUNTFOR 应付金额 {{月结货款明细.金额（元）}} FPAYBILLENTRY.FCOSTID 费用项目 findCollection find FNumber from b02f1e34-b500-3075-8b14-08fec61d08a4 where FName={{项目报销类型}} FPAYBILLENTRY.FCOMMENT 备注 {{报销明细.费用明细}} FPAYBILLENTRY.FOPPOSITEBANKACCOUNT 对方银行账号 _function CASE LOCATE('ALIPAY_ACCOUNT','{{收款信息.identityType}}') WHEN 0 THEN '{{收款信息.cardNo}}' ELSE '{{收款信息.logonId}}' END FPAYBILLENTRY.FOPPOSITECCOUNTNAME 对方账户名称 {{收款信息.name}} FPAYBILLENTRY.FDepartment 部门 _findCollection find FNumber from 400f56e7-e846-35e5-9017-c28fd7303fb0 where FName={{费用归属部门}} FPAYBILLENTRY.FormId 业务对象表单Id AP_PAYBILL 必须填写金蝶的表单ID如😛UR_PurchaseOrder FPAYBILLENTRY.Operation 执行的操作 BatchSave FPAYBILLENTRY.IsAutoSubmitAndAudit 提交并审核 false FPAYBILLENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录）响应参数接口字段字段名称预设值描述 callBackStrategy 回写方案 callBackStrategy.strategyId 方案ID 950d161e-e92d-3d49-9d70-342c1503f694 callBackStrategy.id 审批实例ID {{id}} callBackStrategy.business_id 审批编号 {{extend.business_id}} callBackStrategy.name 收款信息 {{收款信息.name}} 系统对接概况从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

汪淼_轻易云

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

接通系统：钉钉

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

写入目标:金蝶云星空

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

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：钉钉接口：获取审批实例详情通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：新增付款单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

钉钉接口明细

调用接口：topapi/processinstance/get
接口名称：获取审批实例详情
方法：POST

请求参数

字段	字段名称	类型	配置值
process_code	审批流的唯一码	string	PROC-12B1B605-2D28-43FE-80FB-13ECE6165313
start_time	审批实例开始时间。Unix时间戳，单位毫秒。	string	_function ( {{LAST_SYNC_TIME}} - ( 3600 * 96) ) * 1000
end_time	审批实例结束时间，Unix时间戳，单位毫秒	string	{{CURRENT_TIME}}000
size	分页参数，每页大小，最多传20。	string	20
cursor	分页查询的游标，最开始传0，后续传返回参数中的next_cursor值。	string

响应参数

字段	字段名称	类型
费用归属项目	费用归属项目	string
报销类别	报销类别	string
TextNote_7L0ZKXODKW40	TextNote_7L0ZKXODKW40	string
行政报销类型	行政报销类型	string
项目报销类型	项目报销类型	string
报销明细	报销明细	array
报销明细.费用发生日期	费用发生日期	string
报销明细.报销金额(元)	报销金额(元)	string
报销明细.费用明细	费用明细	string
报销明细.项目费用明细	项目费用明细	array
报销明细.项目费用明细.componentName	componentName	string
报销明细.项目费用明细.componentType	componentType	string
报销明细.项目费用明细.props	props	string
报销明细.项目费用明细.总金额	总金额	string
报销明细.项目费用明细.关联审批单	关联审批单	string
报销明细.项目费用明细.TextNote-KDE5B2G3	TextNote-KDE5B2G3	string
报销明细.项目费用明细.电子发票	电子发票	string
报销明细.项目费用明细.收款账号	收款账号	string
报销明细.项目费用明细.公司帐号付款（如需公司帐号付款请选择）	公司帐号付款（如需公司帐号付款请选择）	string
报销明细.项目费用明细.报销凭证拍照上传	报销凭证拍照上传	string
报销明细.项目费用明细.附件	附件	string
报销明细.项目费用明细.id	id	string
报销明细.项目费用明细.title	title	string
报销明细.项目费用明细.extend	extend	object
报销明细.项目费用明细.extend.create_time	create_time	string
报销明细.项目费用明细.extend.finish_time	finish_time	string
报销明细.项目费用明细.extend.originator_userid	originator_userid	string
报销明细.项目费用明细.extend.originator_dept_id	originator_dept_id	string
报销明细.项目费用明细.extend.status	status	string
报销明细.项目费用明细.extend.result	result	string
报销明细.项目费用明细.extend.business_id	business_id	string
报销明细.项目费用明细.extend.originator_dept_name	originator_dept_name	string
报销明细.项目费用明细.extend.biz_action	biz_action	string

金蝶云星空接口明细

API：batchSave
NAME：新增付款单
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{extend.business_id}}	单据编号
FBillTypeID	单据类型	FKDLX01_SYS	单据类型
FDATE	业务日期	{{extend.finish_time}}	业务日期
FSETTLEORGID	结算组织	findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}}	100
FPAYORGID	付款组织	_findCollection find Number from 723e2cb6-f80f-3823-8b4f-6e98b9713ba3 where Name={{费用归属项目}}	100
FCURRENCYID	币别	PRE001	币别
FCONTACTUNITTYPE	往来单位类型	BD_Supplier	往来单位类型
FCONTACTUNIT	往来单位	CS	往来单位
FRECTUNITTYPE	收款单位类型	BD_Supplier	收款单位类型
FRECTUNIT	收款单位	CS
FSETTLECUR	结算币别	PRE001	结算币别
FREMARK	备注	{{title}}-{{月结货款明细.0.企业客户TextField-K2U5DHAA}}-{{备注}}	备注
FPAYBILLENTRY	付款单明细
FPAYBILLENTRY.FSETTLETYPEID	结算方式	findCollection find Number from 04463531-c6b1-3e53-b5d7-9d456a92d4cf where Name={{付款方式new}}
FPAYBILLENTRY.FPURPOSEID	付款用途	SFKYT08_SYS
FPAYBILLENTRY.FPAYTOTALAMOUNTFOR	应付金额	{{月结货款明细.金额（元）}}
FPAYBILLENTRY.FCOSTID	费用项目	findCollection find FNumber from b02f1e34-b500-3075-8b14-08fec61d08a4 where FName={{项目报销类型}}
FPAYBILLENTRY.FCOMMENT	备注	{{报销明细.费用明细}}
FPAYBILLENTRY.FOPPOSITEBANKACCOUNT	对方银行账号	_function CASE LOCATE('ALIPAY_ACCOUNT','{{收款信息.identityType}}') WHEN 0 THEN '{{收款信息.cardNo}}' ELSE '{{收款信息.logonId}}' END
FPAYBILLENTRY.FOPPOSITECCOUNTNAME	对方账户名称	{{收款信息.name}}
FPAYBILLENTRY.FDepartment	部门	_findCollection find FNumber from 400f56e7-e846-35e5-9017-c28fd7303fb0 where FName={{费用归属部门}}
FPAYBILLENTRY.FormId	业务对象表单Id	AP_PAYBILL	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FPAYBILLENTRY.Operation	执行的操作	BatchSave
FPAYBILLENTRY.IsAutoSubmitAndAudit	提交并审核	false
FPAYBILLENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

响应参数

接口字段	字段名称	预设值
callBackStrategy	回写方案
callBackStrategy.strategyId	方案ID	950d161e-e92d-3d49-9d70-342c1503f694
callBackStrategy.id	审批实例ID	{{id}}
callBackStrategy.business_id	审批编号	{{extend.business_id}}
callBackStrategy.name	收款信息	{{收款信息.name}}

系统对接概况

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