1. 应用场景描述——生产单数字化管理中的跨系统自动化集成流程

概述

💡

您可以使用新核云平台管理生产流程（如工单创建、生产进度跟踪等），同时通过飞书实现数据存储与可视化。
为实现生产单创建信息的实时同步与自动化记录，需打通新核云与飞书表格的数据链路，确保生产单创建动作触发后，相关数据能自动写入飞书表格，减少人工录入成本，提升生产管理效率。
本文档将针对此应用场景基于新核云开放平台集成 API 与事件订阅功能。

业务流程详解

触发事件：新核云生产单创建

当企业在新核云开放平台完成生产单创建（如工单派发、生产任务生成等）时，系统会主动触发 “创建生产单”事件。企业提前在新核云开放平台订阅该事件的 webhook 通知，指定将事件数据推送到飞书的回调地址（由飞书工作流提供的固定接收地址）。

飞书接收回调通知

新核云通过 webhook 将生产单创建的详细数据（如生产单编号、产品信息、生产时间、负责人、工序要求等）以 POST 请求形式发送至飞书预设的回调地址。飞书工作流引擎接收到该请求后，解析事件数据并启动后续流程。

飞书自动调用新核云 API 补充数据

飞书工作流可进一步通过 HTTP 请求调用新核云“生产单查询”API，获取完整业务数据。

数据落地：写入飞书表格“生产单记录”

飞书工作流通过调用飞书表格 API，将生产单数据写入指定的飞书表格 “生产单记录” 中，生成一条新的生产单记录，同时更新数据看板。表格可实时呈现生产单列表，支持团队成员查看、筛选、统计生产进度。生成记录与看板如下：

业务价值与应用场景

📌

核心价值：实现生产数据从创建到记录的全流程自动化，避免人工录入错误，确保多系统数据实时同步，为生产管理提供实时、准确的数据支撑。

适用场景举例：

制造业企业的生产工单管理系统（新核云）与团队协作平台（飞书）的集成;

需要实时追踪生产进度、集中管理生产数据的团队;

希望通过低代码工作流减少开发成本，快速实现跨系统数据互通的场景。

开发者关注点

🖊

系统对接前提：需在新核云开放平台完成 webhook 订阅配置，在飞书工作流中设置回调地址与表格写入权限；
数据格式：需明确新核云 webhook 推送的生产单字段与飞书表格字段的映射关系（如字段名称、数据类型）；
异常处理：建议增加流程容错逻辑（如网络超时重试、数据格式校验），确保生产单数据不丢失。

业务流程图

2. 事件订阅配置与管理流程

确认事件订阅方式和订阅身份

目前新核云开放平台支持的订阅方式是将事件发送至开发者服务器，即使用传统的 Webhook 模式，该方式需要您提供用于接收事件消息的服务器公网地址。

后续当应用订阅的事件发生时，开放平台会向服务器的公网地址发送 HTTP POST 请求，请求内包含事件数据。

此处需要使用飞书工作流提供的webhook接收地址以触发飞书工作流。

新核云开放平台创建应用

查看路径：开放平台→ Webhook ，点击新建按钮注册第三方应用

配置应用回调地址 (Webhook URL)

配置应用回调地址（此处应为飞书触发工作流 webhook 地址）

新核云开放平台同样支持将 webhook 事件推送到新核云为您开发的 Coze 工作流从而实现数据实时流畅对接。

订阅事件 (事件类型与筛选条件)

为应用添加订阅事件

事件列表支持根据事件名称/事件描述/事件分类进行搜索（此处为生产单创建事件，事件名称 productionOrder\_created）

选择需要订阅的事件

发布应用与启用订阅

点击保存发布应用，使配置生效

点击立即调试，测试服务器地址是否可访问

接收信息

当新核云系统中相关事件发生时，新核云开放平台会将已订阅的事件推送至相应的开发者服务器。相关事件推送日志可以在应用详情的 webhook 事件日志页签查看。

3. API调用流程详解

调用前提

用户需要先确认已开通以下商品：OpenApi。查看路径：导航栏 → 设置 → 订阅与账单 → 商品地图

右上角选择“已购商品”

搜索 OpenApi 商品并授权该商品给当前用户

新建应用

首先新建 API 应用——查看路径：导航栏 → 开放平台 → API → OAuth 客户端，点击右上角新建按钮

确定应用基本信息点击保存即可新建成功

此时系统会自动跳转到应用详情信息，获取系统自动生成的 APP Key 和 APP Secret（在后面第四步获取访问凭证中会用到）。后续也可以在“导航栏 → 开放平台 → API → OAuth 客户端”中找到应用详情按钮

配置用户权限 ( API 与数据权限)

