钉钉和金蝶云星空接口打通对接实战源系统:钉钉钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。写入目标:金蝶云星空金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。配置集成方案系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：钉钉的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试钉钉接口明细调用接口： v1.0/yida/processes/instances 接口名称：获取流程实例（宜搭）方法： POST 请求参数字段字段名称类型配置值 pageNumber 分页页码 string {{PAGINATION_START_PAGE}} pageSize 分页大小 string {{PAGINATION_PAGE_SIZE}} appType 应用ID string APP_KFJOIBQ7VRMTDLQSLKQG systemToken 应用秘钥 string JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO userId 用户的userid string 16000443318138909 language 语言 string formUuid 表单ID string FORM-TH866OD15SXQ06T31UZP06CVXI3J31C6B3TPKV searchFieldJson 条件 object searchFieldJson.selectField_kne9dbah 类型 string 销售收款 searchFieldJson.selectField_kzihphju 部门过滤 string searchFieldJson.originatorId 根据流程发起人工号查询 string searchFieldJson.createFromTimeGMT 创建时间起始值 string _function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 25 DAY),'%Y-%m-%d 00:00:00') searchFieldJson.createToTimeGMT 创建时间终止值 string {{CURRENT_TIME datetime}} searchFieldJson.modifiedFromTimeGMT 修改时间起始值 string searchFieldJson.modifiedToTimeGMT 修改时间终止值 string searchFieldJson.taskId 任务ID string searchFieldJson.instanceStatus 实例状态 string COMPLETED searchFieldJson.approvedResult 流程审批结果 string agree 响应参数字段字段名称类型配置值 gmtCreate 创建时间 string gmtModified 最近修改时间 string originatorUserId 创建人ID string originator 创建人 string attachmentField_kne13swd 附件 string textField_krrik8kb 月周 string dateField_kzdt0hej （出纳）实际支付时间 string dateField_kmrhm14u 支付日期 string textField_kqkdldg0 收付款类型编码 string selectField_kqhc3rpp 名称 string selectField_kqhc3rpo 收付款类型 string textField_kr4t0q6j 开户行编码 string selectField_kq97ayh5 收付款账号 string selectField_kq97ayh4 银行名称 string selectField_kq8ryql2 收付款账户 string textField_krltbok3 收款方账号 string textField_kse8m7d6 收款方开户行（平台） string textField_krltbok1 收款方户名 string textField_kmzzc949 汇款账号 string textField_kse8m7d5 汇款开户行（平台） string textField_kniia1wi 汇款账户户名 string textField_kse9l95k 退款方式编码 string selectField_krltbojq 退款方式 string textField_kse9l95j 汇款方式编码 string selectField_kmrhm14t 汇款方式 string textareaField_kmrhm14v 支付备注 string textField_kr0e8dd7 大写金额 string numberField_kmrhm14s 金额 string textField_kwjzqi0e 费用承担部门编码 string selectField_kwjzqi0d 费用承担部门 string textField_krvrp44e 费用收款组织编码 string selectField_krvrp44d 费用收款组织 string textField_kr4od4a5 费用结算组织编码 string selectField_knib34jo 费用结算组织 string textField_ksdy7bcw 往来单位类型编码 string textField_ksdy7bcv 付款单位类型编码 string textField_krvw0tz5 往来单位编码 string selectField_krvw0tz4 往来单位 string selectField_krvw0tz3 往来单位类型 string textField_kr4ijmtn 付款单位编码 string selectField_kqgcfms2 付款单位 string selectField_kr38pggy 付款单位类型 string selectField_kne9dbah 费用类别 string textField_ktuyr3cu 项目决策层ID string textField_ktuyr3ct 会计ID string textField_krk9d78n 部门中所有子部门ID（报表使用） string textField_kspcvc0q 流水号 string selectField_kzihphju 预算部门 string selectField_kmrhm14p 申请部门 string textField_kmvrv5xl 申请人 string text_klkn4yn7 string 金蝶云星空接口明细调用接口： batchSave 接口名称：新增收款单方法： POST 请求参数字段字段名称类型配置值 FBillNo 单据编号 string {{textField_kspcvc0q}} FBillTypeID 单据类型 string SKDLX01_SYS FDATE 日期 string function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' ) FPAYORGID 支付组织 string {{textField_krvrp44e}} FCONTACTUNITTYPE 往来单位类型 string {{textField_ksdy7bcv}} FCONTACTUNIT 往来单位 string {{textField_kr4ijmtn}} FPAYUNITTYPE 付款单位类型 string {{textField_ksdy7bcv}} FPAYUNIT 付款单位 string {{textField_kr4ijmtn}} FSETTLEORGID 结算组织 string {{textField_kr4od4a5}} FEXCHANGETYPE 汇率类型 string HLTX01_SYS FRECEIVEBILLENTRY 分录 array FRECEIVEBILLENTRY.FSETTLETYPEID 结算方式 string {{textField_kse9l95j}} FRECEIVEBILLENTRY.FPURPOSEID 收款用途 string {{textField_kqkdldg0}} FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR 应收金额 string {{numberField_kmrhm14s}} FRECEIVEBILLENTRY.FACCOUNTID 我方银行账号 string {{selectField_kq97ayh5}} FRECEIVEBILLENTRY.FCOSTDEPARTMENTID 费用承担部门 string {{textField_kwjzqi0e}} FRECEIVEBILLENTRY.FPOSTDATE 登账日期 string _function FROM_UNIXTIME( ( {{dateField_kmrhm14u}} / 1000 ) ,'%Y-%m-%d' ) FRECEIVEBILLENTRY.FCOMMENT 备注 string {{textareaField_kmrhm14v}} FRECEIVEBILLENTRY.F_QKZI_CheckBox 是否刷单 string {{radioField_l3wtnxo8_id}} FRECEIVEBILLENTRY.FREMARK 备注 string {{textareaField_kmrhm14v}} FRECEIVEBILLENTRY.F_QKZI_Assistant 往来类型 string _function case '{{selectField_l3nujj4l}}' when '否' then '" "' when '是' then '{{selectField_l2smcpih_id}}' end FRECEIVEBILLENTRY.FormId 业务对象表单Id string AR_RECEIVEBILL FRECEIVEBILLENTRY.Operation 执行的操作 string BatchSave FRECEIVEBILLENTRY.IsAutoSubmitAndAudit 提交并审核 bool true FRECEIVEBILLENTRY.IsVerifyBaseDataField 验证基础资料 bool false 数据对接效果从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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

