金蝶云星空与钉钉对接集成采购订单查询打通发起审批实例(官方)

来源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

接通系统：钉钉

钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。

数据接口配置

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

金蝶云星空接口明细

API：executeBillQuery
NAME：采购订单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FPOOrderEntry_FEntryIdidFPOOrderEntry_FEntryId FBillNo单据编号FBillNo单据编号 FSourceBillNo源单编号FSourceBillNo源单编号 FBillTypeID_FNumber单据类型FBillTypeID.FNumber单据类型 FBusinessType业务类型FBusinessType下拉列表 FSupplierId_FNumber供应商FSupplierId.FNumber基础资料 FSettleModeId_FNumber结算方式FSettleModeId.FNumber基础资料 FPayConditionId_FNumber付款条件FPayConditionId.FNumber基础资料 FDate采购日期FDate日期 FDocumentStatus单据状态FDocumentStatus单据状态 FPreMatchAmountFor预付已核销金额FPreMatchAmountFor金额 FPayAdvanceBillId_FNumber预付单号FPayAdvanceBillId.FNumber基础资料 FPurchaseOrgId_FNumber采购组织FPurchaseOrgId.FNumber组织 FPurchaseDeptId_FNumber采购部门FPurchaseDeptId.FNumber基础资料 FPurchaserGroupId_FNumber采购组FPurchaserGroupId.FNumber基础资料 FPurchaserId_FNumber采购员FPurchaserId.FNumber基础资料 FProviderId_FNumber供货方FProviderId.FNumber基础资料 FSettleId_FNumber结算方FSettleId.FNumber基础资料 FChargeId_FNumber收款方FChargeId.FNumber基础资料 FCorrespondOrgId_FNumber对应组织FCorrespondOrgId.FNumber组织 FAssignSupplierId_FNumber指定供应商FAssignSupplierId.FNumber基础资料 FMaterialId_FNumber物料编码FMaterialId.FNumber基础资料 FBarcode零售条形码FBarcode文本 FQty采购数量FQty数量 FDeliveryDate交货日期FDeliveryDate长日期 FLocation交货地点FLocation多行文本 FLocationAddress交货地址FLocationAddress多行文本 FPrice单价FPrice单价 FTaxPrice含税单价FTaxPrice单价 FEntryDiscountRate折扣率%FEntryDiscountRate小数 FEntryDiscount折扣额FEntryDiscount折扣额 FEntryTaxRate税率%FEntryTaxRate小数 FEntryTaxAmount税额FEntryTaxAmount金额 FAllAmount价税合计FAllAmount金额 FEntryAmount金额FEntryAmount金额 FRequireOrgId_FNumber需求组织FRequireOrgId.FNumber组织 FRequireDeptId_FNumber需求部门FRequireDeptId.FNumber基础资料 FRequireStaffId_FNumber需求人FRequireStaffId.FNumber基础资料 FReceiveOrgId_FNumber收料组织FReceiveOrgId.FNumber组织 FBranchId_FNumber收货门店FBranchId.FNumber基础资料 FReceiveDeptId_FNumber收料部门FReceiveDeptId.FNumber基础资料 FEntrySettleOrgId_FNumber结算组织FEntrySettleOrgId.FNumber组织 FGiveAway是否赠品FGiveAway复选框 FEntryNote备注FEntryNote多行文本 FSupMatId供应商物料编码FSupMatId文本 FMaterialId_FName物料名称FMaterialId.FName文本 FLot批号FLot批次 FSupplierLot供应商批号FSupplierLot文本 FReceiveQty累计收料数量FReceiveQty数量 FRemainReceiveQty剩余收料数量FRemainReceiveQty数量 FStockInQty累计入库数量FStockInQty数量 FRemainStockINQty剩余入库数量FRemainStockINQty数量 FMrbQty累计退料数量FMrbQty数量 FCHECKRETQTY收料可退数量FCHECKRETQTY数量 FSTOCKRETQTY库存可退数量FSTOCKRETQTY数量 FConsumeSumQty消耗汇总数量FConsumeSumQty数量 FSrcBillTypeId源单类型FSrcBillTypeId源单类型 FSrcBillNo源单编号FSrcBillNo源单编号 FReqTraceNo需求跟踪号FReqTraceNo文本 FMtoNo计划跟踪号FMtoNo文本 FDEMANDTYPE需求来源FDEMANDTYPE下拉列表 FDEMANDBILLNO需求单据编号FDEMANDBILLNO文本 FDEMANDBILLENTRYSEQ需求单据行号FDEMANDBILLENTRYSEQ整数 FDEMANDBILLENTRYID需求单据分录内码FDEMANDBILLENTRYID整数 FIDFID Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FDate >='{{LAST_SYNC_TIME datetime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdPUR_PurchaseOrder必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FPOOrderEntry_FEntryIdid FBillNo单据编号单据编号 FSourceBillNo源单编号源单编号 FBillTypeID_FNumber单据类型单据类型 FBusinessType业务类型下拉列表 FSupplierId_FNumber供应商基础资料 FSettleModeId_FNumber结算方式基础资料 FPayConditionId_FNumber付款条件基础资料 FDate采购日期日期 FDocumentStatus单据状态单据状态 FPreMatchAmountFor预付已核销金额金额 FPayAdvanceBillId_FNumber预付单号基础资料 FPurchaseOrgId_FNumber采购组织组织 FPurchaseDeptId_FNumber采购部门基础资料 FPurchaserGroupId_FNumber采购组基础资料 FPurchaserId_FNumber采购员基础资料 FProviderId_FNumber供货方基础资料 FSettleId_FNumber结算方基础资料 FChargeId_FNumber收款方基础资料 FCorrespondOrgId_FNumber对应组织组织 FAssignSupplierId_FNumber指定供应商基础资料 FMaterialId_FNumber物料编码基础资料 FBarcode零售条形码文本 FQty采购数量数量 FDeliveryDate交货日期长日期 FLocation交货地点多行文本 FLocationAddress交货地址多行文本 FPrice单价单价 FTaxPrice含税单价单价 FEntryDiscountRate折扣率%小数 FEntryDiscount折扣额折扣额 FEntryTaxRate税率%小数 FEntryTaxAmount税额金额 FAllAmount价税合计金额 FEntryAmount金额金额 FRequireOrgId_FNumber需求组织组织 FRequireDeptId_FNumber需求部门基础资料 FRequireStaffId_FNumber需求人基础资料 FReceiveOrgId_FNumber收料组织组织 FBranchId_FNumber收货门店基础资料 FReceiveDeptId_FNumber收料部门基础资料 FEntrySettleOrgId_FNumber结算组织组织 FGiveAway是否赠品复选框 FEntryNote备注多行文本 FSupMatId供应商物料编码文本 FMaterialId_FName物料名称文本 FLot批号批次 FSupplierLot供应商批号文本 FReceiveQty累计收料数量数量 FRemainReceiveQty剩余收料数量数量 FStockInQty累计入库数量数量 FRemainStockINQty剩余入库数量数量 FMrbQty累计退料数量数量 FCHECKRETQTY收料可退数量数量 FSTOCKRETQTY库存可退数量数量 FConsumeSumQty消耗汇总数量数量 FSrcBillTypeId源单类型源单类型 FSrcBillNo源单编号源单编号 FReqTraceNo需求跟踪号文本 FMtoNo计划跟踪号文本 FDEMANDTYPE需求来源下拉列表 FDEMANDBILLNO需求单据编号文本 FDEMANDBILLENTRYSEQ需求单据行号整数 FDEMANDBILLENTRYID需求单据分录内码整数 FIDFID

钉钉接口明细

接口：topapi/processinstance/create
接口名称：发起审批实例(官方)
接口方法：POST

请求参数

字段名称类型描述 process_code审批流的唯一码stringprocess_code在审批流程编辑页面的URL网址中获取。 originator_user_id发起人string审批实例发起人的userid。 dept_id发起人所在部门string发起人所在的部门，如果发起人属于根部门，传-1。 form_component_values审批流表单参数object form_component_values.采购单号 form_component_values.申请事由string form_component_values.期望交付日期 form_component_values.采购明细array form_component_values.采购明细.名称 form_component_values.采购明细.价格string form_component_values.采购明细.数量 form_component_values.采购明细.支付方式string form_component_values.采购明细.备注string

系统对接概况

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。

金蝶云星空与钉钉对接集成采购订单查询打通发起审批实例(官方)