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

对接系统：钉钉

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

接入系统：金蝶云星空

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

多系统对接方案配置

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：钉钉，源系统 API：获取审批实例详情，目标系统：金蝶云星空，目标系统 API新增付款单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

钉钉接口明细

调用接口：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

金蝶云星空接口明细

接口：batchSave
接口名称：新增付款单
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FBillTypeID	单据类型	string	单据类型
FDATE	业务日期	string	业务日期
FSETTLEORGID	结算组织	string	100
FPAYORGID	付款组织	string	100
FCURRENCYID	币别	string	币别
FCONTACTUNITTYPE	往来单位类型	string	往来单位类型
FCONTACTUNIT	往来单位	string	往来单位
FRECTUNITTYPE	收款单位类型	string	收款单位类型
FRECTUNIT	收款单位	string
FREMARK	备注	string	备注
FSETTLECUR	结算币别	string	结算币别
FPAYBILLENTRY	付款单明细	array
FPAYBILLENTRY.FSETTLETYPEID	结算方式	string
FPAYBILLENTRY.FPURPOSEID	付款用途	string
FPAYBILLENTRY.FPAYTOTALAMOUNTFOR	应付金额	string
FPAYBILLENTRY.FCOSTID	费用项目	string
FPAYBILLENTRY.FCOMMENT	备注	string
FPAYBILLENTRY.FOPPOSITEBANKACCOUNT	对方银行账号	string
FPAYBILLENTRY.FOPPOSITECCOUNTNAME	对方账户名称	string
FPAYBILLENTRY.FDepartment	部门	string
FPAYBILLENTRY.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如 UR_PurchaseOrder
FPAYBILLENTRY.Operation	执行的操作	string
FPAYBILLENTRY.IsAutoSubmitAndAudit	提交并审核	bool
FPAYBILLENTRY.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

响应参数

字段	名称	类型
callBackStrategy	回写方案	object
callBackStrategy.strategyId	方案ID	string
callBackStrategy.id	审批实例ID	string
callBackStrategy.business_id	审批编号	string
callBackStrategy.name	收款信息	string
callBackStrategy.originator_userid	发起人	string

系统集成总览

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用"轻易云集成方案"的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。