金蝶云星空与钉钉对接集成逐个单据查询连通发起审批实例(官方)(曹润测试用例)
接入系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标系统:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
数据接口配置
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的ExecuteBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为钉钉，并且选择对应连接器（关于钉钉的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的topapi/processinstance/create接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- API：ExecuteBillQuery
- NAME：逐个单据查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| Limit | Limit | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | StartRow | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | TopRowCount | | 金蝶的查询分页参数 |
| FilterString | FilterString | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | FieldKeys | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单id | PUR_PurchaseOrder | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| BillNo | 单据编号 | | |
| DocumentStatus | 单据状态 | | |
| Date | 采购日期 | | |
| PurchaseOrgId_Id | 采购组织Id | | |
| PurchaseOrgId_Name | 采购组织_名称 | | |
| PurchaseOrgId_Number | 采购组织编码 | | |
| SupplierId_Id | 供应商_Id | | |
| SupplierId_Name | 供应商名称 | | |
| SupplierId_Number | 供应商_编码 | | |
| PurchaserGroupId_Id | 采购组Id | | |
| PurchaserGroupId_Name | 采购组_名称 | | |
| PurchaserGroupId_Number | 采购组编码 | | |
| PurchaseDeptId_Id | 采购部门_Id | | |
| PurchaseDeptId_Name | 采购部门名称 | | |
| PurchaseDeptId_Number | 采购部门_编码 | | |
| CreatorId_Id | 创建人Id | | |
| CreatorId_Name | 创建人_名称 | | |
| CreatorId_Number | 创建人编码 | | |
| CreateDate | 创建日期 | | |
| ModifierId_Id | 最后修改人_Id | | |
| ModifierId_Name | 最后修改人名称 | | |
| ModifierId_Number | 最后修改人_编码 | | |
| ModifyDate | 最后修改日期 | | |
| ApproverId_Id | 审核人Id | | |
| ApproverId_Name | 审核人_名称 | | |
| ApproverId_Number | 审核人编码 | | |
| ApproveDate | 审核日期 | | |
| CancellerId_Id | 作废人_Id | | |
| CancellerId_Name | 作废人名称 | | |
| CancellerId_Number | 作废人_编码 | | |
| CancelDate | 作废日期 | | |
| CancelStatus | 作废状态 | | |
| CloseStatus | 关闭状态 | | |
| PurchaserId_Id | 采购员Id | | |
| PurchaserId_Name | 采购员_名称 | | |
| PurchaserId_Number | 采购员编码 | | |
| CloserId_Id | 关闭人_Id | | |
| CloserId_Name | 关闭人名称 | | |
| CloserId_Number | 关闭人_编码 | | |
| CloseDate | 关闭日期 | | |
| BillTypeId | 单据类型 | | |
| SettleId_Id | 结算方Id | | |
| SettleId_Name | 结算方_名称 | | |
| SettleId_Number | 结算方编码 | | |
| ChargeId_Id | 收款方_Id | | |
| ChargeId_Name | 收款方名称 | | |
| ChargeId_Number | 收款方_编码 | | |
| ProviderId_Id | 供货方Id | | |
| ProviderId_Name | 供货方_名称 | | |
| ProviderId_Number | 供货方编码 | | |
| ChangerId_Id | 变更人_Id | | |
| ChangerId_Name | 变更人名称 | | |
| ChangerId_Number | 变更人_编码 | | |
| VersionNo | 版本号 | | |
| ChangeDate | 变更日期 | | |
| ChangeReason | 变更原因 | | |
| BusinessType | 业务类型 | | |
| ProviderAddress | 供货方地址 | | |
| AssignSupplierId_Id | 指定供应商Id | | |
| AssignSupplierId_Name | 指定供应商_名称 | | |
| AssignSupplierId_Number | 指定供应商编码 | | |
| CorrespondOrgId_Id | 对应组织_Id | | |
| CorrespondOrgId_Name | 对应组织名称 | | |
| CorrespondOrgId_Number | 对应组织_编码 | | |
| ProviderContact | 供货方联系人(旧) | | |
| NETORDERBILLNO | 供应商协同平台订单编号(6.1废弃) | | |
| NetOrderBillId | 供应商协同平台订单ID(6.1废弃) | | |
钉钉接口明细
- 调用接口：topapi/processinstance/create
- 接口名称：发起审批实例(官方)
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| process_code | process_code | string | PROC-5C443CDA-5F12-4A0F-8998-E72D23E877A6 |
| originator_user_id | originator_user_id | string | 012720444240845261 |
| dept_id | dept_id | string | 737885083 |
| form_component_values | 审批流程表单参数 | object | |
| form_component_values.单据编号 | {{BillNo}} |
| form_component_values.采购日期 | | date | {{Date}} |
| form_component_values.供应商 | {{SupplierId_Id}} |
| form_component_values.表格 | | array | POOrderEntry |
| form_component_values.表格.物料编码 | {{POOrderEntry.MaterialId_Number}} |
| form_component_values.表格.物料名称 | | string | {{POOrderEntry.MaterialId_Name}} |
| form_component_values.表格.数量 | | string | {{POOrderEntry.Qty}} |
| form_component_values.name | name | string | 1 |
| form_component_values.value | value | string | 1 |
| form_component_values.ext_value | ext_value | string | 1 |
系统数据对接
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
