金蝶云星空与钉钉对接集成获取流程实例（宜搭）连通付款退款单新增(pay-新付款单（采购业务退款）3.2) 源系统:钉钉钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。对接目标系统:金蝶云星空金蝶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-SF7668D1WSXQMDD91CVY2DE8N31A3SO3O2TPKI 表单ID searchFieldJson 条件 searchFieldJson.tableField_ks8du8cn 费用类型采购业务退款 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_kne10frr 附件 textField_krrifpia 月周 dateField_kzdss937 （出纳）实际支付时间 dateField_kmtur42b 支付日期 textField_kr0e5cz1 大写金额 numberField_kmtur429 付款金额 textField_krvc4smc 领取人ID selectField_krvc4smd 现金领取人 textField_knilr38e 店铺名称 textField_kr4srb6g 银行编码 selectField_kq97ayh5 支付账号 selectField_kq97ayh4 银行名称 selectField_kq8ryql2 支付账户 selectField_ksvm8emp 使用组织 selectField_kq97ayh7 收款账号 selectField_kq97ayh6 开户行 textField_kr3bzvp9 供应商编码 selectField_kq8ryqku 账户名称 selectField_kqtes7jf 供应商公司名称 textField_kqvmf2oz 银行账号（支付宝账号） textField_kquqiisq 开户行信息（平台） textField_kquqiisp 账户名（姓名） textField_kquqiiso 姓名（或公司名称） selectField_kqusyuon 银行账号（支付宝账号） selectField_kqusyuom 开户行信息（平台） selectField_kqusyuol 账户名（姓名） textField_kqusyukd 姓名（或公司名称） textField_ksgrv3w7 支付方式编码 selectField_kqusyukc 是否使用已有银行卡（账号） selectField_kmtur42a 支付方式 textareaField_kmtur42c 支付备注 textField_kymd8lvh 是否超额 selectField_kusbhpna 是否有其他业务退款 textField_krvn3q2s 费用付款组织编码 selectField_krvn3q2r 费用付款组织 textField_ksi9cvxv 收款单位编码 textField_ksi9cvxu 收款单位类型编码 textField_ksi9cvxt 往来单位编码 textField_ksi9cvxs 往来单位类型编码 selectField_ksi9cvru 收款单位 selectField_ksi9cvxw 收款单位类型 selectField_ksi9cvrs 往来单位 selectField_ksi9cvrr 往来单位类型 textField_kxsr74nn 当前月份 selectField_kzfbjzzc 预算部门 textField_kqhqqhxg 人员层级 selectField_knb5wqws 费用分类 textField_kznt0sx9 (IT资产预算)项目经营层 textField_kznskx5a 会计节点（IT资产预算） textField_kzmc9fvi 供应链款专用经营层ID textField_kt88xy7u 收付款类型 textField_krx3qkwl 财务BP ID textField_ksgrv3w5 部门ID textField_kr1wqtgr 部门中所有子部门ID（报表使用） textField_krfqhwq1 会计主管ID textField_kren2tv6 事业群负责人ID textField_kren2tv5 项目决策层ID textField_krfqhwq2 出纳ID textField_kren2tv4 会计ID textField_kspditvc 流水号 textField_krjzfufc 员工ID selectField_kmvrqh6p 申请部门 textField_kmvrqh6o 申请人姓名 text_klkn4yn7 tableField_ks8du8cn 付款信息 tableField_ks8du8cn.textField_kr4o8bn3 付款信息-费用结算组织编码 tableField_ks8du8cn.textField_kqhmwk8r 付款信息-费用项目金蝶编码 tableField_ks8du8cn.textField_kqkdoig6 付款信息-付款用途编码 tableField_ks8du8cn.textField_kwjzl5jv 付款信息-费用承担部门编码 tableField_ks8du8cn.textField_kxsr74np 付款信息-预算科目编码 tableField_ks8du8cn.selectField_kqhc3rpp 付款信息-付款用途 tableField_ks8du8cn.numberField_kxsr74no 付款信息-可用余额 tableField_ks8du8cn.numberField_ks8du8cr 付款信息-金额 tableField_ks8du8cn.selectField_kwjzl5ju 付款信息-费用承担部门 tableField_ks8du8cn.selectField_knib19yl 付款信息-费用承担组织 tableField_ks8du8cn.textField_kveoi7y9 付款信息-费用项目说明 tableField_ks8du8cn.selectField_ks8du8cq 付款信息-费用项目 tableField_ks8du8cn.selectField_ks8du8cp 付款信息-费用类别金蝶云星空接口明细 API： batchSave NAME：付款退款单新增 METHOD： POST 请求参数接口字段字段名称预设值描述 FBillNo 单据编号 {{textField_kspditvc}}（FKTK） FSETTLEORGID 结算组织 {{tableField_ks8du8cn.textField_kr4o8bn3}} FEXCHANGETYPE 汇率类型 HLTX01_SYS FDATE 业务日期 function FROM_UNIXTIME( ( {{dateField_kzdss937}} / 1000 ) ,'%Y-%m-%d' ) FCURRENCYID 币别 PRE001 FBillTypeID 单据类型 FKTKDLX01_SYS FBUSINESSTYPE 业务类型 2 FCONTACTUNITTYPE 往来单位类型 {{textField_ksi9cvxu}} FCONTACTUNIT 往来单位 {{textField_ksi9cvxv}} FPAYUNITTYPE 付款单位类型 {{textField_ksi9cvxu}} FPAYUNIT 付款单位 {{textField_ksi9cvxv}} FPurchaseDeptId 部门 {{tableField_ks8du8cn.textField_kwjzl5jv}} FPAYORGID 付款组织 {{textField_krvn3q2s}} FSETTLECUR 结算币别 PRE001 FREMARK 备注 {{textareaField_kmtur42c}} FREFUNDBILLENTRY 退款单明细 tableField_ks8du8cn FREFUNDBILLENTRY.FSETTLETYPEID 结算方式 {{textField_ksgrv3w7}} FREFUNDBILLENTRY.FREFUNDAMOUNTFOR 表体-应退金额 {{tableField_ks8du8cn.numberField_ks8du8cr}} FREFUNDBILLENTRY.FNOTE 备注 {{textareaField_kmtur42c}} FREFUNDBILLENTRY.FACCOUNTID 我方银行账号 {{selectField_kq97ayh5}} FREFUNDBILLENTRY.FPURPOSEID 原付款用途 SFKYT08_SYS FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E 退款金额 {{tableField_ks8du8cn.numberField_ks8du8cr}} FREFUNDBILLENTRY.F_QKZI_Assistant 往来类型 _function case '{{selectField_l3nw36ir}}' when '否' then ' ' when '是' then '{{selectField_l358521u_id}}' end FREFUNDBILLENTRY.FormId 业务对象表单Id AP_REFUNDBILL 必须填写金蝶的表单ID如😛UR_PurchaseOrder FREFUNDBILLENTRY.Operation 执行的操作 BatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit 提交并审核 true FREFUNDBILLENTRY.IsVerifyBaseDataField 验证基础资料 false 是否验证所有的基础资料有效性，布尔类，默认false（非必录） FREFUNDBILLENTRY.IsAutoAdjustField 自动调整JSON字段顺序 false 数据对接效果通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接钉钉和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

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

