KARAT 集成指南：使用 SkyPlanner APS 进行生产排程
本 KARAT 集成指南介绍合作伙伴和 IT 团队如何将 IS KARAT 连接至 SkyPlanner APS。SkyPlanner 通过 KARAT 自身的接口实现双向集成：
- 导入生产订单（výrobní příkazy）、生产任务（výrobní zakázky）及其工序，以及物料卡片、物料清单、工艺路线、机器、作业场所、人员资源、库存和已下达的采购订单。
- 将计划开始和完成日期回写至 KARAT 的生产数据。
- 您也可以选择通过 KARAT 终端报工接口回传操作人员的工时记录。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
在上线准备阶段，SkyPlanner 团队会根据您的 KARAT 配置完成集成，并在上线后继续提供支持。本指南面向希望参与集成，或自行使用 SkyPlanner 的 REST API 进行开发的 KARAT 合作伙伴和开发人员。该 API 提供了相应文档（API 参考文档）。
KARAT 的集成接口
约定的数据接口。
KARAT Software 表示，ERP KARAT 的开放性使其能够连接其他外部信息系统，并支持 XML、EDI、ISDOC 和 ISDS 格式的电子数据交换（KARAT 软件开发）。对于排程系统，这意味着需要针对您的部署约定接口，用于导出未结生产订单、工艺路线、资源、库存和采购订单，并导入计划日期。
终端报工接口。
KARAT 的终端报工模块（terminálové odvádění）负责准备要导出至外部系统的数据，并按约定接口接收导入数据（终端报工）。它处理开工、中断、完工、工序交接、生产领料和成品入库。SkyPlanner 中记录的作业数据适合通过此接口回传。
系统集成服务。
KARAT Software 提供服务，将 IS KARAT 与车间数据采集系统、自动化仓库、CAD/CAM 及其他专业应用连接起来（系统集成）。在范围评估阶段，SkyPlanner 团队会与 KARAT Software 或您的 KARAT 合作伙伴共同约定接口。
Excel 和 CSV。
将未结生产订单导出为 Excel 或 CSV，即可满足试用时的数据导入需求。
身份验证与许可
- 集成用户。接口以 KARAT 用户身份运行，该用户需具备接口所读写的生产、仓储和采购数据的访问权限。KARAT 的访问权限可细化至单个表键，因此应严格限定授权范围。
- 部署。IS KARAT 支持本地部署、外包托管或 SaaS 模式。在范围评估阶段，会根据您的部署方式确定约定接口的传输方式（文件交换或服务端点）。
- 许可。约定接口及 KARAT Software 承担的所有工作，均需与 KARAT Software 或您的合作伙伴协商安排。
SkyPlanner 的 REST API 使用 Authorization-Token 请求头中的 API 令牌进行身份验证（SkyPlanner Settings > API），文档采用 Swagger/OpenAPI 格式。集成教程介绍了首次调用的具体步骤。
事件与轮询
SkyPlanner 定期读取 KARAT 数据。通过约定接口定期导出或读取数据，并筛选未结生产订单和近期变更，即可获取新的生产任务。频率按工厂设置，例如每隔几分钟读取生产订单，每小时读取库存。
状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写由事件驱动。
数据映射
| KARAT 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 物料卡片（karty）、计量单位 | 产品和物料 | KARAT → SkyPlanner | 首次导入，此后轮询 |
| 物料清单（kusovníky） | 产品结构、子产品、各产品所需物料 | KARAT → SkyPlanner | 首次导入，此后有变更时更新 |
| 工艺路线（technologické postupy）、工序及工时 | 工艺步骤及其加工、准备和拆卸时间 | KARAT → SkyPlanner | 首次导入，此后有变更时更新 |
| 资源（zdroje）：机器、作业场所 | 工作中心、工作中心组、备选工作中心 | KARAT → SkyPlanner | 首次导入，此后很少更新 |
| 人员资源 | 人员及每项生产任务所需的操作人数 | KARAT → SkyPlanner | 首次导入，此后有变更时更新 |
| 生产订单（výrobní příkazy）、生产任务（výrobní zakázky）、工序、物料 | 订单和生产任务及其交期、物料需求 | KARAT → SkyPlanner | 每隔几分钟轮询 |
| 仓库库存（sklady） | 库存结余 | KARAT → SkyPlanner | 每小时或运行排程时轮询 |
| 已下达的采购订单（objednávky vydané）及其交货日期 | 采购订单、按交货日期列出的待到货物料 | KARAT → SkyPlanner | 每小时或运行排程时轮询 |
| 订单各工序的计划开始和完成时间（按约定导入） | 各生产任务的计划开始和结束时间 | SkyPlanner → KARAT | 排程变更时，通过 SkyPlanner webhook 触发 |
| 终端报工：开工、停工、交接、数量 | 工时记录和操作人员报工 | SkyPlanner → KARAT | 如选择回传，则每次报工或每班次回传 |
| KARAT 中不存在 | 准备时间矩阵、作为有限资源的工具、多人协作的生产任务 | 在 SkyPlanner 中维护 | 在上线准备阶段设置 |
集成模式
1. 首次导入主数据。读取物料卡片、物料清单、工艺路线和资源。资源映射到 SkyPlanner 时应明确建模方式：一个配有四台机器的作业场所，可映射为一个工作中心组或四个工作中心。对于工艺师、设计师等从事前期准备工作、通过加权计划安排的人员资源，默认不纳入车间排程，除非您另有决定。
2. 订单同步。读取已下达的生产订单及其工序和物料，以及已下达的采购订单。SkyPlanner 将已订购物料视为在采购订单交货日可用，并在采购订单标记为 Delivered 时更新库存。
3. 排程回写。当引擎安排或移动生产任务时，SkyPlanner webhook 会触发日期导入，将计划开始和完成日期通过约定接口导入 KARAT。KARAT 中的导入目标是资源预留，还是生产订单上的工序日期，将在上线准备的范围评估阶段确定。
4. 车间报工。操作人员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录使排程保持最新。您可以选择是否将实际工时回传至 KARAT。若选择回传，则通过终端报工接口，以各工序的开工、停工和数量事件形式导入。若不回传，操作人员继续在 KARAT 终端报工，由 SkyPlanner 读取这些报工记录。
5. 数据归属与冲突处理规则。上线前应书面明确以下规则：
| 数据 | 归属系统 |
|---|---|
| 物料卡片、物料清单、工艺路线、数量、订单状态 | KARAT |
| 工序顺序、开始和完成时间、机器分配 | SkyPlanner |
| 准备时间矩阵、工具和操作人员需求、备选资源 | SkyPlanner |
| 班次和非工作日 | 由一个系统维护，在范围评估阶段确定 |
| 工序报工、物料出入库 | KARAT，可直接录入，也可从 SkyPlanner 工时记录回传 |
订单日期只由一个系统写入。如果 APS KARAT 仍会将计划保存回生产数据，应对由 SkyPlanner 排程的订单关闭此功能，避免两个系统相互覆盖。
典型项目步骤
实施通常在上线准备工作启动后的几周内完成。在此之前，可将 KARAT 中的机器、工艺路线和未结生产订单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 映射。确定映射表、数据归属规则、同步频率，以及是否回传工序报工记录。
- KARAT 接口。与 KARAT Software 或您的合作伙伴约定导出和导入格式及传输方式，并设置集成用户。先在数据库副本上测试。
- 首次导入。导入物料卡片、物料清单、工艺路线和资源。
- 订单与采购订单同步。定期读取数据，并配置筛选条件和重试机制。
- 在 SkyPlanner 中配置约束。设置准备时间矩阵、工具、每项生产任务的操作人员数量，以及可替代的机器或人员。
- 回写排程结果。测试计划日期的导入；如果选择导入终端报工数据，也需进行测试。
- 并行测试。在沿用现有计划的同时运行 SkyPlanner，对比日期并修正主数据。
- 正式上线。数据核对一致后，启用回写。
KARAT 集成需要提前规划什么
- 接口需根据各部署环境商定。预留时间，与 KARAT Software 或您的合作伙伴进行范围评估，并在数据映射文档中明确记录导出和导入格式。
- 明确计划由谁负责。APS KARAT 在关闭时会将计划保存到生产数据中。需决定是否仍由它为部分订单制定计划，以及具体是哪些订单。
- 跨工厂主计划。逐一确定各工厂中哪些订单由 SkyPlanner 排程。
- 现有终端集成。如果终端报工数据已导出至其他系统，应复用已商定的接口来传输 SkyPlanner 工时记录，而不是另增一套接口。
- 时间单位。首次加载时，检查工艺路线中工序时间的单位。所有时长都取决于这一设置。
谁负责 KARAT 集成的配置与支持
- SkyPlanner 团队在实施阶段负责配置，并在上线后提供支持，涵盖商定的导出、导入及终端报工流程。每家工厂使用 KARAT 的方式都不同，这些实际经验正是配置和支持的依据。
- KARAT Software 或您的 KARAT 合作伙伴也可以参与。他们了解您的部署环境和数据结构，可以与 SkyPlanner 团队一起配置商定的接口和集成用户账号。
- 您自己的开发人员也可以在此基础上开发，使用 API 令牌调用 SkyPlanner 的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求，与订阅方案一并提前报价。请参阅价格、KARAT 生产排程、KARAT 页面和 ERP 集成中心。如需了解排程基础知识，请参阅生产排程。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 电子表格走向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘与开关设备
生产计划工作每周节省 2 小时，新的任务队列几秒钟内就能下达到生产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划只需不到 30 分钟。
99.2%准时交付率
“SkyPlanner 让瓶颈变得清晰可见，也让生产管理更加清楚有序。”
Toni Tuori，生产经理
Piristeel · 屋顶安全设施与雨水系统
今年准时交付率达到 99.2%，排程工作每天最多可节省四小时。
减少缺料停产
“SkyPlanner 为我们带来的价值在于，它是一个能在日常工作中切实发挥作用的工具，尤其是在确定交货日期方面。”
Tommi Männistö，生产计划经理
Eskomatic · 机械加工服务
自动负荷排程让交货日期更准确，因缺料导致的停产也大幅减少。
常见问题
SkyPlanner 如何连接 KARAT？
通过商定的 KARAT XML 数据接口传输订单、主数据和计划日期，并通过 KARAT 终端报工传输已记录的作业数据。SkyPlanner 团队会在实施阶段与 KARAT Software 或您的 KARAT 合作伙伴一起完成配置。
SkyPlanner 如何获取 KARAT 中的变更？
SkyPlanner 按各工厂设定的周期读取 KARAT 数据，筛选未结生产订单和近期变更。SkyPlanner 自身的 webhook 会在排程发生变更时即时推送。
计划日期如何回写到 KARAT？
通过商定的接口，按订单工序导入计划开始日期和完成日期。SkyPlanner 团队会在实施阶段的范围评估中确定导入目标：资源预留记录，或生产订单上的工序日期。
操作人员的工时记录可以回写到 KARAT 吗？
可以，由您选择是否启用。KARAT 终端报工支持通过商定的接口导入数据，因此 SkyPlanner 工时记录可以按工序回写为开始、停止和数量事件。
KARAT 合作伙伴应推荐 APS KARAT 还是 SkyPlanner？
如果客户的计划经常变化，且必须基于实时数据运行，应推荐 SkyPlanner。APS KARAT 使用从生产系统导出的数据制定计划，计划员先建立多个方案，再选定一个回写（KARAT）。SkyPlanner 可自动重新排程，统筹换产、工具、班组和物料，用户数量不限，每月 199 € 起。
