钉钉与金蝶云星空对接集成获取流程实例（宜搭）连通收款退款新增(refund-新收款单（收款退款单）3.2) 数据源系统:钉钉钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。集成系统:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。数据接口配置使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的获取流程实例（宜搭）作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的收款退款新增接口作为数据写入动作，既可以完成第一步的数据对接配置。钉钉接口明细 API： v1.0/yida/processes/instances NAME：获取流程实例（宜搭） METHOD： POST 请求参数接口字段字段名称预设值描述 pageNumber 分页页码 {{PAGINATION_START_PAGE}} 分页页码 pageSize 分页大小 {{PAGINATION_PAGE_SIZE}} 分页大小 appType 应用ID APP_KFJOIBQ7VRMTDLQSLKQG 应用ID systemToken 应用秘钥 JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO 应用秘钥 userId 用户的userid 16000443318138909 用户的userid language 语言语言，取值：zh_CN：中文（默认值）en_US：英文 formUuid 表单ID FORM-TH866OD15SXQ06T31UZP06CVXI3J31C6B3TPKV 表单ID searchFieldJson 条件 searchFieldJson.selectField_kne9dbah 类型收款退款 searchFieldJson.selectField_kzihphju 部门过滤 searchFieldJson.originatorId 根据流程发起人工号查询根据流程发起人工号查询 searchFieldJson.createFromTimeGMT 创建时间起始值 _function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00') 创建时间起始值 searchFieldJson.createToTimeGMT 创建时间终止值 {{CURRENT_TIME datetime}} 创建时间终止值 searchFieldJson.modifiedFromTimeGMT 修改时间起始值修改时间起始值 searchFieldJson.modifiedToTimeGMT 修改时间终止值修改时间终止值 searchFieldJson.taskId 任务ID 任务ID searchFieldJson.instanceStatus 实例状态 COMPLETED 实例状态 searchFieldJson.approvedResult 流程审批结果 agree 流程审批结果响应参数接口字段字段名称预设值描述 gmtCreate 创建时间 gmtModified 最近修改时间 originatorUserId 创建人ID originator 创建人 attachmentField_kne13swd 附件 textField_krrik8kb 月周 dateField_kzdt0hej （出纳）实际支付时间 dateField_kmrhm14u 支付日期 textField_kqkdldg0 收付款类型编码 selectField_kqhc3rpp 名称 selectField_kqhc3rpo 收付款类型 textField_kr4t0q6j 开户行编码 selectField_kq97ayh5 收付款账号 selectField_kq97ayh4 银行名称 selectField_kq8ryql2 收付款账户 textField_krltbok3 收款方账号 textField_kse8m7d6 收款方开户行（平台） textField_krltbok1 收款方户名 textField_kmzzc949 汇款账号 textField_kse8m7d5 汇款开户行（平台） textField_kniia1wi 汇款账户户名 textField_kse9l95k 退款方式编码 selectField_krltbojq 退款方式 textField_kse9l95j 汇款方式编码 selectField_kmrhm14t 汇款方式 textareaField_kmrhm14v 支付备注 textField_kr0e8dd7 大写金额 numberField_kmrhm14s 金额 textField_kwjzqi0e 费用承担部门编码 selectField_kwjzqi0d 费用承担部门 textField_krvrp44e 费用收款组织编码 selectField_krvrp44d 费用收款组织 textField_kr4od4a5 费用结算组织编码 selectField_knib34jo 费用结算组织 textField_ksdy7bcw 往来单位类型编码 textField_ksdy7bcv 付款单位类型编码 textField_krvw0tz5 往来单位编码 selectField_krvw0tz4 往来单位 selectField_krvw0tz3 往来单位类型 textField_kr4ijmtn 付款单位编码 selectField_kqgcfms2 付款单位 selectField_kr38pggy 付款单位类型 selectField_kne9dbah 费用类别 textField_ktuyr3cu 项目决策层ID textField_ktuyr3ct 会计ID textField_krk9d78n 部门中所有子部门ID（报表使用） textField_kspcvc0q 流水号 selectField_kzihphju 预算部门 selectField_kmrhm14p 申请部门 textField_kmvrv5xl 申请人 text_klkn4yn7 金蝶云星空接口明细 API： batchSave NAME：收款退款新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{textField_kspcvc0q}}（SKTK） FBillTypeID 单据类型 function case '{{textField_kqkdldg0}}' when 'R007' then 'SKTKDLX02_SYS' else 'SKTKDLX01_SYS' end FDATE 日期 _function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' ) FPAYORGID 收款组织 function case '{{selectField_l3nujj4l}}' when '是' then '{{textField_krvrp44e}}' else '{{textField_kr4od4a5}}' end FSETTLEORGID 结算组织 {{textField_kr4od4a5}} FRECTUNITTYPE 收款单位类型 {{textField_ksdy7bcv}} FRECTUNIT 收款单位 {{textField_kr4ijmtn}} FCONTACTUNITTYPE 往来单位类型 {{textField_ksdy7bcv}} FCONTACTUNIT 往来单位 {{textField_kr4ijmtn}} FCURRENCYID 币别 PRE001 FSALEORGID 销售组织 {{textField_kr4od4a5}} FBUSINESSTYPE 业务类型 _function case '{{textField_kqkdldg0}}' when 'R007' then '3' else '1' end FEXCHANGERATE 汇率 1.0 FREFUNDBILLENTRY 明细 FREFUNDBILLENTRY.FSETTLETYPEID 结算方式 {{textField_kse9l95k}} FREFUNDBILLENTRY.FPURPOSEID 原收款用途 {{textField_kqkdldg0}} FREFUNDBILLENTRY.FCOSTDEPARTMENTID 费用承担部门 {{textField_kwjzqi0e}} FREFUNDBILLENTRY.FREFUNDAMOUNTFOR 退款金额 {{numberField_kmrhm14s}} FREFUNDBILLENTRY.FACCOUNTID 我方银行账号 {{selectField_kq97ayh5}} FREFUNDBILLENTRY.FNOTE 摘要 {{textareaField_kmrhm14v}} FREFUNDBILLENTRY.FPOSTDATE 登账日期 _function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' ) FREFUNDBILLENTRY.FCOMMENT 备注 {{textareaField_kmrhm14v}} FREFUNDBILLENTRY.FREMARK 备注 {{textareaField_kmrhm14v}} FREFUNDBILLENTRY.F_QKZI_Assistant 往来类型 {{selectField_l2smcpih_id}} FREFUNDBILLENTRY.FormId 业务对象表单Id AR_REFUNDBILL 必须填写金蝶的表单ID如😛UR_PurchaseOrder FREFUNDBILLENTRY.Operation 执行的操作 BatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit 提交并审核 true FREFUNDBILLENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录）数据对接效果基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接钉钉接口抽取数据后再自动分发到金蝶云星空，解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。