汪淼_轻易云

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

源系统:钉钉

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

对接目标系统:金蝶云星空

金蝶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-SF7668D1WSXQMDD91CVY2DE8N31A3SO3O2TPKI	表单ID
searchFieldJson	条件
searchFieldJson.tableField_ks8du8cn	费用类型	采购业务退款
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_kne10frr	附件
textField_krrifpia	月周
dateField_kzdss937	（出纳）实际支付时间
dateField_kmtur42b	支付日期
textField_kr0e5cz1	大写金额
numberField_kmtur429	付款金额
textField_krvc4smc	领取人ID
selectField_krvc4smd	现金领取人
textField_knilr38e	店铺名称
textField_kr4srb6g	银行编码
selectField_kq97ayh5	支付账号
selectField_kq97ayh4	银行名称
selectField_kq8ryql2	支付账户
selectField_ksvm8emp	使用组织
selectField_kq97ayh7	收款账号
selectField_kq97ayh6	开户行
textField_kr3bzvp9	供应商编码
selectField_kq8ryqku	账户名称
selectField_kqtes7jf	供应商公司名称
textField_kqvmf2oz	银行账号（支付宝账号）
textField_kquqiisq	开户行信息（平台）
textField_kquqiisp	账户名（姓名）
textField_kquqiiso	姓名（或公司名称）
selectField_kqusyuon	银行账号（支付宝账号）
selectField_kqusyuom	开户行信息（平台）
selectField_kqusyuol	账户名（姓名）
textField_kqusyukd	姓名（或公司名称）
textField_ksgrv3w7	支付方式编码
selectField_kqusyukc	是否使用已有银行卡（账号）
selectField_kmtur42a	支付方式
textareaField_kmtur42c	支付备注
textField_kymd8lvh	是否超额
selectField_kusbhpna	是否有其他业务退款
textField_krvn3q2s	费用付款组织编码
selectField_krvn3q2r	费用付款组织
textField_ksi9cvxv	收款单位编码
textField_ksi9cvxu	收款单位类型编码
textField_ksi9cvxt	往来单位编码
textField_ksi9cvxs	往来单位类型编码
selectField_ksi9cvru	收款单位
selectField_ksi9cvxw	收款单位类型
selectField_ksi9cvrs	往来单位
selectField_ksi9cvrr	往来单位类型
textField_kxsr74nn	当前月份
selectField_kzfbjzzc	预算部门
textField_kqhqqhxg	人员层级
selectField_knb5wqws	费用分类
textField_kznt0sx9	(IT资产预算)项目经营层
textField_kznskx5a	会计节点（IT资产预算）
textField_kzmc9fvi	供应链款专用经营层ID
textField_kt88xy7u	收付款类型
textField_krx3qkwl	财务BP ID
textField_ksgrv3w5	部门ID
textField_kr1wqtgr	部门中所有子部门ID（报表使用）
textField_krfqhwq1	会计主管ID
textField_kren2tv6	事业群负责人ID
textField_kren2tv5	项目决策层ID
textField_krfqhwq2	出纳ID
textField_kren2tv4	会计ID
textField_kspditvc	流水号
textField_krjzfufc	员工ID
selectField_kmvrqh6p	申请部门
textField_kmvrqh6o	申请人姓名
text_klkn4yn7
tableField_ks8du8cn	付款信息
tableField_ks8du8cn.textField_kr4o8bn3	付款信息-费用结算组织编码
tableField_ks8du8cn.textField_kqhmwk8r	付款信息-费用项目金蝶编码
tableField_ks8du8cn.textField_kqkdoig6	付款信息-付款用途编码
tableField_ks8du8cn.textField_kwjzl5jv	付款信息-费用承担部门编码
tableField_ks8du8cn.textField_kxsr74np	付款信息-预算科目编码
tableField_ks8du8cn.selectField_kqhc3rpp	付款信息-付款用途
tableField_ks8du8cn.numberField_kxsr74no	付款信息-可用余额
tableField_ks8du8cn.numberField_ks8du8cr	付款信息-金额
tableField_ks8du8cn.selectField_kwjzl5ju	付款信息-费用承担部门
tableField_ks8du8cn.selectField_knib19yl	付款信息-费用承担组织
tableField_ks8du8cn.textField_kveoi7y9	付款信息-费用项目说明
tableField_ks8du8cn.selectField_ks8du8cq	付款信息-费用项目
tableField_ks8du8cn.selectField_ks8du8cp	付款信息-费用类别