不同的 API 有不同的接口权限和字段权限要求，在创建应用的时候，系统会初始化一个与应用名称相同的系统账号，默认分配管理员角色。

点击 API 应用详情按钮可以查看 API 应用权限关联情况。

具体权限细节可以在成员管理详情查看和修改分配角色，在角色管理详情修改功能及数据权限细节。

成员管理

角色管理

获取访问凭证（Access Token）

根据应用详情中生成的APP Key & APP Secret，调用新核云认证 API 获取访问凭证（Access Token）

构造并发送 API 请求

在完成上述创建应用、获取访问凭证、调整完 API 权限的步骤之后，才能调用 API。

调用 API 时，需要使用 HTTPS 协议、UTF-8 编码。

以查询生产单 API为例：

HTTP 请求行：

POST https://newsit.frp.newcoretech.com/api/open/v3/work_order/query

请求头：

--header 'Cookie;' \
--header 'Content-Type: application/json' \

请求体：

{
    "body": {
        "conditions": {
            "number": {
                "conditionType": "KEYWORD",
                "value": "WO-20240720-X1-001"
            }
        },
        "sorts": [
            {
                "sortOrder": "ASC",
                "sortFieldKey": "createTime"
            }
        ],
        "fieldKeys": [],
        "paging": {
            "start": 0,
            "length": 1
        }
    }
}

其他 API 请求体结构与示例请查看 API 参考。

查看 API 调用日志

查看路径：开放平台 → API → OAuth 客户端，找到对应 API 应用，点击详情按钮即可切换至 OpenAPI 日志

处理 API 响应

以查询生产单 API 为例：

返回响应成功时响应示例如下：

{   
    "code": 0,
    "message": "string",
    "data": {
        "list": [
            {
                "workOrderType": "string",
                "repairRootWorkOrderNumber": "string",
                "workOrderBaseUnitPlanQtyUnitName": "string",
                "repairOrderIndex": 0,
                "itemCode": "string",
                "number": "string",
                "itemName": "string",
                "workOrderCreateTime": 0,
                "snProduction": true,
                "workOrderProductionUnitPlanQtyUnitName": "string",
                "productionInQty": 0,
                "flowContainerFlowReceive": true,
                "assigneeType": "string",
                "routingProcessName": "string",
                "workOrderPlanQtyAssistUnitName": "string",
                "finishTime": 0,
                "assistUnitPlanQty": 0,
                "productionWarehouseName": "string",
                "itemAlbum": {},
                "workOrderWaitingProductInQtyProductionUnitName": "string",
                "bomVersion": "string",
                "reworkRootWorkOrderNumber": "string",
                "productionBatchCode": "string",
                "isOpenJbkLimit": true,
                "isUrgent": true,
                "workOrderProductInQtyAssistUnitName": "string",
                "requirementName": "string",
                "specialInspectFlowReceive": true,
                "baseUnitPlanQty": 0,
                "itemType": "string",
                "itemBlueprints": {},
                "requirementLineCode": "string",
                "reworkOrderIndex": 0,
                "workOrderItemSpecification": {},
                "flowReceiveDimension": "string",
                "assigneeName": "string",
                "startTime": 0,
                "unProductionInQty": 0,
                "workOrderStatus": "string",
                "itemRemark": "string",
                "printStatus": "string",
                "workOrderProductInQtyProductionUnitName": "string",
                "assistProductionInQty": 0,
                "createBy": 0,
                "auditStatus": "string",
                "endTime": 0,
                "productionUnitPlanQty": 0,
                "customizeField": {},
                "categoryId": "string"
            }
        ],
        "start": 0,
        "length": 0,
        "recordsTotal": 0
    }
}

具体 API 响应体结构与示例请查看 API 参考

🔔

在事件订阅与API调用配置完成后，我们只需要在飞书工作流设置好后续对表格的操作，对接新核云平台的事件订阅与 API 调用，新核云平台与飞书工作流集成的自动化生产单数据管理流程就搭建完毕了。

以上操作可以实现新核云推送——飞书触发工作流——飞书查询新核云生产单——飞书新增生产单记录的业务流程，实现生产单创建信息的实时同步与自动化记录。

💡

注：以上为针对特定业务场景的“事件订阅+API调用+飞书工作流”快速配置流程，关于事件、API的概念、参数设置与示例请参考事件订阅参考和 API 参考。

4. 获取帮助

访问新核云社区——开放平台提问

快速开始(API & 事件订阅)

1. 应用场景描述——生产单数字化管理中的跨系统自动化集成流程#

概述#

业务流程详解#

业务价值与应用场景#

开发者关注点#

业务流程图#

2. 事件订阅配置与管理流程#

3. API调用流程详解#

4. 获取帮助#