钉钉与金蝶云星空对接集成获取流程实例（宜搭）连通收款退款新增(refund-新收款单（收款退款单）3.2)

庄颜_qeasy

钉钉与金蝶云星空对接集成获取流程实例（宜搭）连通收款退款新增(refund-新收款单（收款退款单）3.2)

数据源系统:钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

集成系统:金蝶云星空

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

数据接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的获取流程实例（宜搭）作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的收款退款新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

钉钉接口明细

API：v1.0/yida/processes/instances
NAME：获取流程实例（宜搭）
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
pageNumber	分页页码	{{PAGINATION_START_PAGE}}	分页页码
pageSize	分页大小	{{PAGINATION_PAGE_SIZE}}	分页大小
appType	应用ID	APP_KFJOIBQ7VRMTDLQSLKQG	应用ID
systemToken	应用秘钥	JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO	应用秘钥
userId	用户的userid	16000443318138909	用户的userid
language	语言		语言，取值：zh_CN：中文（默认值）en_US：英文
formUuid	表单ID	FORM-TH866OD15SXQ06T31UZP06CVXI3J31C6B3TPKV	表单ID
searchFieldJson	条件
searchFieldJson.selectField_kne9dbah	类型	收款退款
searchFieldJson.selectField_kzihphju	部门过滤
searchFieldJson.originatorId	根据流程发起人工号查询		根据流程发起人工号查询
searchFieldJson.createFromTimeGMT	创建时间起始值	_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00')	创建时间起始值
searchFieldJson.createToTimeGMT	创建时间终止值	{{CURRENT_TIME datetime}}	创建时间终止值
searchFieldJson.modifiedFromTimeGMT	修改时间起始值		修改时间起始值
searchFieldJson.modifiedToTimeGMT	修改时间终止值		修改时间终止值
searchFieldJson.taskId	任务ID		任务ID
searchFieldJson.instanceStatus	实例状态	COMPLETED	实例状态
searchFieldJson.approvedResult	流程审批结果	agree	流程审批结果

响应参数