金蝶云星空接口明细

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

请求参数

接口字段	字段名称	预设值	描述
FBillNo	单据编号	{{textField_kspditvc}}（FKTK）
FSETTLEORGID	结算组织	{{tableField_ks8du8cn.textField_kr4o8bn3}}
FEXCHANGETYPE	汇率类型	HLTX01_SYS
FDATE	业务日期	function FROM_UNIXTIME( ( {{dateField_kzdss937}} / 1000 ) ,'%Y-%m-%d' )
FCURRENCYID	币别	PRE001
FBillTypeID	单据类型	FKTKDLX01_SYS
FBUSINESSTYPE	业务类型	2
FCONTACTUNITTYPE	往来单位类型	{{textField_ksi9cvxu}}
FCONTACTUNIT	往来单位	{{textField_ksi9cvxv}}
FPAYUNITTYPE	付款单位类型	{{textField_ksi9cvxu}}
FPAYUNIT	付款单位	{{textField_ksi9cvxv}}
FPurchaseDeptId	部门	{{tableField_ks8du8cn.textField_kwjzl5jv}}
FPAYORGID	付款组织	{{textField_krvn3q2s}}
FSETTLECUR	结算币别	PRE001
FREMARK	备注	{{textareaField_kmtur42c}}
FREFUNDBILLENTRY	退款单明细	tableField_ks8du8cn
FREFUNDBILLENTRY.FSETTLETYPEID	结算方式	{{textField_ksgrv3w7}}
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR	表体-应退金额	{{tableField_ks8du8cn.numberField_ks8du8cr}}
FREFUNDBILLENTRY.FNOTE	备注	{{textareaField_kmtur42c}}
FREFUNDBILLENTRY.FACCOUNTID	我方银行账号	{{selectField_kq97ayh5}}
FREFUNDBILLENTRY.FPURPOSEID	原付款用途	SFKYT08_SYS
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E	退款金额	{{tableField_ks8du8cn.numberField_ks8du8cr}}
FREFUNDBILLENTRY.F_QKZI_Assistant	往来类型	_function case '{{selectField_l3nw36ir}}' when '否' then ' ' when '是' then '{{selectField_l358521u_id}}' end
FREFUNDBILLENTRY.FormId	业务对象表单Id	AP_REFUNDBILL	必须填写金蝶的表单ID如😛UR_PurchaseOrder
FREFUNDBILLENTRY.Operation	执行的操作	BatchSave
FREFUNDBILLENTRY.IsAutoSubmitAndAudit	提交并审核	true
FREFUNDBILLENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FREFUNDBILLENTRY.IsAutoAdjustField	自动调整JSON字段顺序	false

数据对接效果

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接钉钉和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。