从钉钉到金蝶云星空通过接口配置打通数据
对接系统钉钉
钉钉(DingTalk)是阿里巴巴集团打造的企业级智能移动办公平台,是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合,打造简单、高效、安全、智能的数字化未来工作方式,助力企业的组织数字化和业务数字化,实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
对接系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取钉钉的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
钉钉接口明细
- 接口:v1.0/yida/processes/instances
- 接口名称:获取流程实例(宜搭)
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
pageNumber | 分页页码 | string | 分页页码 |
pageSize | 分页大小 | string | 分页大小 |
appType | 应用ID | string | 应用ID |
systemToken | 应用秘钥 | string | 应用秘钥 |
userId | 用户的userid | string | 用户的userid |
language | 语言 | string | 语言,取值:zh_CN:中文(默认值)en_US:英文 |
formUuid | 表单ID | string | 表单ID |
searchFieldJson | 条件 | object | |
searchFieldJson.selectField_kps4ziqh | 是否退还余额 | string | |
searchFieldJson.radioField_kmr4161k | 费用报销类型 | string | |
searchFieldJson.numberField_kpte5p5m | 退还余额数目 | string | |
searchFieldJson.selectField_kzfbcx6p | 部门过滤 | string | |
searchFieldJson.originatorId | 根据流程发起人工号查询 | string | 根据流程发起人工号查询 |
searchFieldJson.createFromTimeGMT | 创建时间起始值 | string | 创建时间起始值 |
searchFieldJson.createToTimeGMT | 创建时间终止值 | string | 创建时间终止值 |
searchFieldJson.modifiedFromTimeGMT | 修改时间起始值 | string | 修改时间起始值 |
searchFieldJson.modifiedToTimeGMT | 修改时间终止值 | string | 修改时间终止值 |
searchFieldJson.taskId | 任务ID | string | 任务ID |
searchFieldJson.instanceStatus | 实例状态 | string | 实例状态 |
searchFieldJson.approvedResult | 流程审批结果 | string | 流程审批结果 |
响应参数
字段 | 名称 | 类型 | 描述 |
---|---|---|---|
gmtCreate | 创建时间 | string | |
gmtModified | 最近修改时间 | string | |
originatorUserId | 创建人ID | string | |
originator | 创建人 | string | |
textField_krric5sp | 月周 | string | |
dateField_kzdsnfz6 | (出纳)实际支付时间 | string | |
dateField_knjy3x23 | 支付日期 | string | |
textField_kr4souex | 银行编码 | string | |
selectField_kq97ayh5 | 支付账号 | string | |
selectField_kq97ayh4 | 银行名称 | string | |
selectField_kq8ryql2 | 支付账户 | string | |
selectField_ksu2g8j8 | 费用付款组织 | string | |
textField_kqvme8kb | 银行账号(支付宝账号) | string | |
textField_kquqcu4u | 开户行信息(平台) | string | |
textField_kquqcu4t | 账户名(姓名) | string | |
textField_kquqcu4s | 姓名(或公司名称) | string | |
selectField_kqusm5fz | 银行账号(支付宝账号) | string | |
selectField_kqusm5fy | 开户行信息(平台) | string | |
selectField_kqusm5fx | 账户名(姓名) | string | |
textField_kqusm5fo | 姓名(或公司名称) | string | |
textareaField_kmr5pxq5 | 报销备注 | string | |
textField_kqkdpdhd | 编码 | string | |
selectField_kqhc3rpp | 名称 | string | |
selectField_kqhc3rpo | 收付款类型 | string | |
textField_krve6zzz | 领取人ID | string | |
selectField_krve6zzy | 现金领取人 | string | |
textField_ksgrs1iz | 支付方式编码 | string | |
selectField_kqusm5fn | 是否使用已有银行卡(账号) | string | |
selectField_kmr5pxpu | 付款方式 | string | |
textField_kymewuyd | 同类型是否超额 | string | |
numberField_kpte5p5m | 退回余额的金额数目 | string | |
selectField_kniak1fg | 费用承担组织1 | string | |
selectField_kps4ziqh | 是否退回余额 | string | |
textField_kr0e3y5s | 大写金额 | string | |
numberField_kmr5pxpw | 报销金额 | string | |
textField_ktwpaca7 | 原借款单付款组织编码 | string | |
textField_ksib71rm | 费用结算组织编码 | string | |
selectField_krln85xv | 费用结算组织 | string | |
selectField_l08vqg09 | 是培训费吗 | string | |
textField_kre7ut6w | 是否个税报销 | string | |
textField_l08vqg06 | OA培训需求审批单号 | string | |
textField_ksi8nb3c | 关联表单ID | string | |
associationFormField_kmr5pxq3 | 关联表单 | string | |
textField_kxsqd7f2 | 当前月份 | string | |
selectField_kzfbcx6p | 预算部门 | string | |
selectField_knjrgyjy | 费用类型 | string | |
numberField_kniuzfrc | 总借支金额 | string | |
numberField_kniuzfra | 其他专项费用已借支金额 | string | |
numberField_kniuzfr8 | 运营费用已借支金额 | string | |
numberField_kniuzfr6 | 管理费用已借支金额 | string | |
numberField_kneagd39 | 总借支金额 | string | |
numberField_kn74cez2 | 其他专项费用已借支金额 | string | |
numberField_kn74cez1 | 运营费用已借支金额 | string | |
numberField_kn74cez0 | 管理费用已借支金额 | string | |
textField_kqi4t37d | 人员层级 | string | |
textField_ksgtesv1 | 部门ID(借款核销) | string | |
selectField_knfsj0nc | 借支人部门 | string | |
textField_kmvrjgt7 | 借支人姓名 | string | |
selectField_koxm6nvm | 预算类型 | string | |
radioField_kmr4161k | 费用报销类型 | string | |
textField_krx3gzsq | 财务BP ID | string | |
textField_krk95hr8 | 部门中所有子部门ID(报表使用) | string | |
textField_krluijmr | 会计主管ID | string | |
textField_kre9gcbl | 项目决策层ID | string | |
textField_kr347dt3 | 负责会计 | string | |
textField_kr1x1q52 | 部门ID(实报实销) | string | |
textField_kspfxn6p | 流水号 | string | |
textField_krjzbmom | 员工ID | string | |
selectField_kmvrn6yn | 申请部门 | string | |
textField_kmvrjgt5 | 申请人姓名 | string | |
text_klkn4yn7 | |||
tableField_kne0yabj | array | ||
tableField_kne0yabj.attachmentField_kne0yabk | -附件 | string | |
tableField_kne0yabj.tableField_kq1n8j5t | 费用明细 | array | |
tableField_kne0yabj.tableField_kq1n8j5t.textField_kqlroj9m | 费用明细-金蝶费用科目编码 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.textField_kwjzbbra | 费用明细-费用承担部门编码 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.textField_kr4n1l6c | 费用明细-费用组织编码 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.textField_kxsqd7ey | 费用明细-预算科目编码 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.radioField_ks9mggs7 | 费用明细-是否充值到补单平台 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.numberField_kxsqd7ez | 费用明细-可用余额 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.numberField_kq1n8j60 | 费用明细-金额 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kwjzbbr9 | 费用明细-费用承担部门 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kwlrelvy | 费用明细-费用承担组织 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.textField_kveog2i7 | 费用明细-费用项目说明 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1i | 费用明细-费用项目 | string | |
tableField_kne0yabj.tableField_kq1n8j5t.selectField_kqlp6n1j | 费用明细-费用类别 | string |
金蝶云星空接口明细
- API:batchSave
- NAME:付款退款单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
---|---|---|---|
FBillNo | 单据编号 | {{textField_kspfxn6p}}(FKTK) | |
FSETTLEORGID | 结算组织 | 3035 | |
FEXCHANGETYPE | 汇率类型 | HLTX01_SYS | |
FDATE | 业务日期 | _function FROM_UNIXTIME( ( {{dateField_knjy3x23}} / 1000 ) ,'%Y-%m-%d' ) | |
FCURRENCYID | 币别 | PRE001 | |
FBillTypeID | 单据类型 | FKTKDLX02_SYS | |
FBUSINESSTYPE | 业务类型 | 3 | |
FCONTACTUNITTYPE | 往来单位类型 | BD_Empinfo | |
FCONTACTUNIT | 往来单位 | {{textField_krjzbmom}} | |
FPAYUNITTYPE | 付款单位类型 | BD_Empinfo | |
FPAYUNIT | 付款单位 | {{textField_krjzbmom}} | |
FDepartment | 部门 | {{textField_ksgtesv1}} | |
FPAYORGID | 付款组织 | 3035 | |
FSETTLECUR | 结算币别 | PRE001 | |
FREMARK | 备注 | {{textareaField_kmr5pxq5}} | |
FREFUNDBILLENTRY | 退款单明细 | ||
FREFUNDBILLENTRY.FSETTLETYPEID | 结算方式 | JSFS04_SYS | |
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR | 表体-应退金额 | {{numberField_kpte5p5m}} | |
FREFUNDBILLENTRY.FNOTE | 备注 | {{textareaField_kmr5pxq5}} | |
FREFUNDBILLENTRY.FACCOUNTID | 我方银行账号 | {{selectField_kq97ayh5}} | |
FREFUNDBILLENTRY.FEXPENSEDEPTID_E | 费用承担部门 | ||
FREFUNDBILLENTRY.FPURPOSEID | 原付款用途 | SFKYT11_SYS | |
FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E | 退款金额 | {{numberField_kpte5p5m}} | |
FREFUNDBILLENTRY.FormId | 业务对象表单Id | AP_REFUNDBILL | 必须填写金蝶的表单ID如 UR_PurchaseOrder |
FREFUNDBILLENTRY.Operation | 执行的操作 | BatchSave | |
FREFUNDBILLENTRY.IsAutoSubmitAndAudit | 提交并审核 | false | |
FREFUNDBILLENTRY.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
系统数据对接
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通钉钉到金蝶云星空之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。