接口字段	字段名称	预设值	描述
gmtCreate	创建时间
gmtModified	最近修改时间
originatorUserId	创建人ID
originator	创建人
attachmentField_kne13swd	附件
textField_krrik8kb	月周
dateField_kzdt0hej	（出纳）实际支付时间
dateField_kmrhm14u	支付日期
textField_kqkdldg0	收付款类型编码
selectField_kqhc3rpp	名称
selectField_kqhc3rpo	收付款类型
textField_kr4t0q6j	开户行编码
selectField_kq97ayh5	收付款账号
selectField_kq97ayh4	银行名称
selectField_kq8ryql2	收付款账户
textField_krltbok3	收款方账号
textField_kse8m7d6	收款方开户行（平台）
textField_krltbok1	收款方户名
textField_kmzzc949	汇款账号
textField_kse8m7d5	汇款开户行（平台）
textField_kniia1wi	汇款账户户名
textField_kse9l95k	退款方式编码
selectField_krltbojq	退款方式
textField_kse9l95j	汇款方式编码
selectField_kmrhm14t	汇款方式
textareaField_kmrhm14v	支付备注
textField_kr0e8dd7	大写金额
numberField_kmrhm14s	金额
textField_kwjzqi0e	费用承担部门编码
selectField_kwjzqi0d	费用承担部门
textField_krvrp44e	费用收款组织编码
selectField_krvrp44d	费用收款组织
textField_kr4od4a5	费用结算组织编码
selectField_knib34jo	费用结算组织
textField_ksdy7bcw	往来单位类型编码
textField_ksdy7bcv	付款单位类型编码
textField_krvw0tz5	往来单位编码
selectField_krvw0tz4	往来单位
selectField_krvw0tz3	往来单位类型
textField_kr4ijmtn	付款单位编码
selectField_kqgcfms2	付款单位
selectField_kr38pggy	付款单位类型
selectField_kne9dbah	费用类别
textField_ktuyr3cu	项目决策层ID
textField_ktuyr3ct	会计ID
textField_krk9d78n	部门中所有子部门ID（报表使用）
textField_kspcvc0q	流水号
selectField_kzihphju	预算部门
selectField_kmrhm14p	申请部门
textField_kmvrv5xl	申请人
text_klkn4yn7

金蝶云星空接口明细

API：batchSave
NAME：收款退款新增
METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{textField_kspcvc0q}}（SKTK）
FBillTypeID	单据类型	function case '{{textField_kqkdldg0}}' when 'R007' then 'SKTKDLX02_SYS' else 'SKTKDLX01_SYS' end
FDATE	日期	_function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' )
FPAYORGID	收款组织	function case '{{selectField_l3nujj4l}}' when '是' then '{{textField_krvrp44e}}' else '{{textField_kr4od4a5}}' end
FSETTLEORGID	结算组织	{{textField_kr4od4a5}}
FRECTUNITTYPE	收款单位类型	{{textField_ksdy7bcv}}
FRECTUNIT	收款单位	{{textField_kr4ijmtn}}
FCONTACTUNITTYPE	往来单位类型	{{textField_ksdy7bcv}}
FCONTACTUNIT	往来单位	{{textField_kr4ijmtn}}
FCURRENCYID	币别	PRE001
FSALEORGID	销售组织	{{textField_kr4od4a5}}
FBUSINESSTYPE	业务类型	_function case '{{textField_kqkdldg0}}' when 'R007' then '3' else '1' end
FEXCHANGERATE	汇率	1.0
FREFUNDBILLENTRY	明细
FREFUNDBILLENTRY.FSETTLETYPEID	结算方式	{{textField_kse9l95k}}
FREFUNDBILLENTRY.FPURPOSEID	原收款用途	{{textField_kqkdldg0}}
FREFUNDBILLENTRY.FCOSTDEPARTMENTID	费用承担部门	{{textField_kwjzqi0e}}
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR	退款金额	{{numberField_kmrhm14s}}
FREFUNDBILLENTRY.FACCOUNTID	我方银行账号	{{selectField_kq97ayh5}}
FREFUNDBILLENTRY.FNOTE	摘要	{{textareaField_kmrhm14v}}
FREFUNDBILLENTRY.FPOSTDATE	登账日期	_function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' )
FREFUNDBILLENTRY.FCOMMENT	备注	{{textareaField_kmrhm14v}}
FREFUNDBILLENTRY.FREMARK	备注	{{textareaField_kmrhm14v}}
FREFUNDBILLENTRY.F_QKZI_Assistant	往来类型	{{selectField_l2smcpih_id}}
FREFUNDBILLENTRY.FormId	业务对象表单Id	AR_REFUNDBILL	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FREFUNDBILLENTRY.Operation	执行的操作	BatchSave
FREFUNDBILLENTRY.IsAutoSubmitAndAudit	提交并审核	true
FREFUNDBILLENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接钉钉接口抽取数据后再自动分发到金蝶云星空，解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。