金蝶云星空与钉钉对接集成获取流程实例（宜搭）连通付款退款单新增(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应用IDAPP_KFJOIBQ7VRMTDLQSLKQG应用ID systemToken应用秘钥JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO应用秘钥 userId用户的userid16000443318138909用户的userid language语言语言，取值：zh_CN：中文（默认值）en_US：英文 formUuid表单IDFORM-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业务对象表单IdAP_REFUNDBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder FREFUNDBILLENTRY.Operation执行的操作BatchSave FREFUNDBILLENTRY.IsAutoSubmitAndAudit提交并审核true FREFUNDBILLENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FREFUNDBILLENTRY.IsAutoAdjustField自动调整JSON字段顺序false

数据对接效果

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