钉钉对接打通金蝶云星空获取审批实例详情接口与采购订单新增接口
数据源平台:钉钉
钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。
对接目标平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
多系统对接方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：钉钉的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试
钉钉接口明细
- API：钉钉回调事件
- NAME：获取审批实例详情
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| type | 审核事件 | finish | 可以过滤 启动:start,完成:finish |
| result | 审核结果 | agree | 审核的结果是同意agree还是不同意unagree |
| processCode | 审核表单模板ID | PROC-5F9D9F6E-F26F-4058-AEA8-22B84479E7F6 | 打开钉钉的模板编辑页面查看,网址参数中有该模板ID |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| 金蝶采购单号 | 文本 | ||
| 供应商 | 文本 | ||
| 日期 | 日期 | ||
| 报价明细 | 表格 | 报价明细 | |
| 报价明细.物料编码 | 文本 | ||
| 报价明细.数量 | 数字 | ||
| 报价明细.单价 | 数字 | ||
| 报价明细.备注 | 文本 | ||
| 报价明细.title | 文本 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购订单新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| FBillNo | 单据编号 | string | |
| FDate | 采购日期 | string | |
| FPurchaseOrgId | 采购组织 | string | |
| FSupplierId | 供应商 | string | |
| FPurchaserGroupId | 采购组 | string | |
| FPurchaserId | 采购员 | string | |
| FBillTypeID | 单据类型 | string | |
| FBusinessType | 业务类型 | string | |
| FPOOrderEntry | 明细信息 | array | |
| FPOOrderEntry.FMaterialId | 物料编码 | string | |
| FPOOrderEntry.FQty | 采购数量 | string | |
| FPOOrderEntry.FPrice | 单价 | string | |
| FPOOrderEntry.FEntryDiscountRate | 折扣率% | string | |
| FPOOrderEntry.FEntryTaxRate | 税率% | string | |
| FPOOrderEntry.FTaxNetPrice | 净价 | string | |
| FPOOrderEntry.FEntryAmount | 金额 | string | |
| FPOOrderEntry.FAllAmount | 价税合计 | string | |
| FPOOrderEntry.FEntryNote | 备注 | string | |
| FPOOrderEntry.FTaxPrice | 含税单价 | string | |
| FPOOrderEntry.FEntryTaxAmount | 税额 | string | |
| FPOOrderEntry.FReceiveOrgId | 收料组织 | string | |
| FPOOrderEntry.FRequireOrgId | 需求组织 | string | |
| FPOOrderEntry.FRowCost | 行费用 | string | |
| FPOOrderEntry.FEntryPayOrgId | 付款组织 | string | |
| FPOOrderEntry.FEntrySettleOrgId | 结算组织 | string | |
| FPOOrderEntry.FDeliveryDate | 交货日期 | string | |
| FPOOrderEntry.FMtoNo | 计划跟踪号 | string | |
| FPOOrderEntry.FGiveAway | 是否赠品 | string | true false |
| FPOOrderEntry.FPOOrderEntry_Link | 关联关系表 | array | |
| FPOOrderEntry.FPOOrderEntry_Link.FPOOrderEntry_Link_FRuleId | 单据关联关系 | string | SaleOrder-POOrder 或者 PUR_Requisition-PUR_PurchaseOrder |
| FPOOrderEntry.FPOOrderEntry_Link.FPOOrderEntry_Link_FSTableName | 源单主表 | string | |
| FPOOrderEntry.FPOOrderEntry_Link.FPOOrderEntry_Link_FSBillId | 源单内码表头ID | string | |
| FPOOrderEntry.FPOOrderEntry_Link.FPOOrderEntry_Link_FSId | 源单分录内码 | string | |
| FPOOrderEntry.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如
|
| FPOOrderEntry.Operation | 执行的操作 | string | |
| FPOOrderEntry.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FPOOrderEntry.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
数据对接效果
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：金蝶云星空与钉钉之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