小群青V

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

源系统:钉钉

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

写入目标:金蝶云星空

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

配置集成方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：钉钉的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

钉钉接口明细

调用接口：v1.0/yida/processes/instances
接口名称：获取流程实例（宜搭）
方法：POST

请求参数

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

响应参数

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

金蝶云星空接口明细

调用接口：batchSave
接口名称：新增收款单
方法：POST

请求参数

字段	字段名称	类型	配置值
FBillNo	单据编号	string	{{textField_kspcvc0q}}
FBillTypeID	单据类型	string	SKDLX01_SYS
FDATE	日期	string	function FROM_UNIXTIME( ( {{dateField_kzdt0hej}} / 1000 ) ,'%Y-%m-%d' )
FPAYORGID	支付组织	string	{{textField_krvrp44e}}
FCONTACTUNITTYPE	往来单位类型	string	{{textField_ksdy7bcv}}
FCONTACTUNIT	往来单位	string	{{textField_kr4ijmtn}}
FPAYUNITTYPE	付款单位类型	string	{{textField_ksdy7bcv}}
FPAYUNIT	付款单位	string	{{textField_kr4ijmtn}}
FSETTLEORGID	结算组织	string	{{textField_kr4od4a5}}
FEXCHANGETYPE	汇率类型	string	HLTX01_SYS
FRECEIVEBILLENTRY	分录	array
FRECEIVEBILLENTRY.FSETTLETYPEID	结算方式	string	{{textField_kse9l95j}}
FRECEIVEBILLENTRY.FPURPOSEID	收款用途	string	{{textField_kqkdldg0}}
FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR	应收金额	string	{{numberField_kmrhm14s}}
FRECEIVEBILLENTRY.FACCOUNTID	我方银行账号	string	{{selectField_kq97ayh5}}
FRECEIVEBILLENTRY.FCOSTDEPARTMENTID	费用承担部门	string	{{textField_kwjzqi0e}}
FRECEIVEBILLENTRY.FPOSTDATE	登账日期	string	_function FROM_UNIXTIME( ( {{dateField_kmrhm14u}} / 1000 ) ,'%Y-%m-%d' )
FRECEIVEBILLENTRY.FCOMMENT	备注	string	{{textareaField_kmrhm14v}}
FRECEIVEBILLENTRY.F_QKZI_CheckBox	是否刷单	string	{{radioField_l3wtnxo8_id}}
FRECEIVEBILLENTRY.FREMARK	备注	string	{{textareaField_kmrhm14v}}
FRECEIVEBILLENTRY.F_QKZI_Assistant	往来类型	string	_function case '{{selectField_l3nujj4l}}' when '否' then '" "' when '是' then '{{selectField_l2smcpih_id}}' end
FRECEIVEBILLENTRY.FormId	业务对象表单Id	string	AR_RECEIVEBILL
FRECEIVEBILLENTRY.Operation	执行的操作	string	BatchSave
FRECEIVEBILLENTRY.IsAutoSubmitAndAudit	提交并审核	bool	true
FRECEIVEBILLENTRY.IsVerifyBaseDataField	验证基础资料	bool	false

数据对接效果

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