Fulcrum 集成指南：使用 SkyPlanner APS 进行生产排程

Fulcrum 是一款多租户云产品，所有客户都使用相同的 API。开发者中心将其描述为一个公共 API，用于 “REST API calls directly into your Fulcrum site.”（直接向您的 Fulcrum 站点发起 REST API 调用）。

• 规范。OpenAPI “Fulcrum PublicAPI” v1，可从 https://api.fulcrumpro.com/swagger/v1/swagger.json 下载。Fulcrum 建议根据该规范生成带类型定义的客户端。History 页面按日期列出每次变更。
• 主机。标准站点使用 https://api.fulcrumpro.com。ITAR 站点使用 api.fulcrumpro.us；使用 ITAR 令牌访问 .com 主机会收到 401 响应。
• 调用方式。列表查询使用 POST .../list，在请求体中传入筛选条件，通过 Skip 和 Take 分页，并通过 Sort.Field / Sort.Dir 排序。许多对象支持 PUT，生产任务还支持 JSON Patch。

排程集成会使用以下端点：

Fulcrum 的集成页面直言：”Every system is a little bit different and requires some configuration.”（每个系统都有些不同，都需要进行一定的配置。）SkyPlanner 团队会在实施阶段承担这部分配置工作。

Fulcrum 支持由管理员配置 webhook。自 2026 年九月起，失败的 webhook 会暂停，并每天重新测试，不再无限重试。API History 列出了 PurchaseOrderUpdated、ItemUpdated 等事件。

集成按以下方式读取 Fulcrum 数据：

• 每隔几分钟轮询未完成的生产任务，筛选状态为 scheduled 或 inProgress，且满足 hasIncompleteOperations: true 的任务。这是 Fulcrum 官方提供的筛选条件，可使查询结果与其排程页面一致。
• 每次运行排程前读取采购订单和库存，或在已配置 PurchaseOrderUpdated webhook 的情况下，于收到该事件时读取。
• 物料、工艺路线、设备和班次在发生变更时读取，或每晚读取。

在反向传输中，SkyPlanner 自身的 webhook 会在排程变更时立即推送，因此回写采用事件驱动方式。

1. 首次加载主数据。先拉取物品、物料、工艺路线、工作中心和设备，再拉取部门班次和停机时间。每个 Fulcrum 工作中心都映射为一个 SkyPlanner 工作中心组，其下的设备成为组内成员。工艺路线中每道工序选定的设备，则成为该工序的可用工作中心。烘箱、喷漆房等设为 Unlimited Capacity 的设备映射为批次生产任务。

2. 订单同步。读取未结生产任务及其待制物品和工序，同时读取未结采购订单和库存。SkyPlanner 将已订购的物料视为在采购订单交货日可用，并在采购订单标记为 Delivered 时更新库存。每次重新排程时，都会检查库存和在途采购物料。

3. 排程结果回写。Fulcrum 自行计算 scheduledStartUtc、scheduledEndUtc 和 scheduledEquipmentId，并以只读形式返回这些字段。工序更新接口接受 customFields。SkyPlanner 将计划开始时间、计划结束时间和工作中心写入每道生产任务工序的自定义字段，同时将计划结束时间写入生产任务的自定义字段。销售和采购人员可在 Fulcrum 的生产任务中查看 SkyPlanner 的计划日期。

4. 车间报工。操作人员通过 Mobile Confirmations、Production Timer 或 Quick Log Mode 在 SkyPlanner 中记录作业。SkyPlanner 通过 /api/job-tracking-timers/start 和 /stop 将工时提交到 Fulcrum，也可通过 /api/timers 提交完整的已完成工时记录。完工数量通过 add-quantity-completed 提交，包含报废数量的最终数量通过 complete 提交。Fulcrum 中的生产任务成本核算保持实时更新。

5. 数据归属与冲突处理规则。Fulcrum 的排程器“dictates the order of operations in Job Tracking.”（决定 Job Tracking 中的工序顺序。）因此，每道工序只能选择一个派工渠道：SkyPlanner 的操作人员任务队列或 Fulcrum Job Tracking。上线前应明确记录以下规则：

• 人力体现在各班次的设备数量限制中。Fulcrum 中每个班次的 Max Equipment“is usually determined by how many people you have working in a certain area at that time.”（通常由当时在特定区域工作的人员数量决定。）具体操作人员及其班次在 SkyPlanner 中设置。人员姓名可从 /api/users 的用户数据中获取。
• 排程落实到设备。Fulcrum 的工作中心由可相互替代的设备组成。请确保工艺路线中选定的设备准确无误，因为排程引擎会从这些备选设备中进行选择。
• 工单用于归集生产任务。一张工单会将多个生产任务的工序归为一组，例如套料加工。在组内某道工序上启动计时，实际启动的是工单计时器，计时范围覆盖该组中的所有生产任务工序。
• 计时记录限制。通过 /api/timers 补录的工时记录“may not be in the future, older than 30 days, or longer than 7 days.”（不得记录未来的工时，也不得超出引文规定的补录期限或单条记录时长上限。）应在操作人员记录工时时及时提交。
• 时间格式各不相同。班次使用本地时间的 HHmm 值，停机时间和排程日期使用 UTC，工序预估时长则以秒为单位。
• 更新设备会替换整条记录。对设备发送 PUT 请求时，请求中未包含的字段都会被清空。SkyPlanner 只读取设备数据，从不写入。
• ITAR 站点。使用 .us 主机和 ITAR 令牌。