金蝶云星空和钉钉单据接口对接
来源系统:钉钉
钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。
目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
配置集成方案
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的v1.0/yida/processes/instances作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
钉钉接口明细
- 接口：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.radioField_kmr4161k | 类型 | 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 | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：费用报销单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillNo | 单据编号 | string | |
| FOrgID | 申请组织 | string | |
| FProposerID | 申请人 | string | |
| FRequestDeptID | 申请部门 | string | |
| FExpenseDeptEntryID | 部门 | string | |
| FExpenseDeptID | 费用承担部门 | string | |
| FCurrencyID | 币别 | string | |
| FExchangeTypeID | 汇率类型 | string | |
| FDate | 日期 | string | |
| FCausa | 事由 | string | |
| FExpenseOrgId | 费用承担组织 | string | |
| FLocCurrencyID | 本位币 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FPayOrgId | 付款组织 | string | |
| FPaySettlleTypeID | 结算方式 | string | |
| FBankAccountT | 银行账号 | string | |
| FBankAccountNameT | 银行账户名称 | string | |
| FBankBranchT | 开户银行 | string | |
| FBillTypeID | 单据类型 | string | |
| FEntity | 明细 | array | |
| FEntity.FExpID | 费用项目 | string | |
| FEntity.FExpenseAmount | 金额 | string | |
| FEntity.FExpenseDeptID | 承担部门 | string | |
| FEntity.FTaxSubmitAmt | 费用金额 | string | |
| FEntity.FTaxAmt | 税额 | string | |
| FEntity.F_PAEZ_CheckBox | 是否充值到补单平台 | string | |
| FEntity.FRemark | 备注 | string | |
| FEntity.FEntity_Link | 关联关系 | array | |
| FEntity.FEntity_Link.FEntity_Link_FRuleId | 单据转换内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSTableName | 单据实体表名 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSBillId | 上游单据内码 | string | |
| FEntity.FEntity_Link.FEntity_Link_FSId | 上游单据实体内码 | string | |
| FEntity.FPayBox | 申请付款 | string | |
| FEntity.FRealPay | 实报实付 | string | |
| FEntity.F_PAEZ_SourceNo | 鸿巢单据编号 | string | |
| FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | string | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
数据对接价值
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
