金蝶云星空与钉钉对接集成逐个单据查询连通发起审批实例(官方)(曹润测试用例)

接入系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

对接目标系统:钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

数据接口配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的ExecuteBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为钉钉，并且选择对应连接器（关于钉钉的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的topapi/processinstance/create接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细

API：ExecuteBillQuery
NAME：逐个单据查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 LimitLimit{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRowStartRow{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCountTopRowCount金蝶的查询分页参数 FilterStringFilterStringFApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeysFieldKeys金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单idPUR_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_codeprocess_codestringPROC-5C443CDA-5F12-4A0F-8998-E72D23E877A6 originator_user_idoriginator_user_idstring012720444240845261 dept_iddept_idstring737885083 form_component_values审批流程表单参数object form_component_values.单据编号{{BillNo}} form_component_values.采购日期date{{Date}} form_component_values.供应商{{SupplierId_Id}} form_component_values.表格arrayPOOrderEntry form_component_values.表格.物料编码{{POOrderEntry.MaterialId_Number}} form_component_values.表格.物料名称string{{POOrderEntry.MaterialId_Name}} form_component_values.表格.数量string{{POOrderEntry.Qty}} form_component_values.namenamestring1 form_component_values.valuevaluestring1 form_component_values.ext_valueext_valuestring1

系统数据对接

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

金蝶云星空与钉钉对接集成逐个单据查询连通发起审批实例(官方)(曹润测试用例)