HELIOS連携ガイド SkyPlanner APSで生産スケジューリング
このガイドでは、パートナーとIT部門向けに、HELIOS iNuvioおよびHELIOS NephriteをSkyPlanner APSに接続する方法を説明します。SkyPlannerはHELIOSのインターフェースを使い、次のように双方向で連携します。
- 製造指図（výrobní příkazy）とその工程、製造部品、BOM、工順、作業場、機械、職種、要員リソース、在庫、購買発注を取り込みます。
- 開始予定日時と終了予定日時を製造指図に書き戻します。
- 必要に応じて、作業者の作業時間ログを工程実績（evidence výrobních operací）として書き戻すこともできます。
- SkyPlannerのWebhookが、スケジュールの変更を発生時に通知します。
SkyPlannerチームが導入支援の段階でお客様のHELIOS環境に合わせて連携を設定し、本稼働後もサポートします。このガイドは、連携に参加するHELIOSパートナーや開発者、または公開ドキュメントのあるSkyPlannerのREST API（APIリファレンス）を使って独自に開発する方を対象としています。
HELIOSの連携インターフェース
Helios Inuvio Server（Inuvio REST API）。Assecoはこれを、HELIOS iNuvioの業務データにREST APIでアクセスするための独立したコンポーネントと説明しています（Helios Inuvio Serverのヘルプ）。iNuvioの配布パッケージに含まれており、OpenAPI仕様はRapidoc形式とRedoc形式で公開されています。このAPIは、それぞれ固有のIDと権限を持つHELIOSの一覧画面（browse）を対象に動作します。
- GET /browses/listとGET /browses/metaで、利用可能な一覧画面とその列を取得します。
- /browses/dataで一覧画面の行を読み取ります。作成・更新・削除が許可された一覧画面では、行の書き込みも行えます。
- /api/v1/actions/metaと/api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent}で、一覧画面の外部アクションを実行します。現在対応している外部アクションの種類は、Procedure、Browse、Pluginです。
スケジューリングに使用する生産関連の一覧画面には、生産計画（výrobní plán）、製造指図（výrobní příkazy）、製造指図の部品、生産用の資材と半製品、職種、要員リソース、工順の工程プリセット、工程実績があります。在庫、入庫、出庫、発行済み購買発注（vydané objednávky）も同じ方法で取得できます。
HELIOS Nephrite REST API。NephriteのロードマップにはREST APIの開発が記載されています（HELIOS Nephriteのロードマップ）。SkyPlannerチームは要件定義の段階で、お客様およびHELIOSパートナーとともに、導入環境で使うNephriteのエンドポイントを確認します。以下に示すデータの流れは変わりません。
ExcelとCSV。HELIOSのすべての一覧画面はMicrosoft Office向けにエクスポートできるため、試用時のデータ取り込みにはこれで対応できます。
認証とライセンス
- 二つの認証方式。iNuvioには、従来の独自認証API（/api/token）と、RFC 6749に基づく新しいOAuth2 API（/oauth/token、/oauth/revoke）があります。トークンはPOST /oauth/tokenまたはGET /api/tokenで更新します。
- ライセンス。Helios Inuvio Server自体は無料ですが、REST APIにはライセンスが必要です。バージョン3.0.2026.0301から、システムAPIと業務APIは一つのInuvio REST APIに統合され、ユーザー数によるAPIアクセスの制限はなくなりました。
- 権限。連携用ユーザーには、生産と在庫の一覧画面に対する読み取り権限と、合意した外部アクションを実行する権限が必要です。
SkyPlanner側のREST APIは、Authorization-Tokenヘッダーに指定するAPIトークンで認証します（SkyPlanner Settings > API）。仕様はSwagger/OpenAPIで公開しています。最初の呼び出し手順は、連携チュートリアルで説明しています。
イベントとポーリング
SkyPlannerは定期的にHELIOSからデータを読み取ります。未完了の製造指図と直近の変更に絞って/browses/dataを呼び出し、新しい作業を取得します。取得頻度は工場ごとに設定し、製造指図は数分ごと、在庫は毎時といった間隔で取り込みます。
SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻し側はイベント駆動で動作します。
データマッピング
| HELIOSのオブジェクト（一覧画面） | SkyPlannerオブジェクト | 方向 | 頻度 |
|---|---|---|---|
| 品目カードと製造部品（vyráběné dílce）、単位 | 製品と材料 | HELIOS → SkyPlanner | 初回取り込み後、ポーリング |
| 有効期間を持つBOM（kusovník、kusovníkové vazby） | 製品構成、子製品、製品ごとの資材 | HELIOS → SkyPlanner | 初期取り込み後は変更時 |
| 工順（technologický postup）：工程、作業場、機械と作業者の準備時間、単位当たり時間、後処理時間、工程間時間 | 各工程とその所要時間、段取り時間、後片付け時間 | HELIOS → SkyPlanner | 初期取り込み後は変更時 |
| 作業場（pracoviště）、機械（stroje）、代替作業場 | リソース、リソースグループ、代替リソース | HELIOS → SkyPlanner | 初期取り込み後の更新はまれ |
| 職種（výrobní profese）、要員リソース（výrobní personální zdroje） | 要員、作業ごとの作業者数 | HELIOS → SkyPlanner | 初回取り込み後、変更時 |
| 計画カレンダー（plánovací kalendáře） | シフトと非稼働日 | HELIOS → SkyPlanner | 毎日、またはSkyPlannerで独自のシフトを管理 |
| 製造指図（výrobní příkazy）、指図の部品と工程、生産用資材 | 納期と資材所要量を持つオーダーと作業 | HELIOS → SkyPlanner | 数分ごとにポーリング |
| 在庫（stav skladu） | 在庫残高 | HELIOS → SkyPlanner | 毎時またはスケジューリング実行時にポーリング |
| 納入日を持つ発行済み購買発注（vydané objednávky） | 購買発注、納入日別の入荷予定資材 | HELIOS → SkyPlanner | 毎時またはスケジューリング実行時にポーリング |
| 製造指図の工程ごとの開始・終了予定日時（外部アクション） | 作業ごとの開始・終了予定日時 | SkyPlanner → HELIOS | スケジュール変更時にSkyPlannerのWebhook経由で反映 |
| 工程実績（evidence výrobních operací） | 作業時間ログと作業者による実績報告 | SkyPlanner → HELIOS | 書き戻しを選択した場合、実績報告ごとまたはシフトごと |
| HELIOSにはなし | 段取り時間マトリクス、数量に制約のあるリソースとしての工具、複数の作業者が担当する作業 | SkyPlannerで管理 | 導入支援時に設定 |
連携パターン
1. マスタデータの初回取り込み。TPVの一覧画面から、製造部品、BOM、工順、作業場、機械、職種、要員リソース、カレンダーを読み取ります。HELIOSの各リソースには生産能力計画の対象に含めるためのフラグがあるため、SkyPlannerでスケジューリングする対象をリソースごとに決めます。機械が四台ある作業場は、一つのリソースグループ、または四つのリソースとして扱います。
2. オーダーの同期。製造指図とその部品、工程、資材に加え、発行済み購買発注を読み取ります。SkyPlannerは発注済み資材を購買発注の納入日から使用可能とみなし、購買発注がDeliveredになると在庫を更新します。リリース済みの製造指図をスケジューリングの対象にします。生産計画の計画数量は、製造指図になるまではHELIOS側に保持します。
3. スケジュールの書き戻し。エンジンが作業を配置または移動すると、SkyPlannerのWebhookを起点に、/api/v1/actions/execute経由で製造指図の一覧画面の外部アクションが実行されます。このアクションは要件定義で合意したHELIOSのプロシージャで、指図の工程の開始・終了予定日時を設定します。HELIOSは自身のロジックで変更を検証します。
4. 製造現場での実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録し、その作業時間ログによってスケジュールが最新に保たれます。実績時間をHELIOSに書き戻すかどうかは選択できます。書き戻す場合は、外部アクションで指図の工程ごとに工程実績として記録します。書き戻さない場合は、作業者が引き続きHELIOS端末で報告し、SkyPlannerがその実績を読み取ります。
5. データの管理主体と競合時のルール。 本稼働前に明文化してください。
| データ | 管理主体 |
|---|---|
| 品目、BOM、工順、数量、オーダーのステータス | HELIOS |
| 工程の実行順序、開始時刻と終了時刻、機械の割り当て | SkyPlanner |
| 段取り時間マトリクス、必要な工具と作業者の条件、代替リソース | SkyPlanner |
| シフトと非稼働日 | 要件定義で選定する一つのシステム |
| 工程実績、資材の出庫と入庫 | HELIOS。直接入力するか、SkyPlannerの作業時間ログから反映 |
オーダーの日付を書き込むシステムは一つに決めてください。HELIOSの生産能力計画やNephrite APSが引き続き日付を書き込んでいる場合、SkyPlannerでスケジューリングするオーダーではその書き込みを無効にするか、HELIOS側の計画をテスト用途のみに限定してください。
一般的な導入手順
通常、導入支援の開始から数週間で実装が完了します。その前に、HELIOSから作業場、工順、未完了の製造指図をCSVまたはExcelでエクスポートし、30日間の無料トライアルでスケジュールを検証してください。
- マッピング。マッピング表、データの管理責任、同期頻度、工程実績を書き戻すかどうかを確定します。
- HELIOSへのアクセス。Helios Inuvio Server、連携用ユーザー、OAuth2の認証情報、REST APIのライセンスを設定します。まずコピーしたデータベースでテストしてください。
- 初回取り込み。製造部品、BOM、工順、作業場、機械、職種、カレンダーを取り込みます。
- オーダーと購買発注の同期。フィルター、ページング、リトライを使ってポーリングします。
- SkyPlannerでの制約設定。段取り時間マトリクス、工具、作業ごとの必要人数、代替の機械や人員を設定します。
- スケジュールの書き戻し。予定日時と、書き戻しを選択した場合は工程実績の外部アクションを作成してテストします。
- 並行テスト。現在の計画と並行してSkyPlannerを動かし、日付を比較してマスタデータを修正します。
- 本稼働。 データの整合性を確認できたら、書き戻しを有効にします。
HELIOS連携で事前に確認すべきこと
- 計画対象フラグ。信頼できる能力データがあるのは、生産能力計画の対象フラグが設定されたリソースだけです。初回取り込みの前に、作業場、機械、職種、外注のフラグを確認してください。
- 時間の単位。準備時間、単位当たり時間、後処理時間は、時間・分・秒のいずれでも入力できます。取り込み時に単位を換算しないと、すべての所要時間が誤った値になります。
- 工程間時間。固定の工程間時間は、設備の稼働時間ではなく、工程と工程の間の待ち時間です。生産能力を消費する時間ではなく、待ち時間としてモデル化します。
- 外注工程（kooperace）。搬出時と返送時の両方に輸送時間がかかります。外注工程は、時間のみを持つ工程としてモデル化します。
- 書き込み可能な一覧。すべての一覧で読み取りが可能ですが、作成・更新・削除に対応しているのは一部のみです。GET /browses/list にフィルター browseCreateImplemented=1 を指定すると、対応する一覧を確認できます。製造指図の一覧は読み取り専用のため、計画日時は合意済みの外部アクションを通じて書き戻します。
HELIOS連携の設定とサポートの担当
- SkyPlannerチームが導入時の設定と稼働開始後のサポートを担当します。対象は、合意した一覧と外部アクションです。HELIOSの運用方法は工場ごとに異なるため、そのノウハウをここに反映します。
- お客様のHELIOSパートナーも参加できます。パートナーはお客様の導入環境、カスタムプロシージャ、ライセンスを把握しており、SkyPlannerチームとともにHelios Inuvio Serverや外部アクションを設定できます。
- 自社の開発者による追加開発も可能です。APIトークンを使ってSkyPlannerのREST APIに接続します。APIトークンがあれば開発を始められ、必要に応じてSkyPlannerチームが支援します。技術資料はSkyPlanner連携ドキュメントをご覧ください。
SkyPlannerは月額199 €から利用でき、5リソースが含まれます。請求は月単位です。連携費用は、お客様の業務プロセスと要件に合わせて、ご利用プランとともに事前にお見積もりします。料金、機械や作業者の実際の能力内で計画を組むHELIOSの生産スケジューリング、HELIOSのページ、ERP連携の総合ページをご覧ください。スケジューリングの基本については、生産スケジューリングをご覧ください。
製造業のお客様によるSkyPlannerの評価
2時間を毎週削減
「SkyPlannerによって、私たちの生産計画はExcelの表計算から、リアルタイムでの生産最適化へと変わりました。」
Kalle Kalliomäki、サプライチェーンスペシャリスト
UTU · 配電盤・開閉装置
生産計画にかかる作業時間を毎週2時間削減し、新しい作業キューも数秒で製造ラインに届くようになりました。
+90%生産効率の向上
「生産効率が90%向上しました。」
Abdul Rucyinga、IT部門責任者
Laboratory & Allied · 医薬品製造
生産効率が90%向上し、全リソースを対象とする三か月分の最適化された計画を30分未満で作成できるようになりました。
1,000件単位の製造指図を自動でスケジューリング
「これまでとは違う形で生産を管理できるようになり、生産能力の把握もまったく別のレベルになりました。」
Hannu Ryynänen、最高経営責任者
Mamec · 産業用ミキサー、ポンプ、ハイテク製品の受託製造
数千件の製造指図を自動でスケジューリングし、組織全体で生産状況をリアルタイムに把握しています。
100%2021年以降の納期遵守率
「SkyPlannerによって生産能力が見えるようになり、見通しを持って計画を立てられるようになりました。」
Dan Berglund、COO/CFO
Opes Corporation · 化学品・食品製造
SkyPlannerの利用を開始した2021年から現在まで、納期遵守率100%を維持しています。
よくある質問
HELIOSには製造指図用のAPIがありますか？
はい。Helios Inuvio Serverを使うと、生産計画、製造指図、指図の部品、生産用資材、工程記録など、HELIOS iNuvioの一覧にRESTでアクセスできます。HELIOS Nephriteについては、導入時の要件定義で、SkyPlannerチームがお客様およびHELIOSパートナーとともに導入環境に合った接続方法を決めます。
SkyPlannerはHELIOSの変更をどのように取得しますか？
SkyPlannerは工場ごとに設定した間隔でHELIOSの一覧をポーリングし、未完了の製造指図と直近の変更に絞って取得します。SkyPlanner側のスケジュール変更は、変更が発生するたびに独自のWebhookで送信します。
計画日時はどのようにHELIOSへ書き戻されますか？
製造指図の一覧にある外部アクションを、/api/v1/actions/execute で実行して書き戻します。このアクションは要件定義で合意したHELIOSのプロシージャであり、受信したすべての日時にHELIOS側のロジックが適用されます。
Inuvio REST APIはどの認証方式を使いますか？
/oauth/token でRFC 6749に準拠したOAuth2を使うか、従来の独自方式である /api/token を使います。SkyPlanner独自のAPIでは、Authorization-TokenヘッダーにAPIトークンを指定します。
HELIOSパートナーはHELIOS APSとSkyPlannerのどちらを提案すべきですか？
お客様の計画が頻繁に変わり、実際の生産能力の範囲内で計画する必要がある場合は、SkyPlannerです。HELIOSの計画機能は、有効な一つの計画を対象に計算を実行します。期日に合わせるために生産能力を無制限に切り替えることができ、重複の解消は計画担当者に委ねられます（HELIOSヘルプ）。SkyPlannerはREST APIで接続し、自動で再計画を行い、段取り替え、工具、作業班、資材を計画に組み込みます。ユーザー数は無制限で、月額199 €から利用できます。
