Visma L7・APS連携ガイド 生産スケジューリングへの活用
このガイドでは、パートナーやITチーム向けに、Visma L7とSkyPlanner APSの接続方法を解説します。SkyPlannerは、Visma L7 REST APIを介してVisma L7と双方向に連携します。
- 製造番号（työnumero）、工程（työnvaihe）、リソース、製品構成、部品、材料、在庫残高、受注明細、発注明細を取り込みます。
PUT /manufphases/で、各作業カードにリソース、開始日、優先順位、担当者、日別の作業時間を書き戻します。POST /resourceupdates/で、リソースカレンダーの稼働能力を同期します。- L7の作業キューに登録された生産イベントを、
GET /manufevents/で読み取ります。 - SkyPlannerのWebhookで、スケジュールの変更を発生時に送信します。
SkyPlannerチームが導入支援の際にお客様のL7環境に合わせて連携を設定し、本稼働後もサポートします。パートナーや開発者は、仕様が公開されているSkyPlannerのREST APIを使って連携を開発することもできます（APIリファレンス）。
Visma L7のREST API
使用するAPIはVisma L7 – REST APIです。OpenAPI 3.0.3形式の仕様書と変更履歴が公開されています（ドキュメント）。このAPIはVisma LTR上で動作します。
- ベースパスは、お客様のLTRホスト上の
/ltrws/REST/L7です。オンプレミスでも、Vismaのホスティング型アプリケーションサービスでも同じです。 - ライセンス。エンドポイントごとに個別のライセンスが必要です。スケジュールの書き込みには
PUT /manufphases/用のL7RMFPPライセンス、稼働能力の更新にはL7RMCAPが必要です。読み取り用のエンドポイントにも、それぞれライセンスが必要です。 - ページング。一覧のページングには
pageSizeとrecAfterを使い、絞り込みにはqueryKey1、queryKey2、queryStringを使います。
認証
L7への呼び出しには、毎回二つのトークンを付けます。
- hashでデータベースと会社を選択します。
- tokenでAPIユーザーを識別します。
LTR管理者がVisma LTRでAPIユーザーを作成し、L7の会社に関連付け、プロファイルを付与してユーザートークンを作成します（利用開始手順）。連携専用のユーザーを用意し、連携に必要な権限だけを付与してください。
SkyPlanner側のREST APIは、Authorization-Tokenヘッダーで送信するAPIトークンで認証します。トークンは「Settings > API」で作成します。最初の呼び出し手順は、連携チュートリアルで説明しています。
変更の検出：modifiedAfter
L7 REST APIにはWebhookがありません。変更はポーリングで読み取ります。
- L7のファイル保守（Tiedostohuolto）で、作業カードや部品など、連携で読み取るテーブルの変更ログ（DBLOG）を有効にします。
modifiedAfterに前回の実行時刻を設定して、読み取り用エンドポイントを呼び出します。削除されたレコードには削除済みの印が付いて返されるため、キャンセルされた作業はスケジュールから除外されます。- 数分おきにポーリングします。SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻し側はイベント駆動で処理します。
データのマッピング
| Visma L7のオブジェクト（エンドポイント） | SkyPlannerのオブジェクト | 連携方向 | 連携頻度 |
|---|---|---|---|
Tuote（GET /products/） | 製品と資材 | L7 → SkyPlanner | 初回取り込み後、変更時に更新 |
製造番号に紐づく部品（GET /manufcomponents/） | 子製品 | L7 → SkyPlanner | modifiedAfterによるポーリング |
材料所要量（GET /manufmaterials/） | 作業ごとの材料所要量 | L7 → SkyPlanner | modifiedAfterによるポーリング |
設備台数を含むリソース（KRYH）ツリー（GET /manufresources/） | リソースとリソースグループ | L7 → SkyPlanner | 初回取り込み後の連携はまれ |
工程ごとの作業カード（TSUUNR）（GET /manufphases/） | リソースごとの作業（工程） | L7 → SkyPlanner | 数分おきにポーリング |
在庫残高（GET /stockbalances/） | 在庫 | L7 → SkyPlanner | ポーリング |
発注明細（GET /purchaserows/） | 納入日を含む発注 | L7 → SkyPlanner | ポーリング |
受注と受注明細（GET /salesorders/、GET /salesrows/） | 納期、顧客の優先順位 | L7 → SkyPlanner | ポーリング |
生産イベント（GET /manufevents/） | 作業ごとの進捗 | L7 → SkyPlanner | ポーリング |
作業カードのresource、startDate、priority、person、schedulingDays（PUT /manufphases/） | 計画上のリソース、開始日時、作業順序、日別の作業時間 | SkyPlanner → L7 | スケジュール変更時にSkyPlannerのWebhook経由で連携 |
リソースカレンダーの稼働能力（POST /resourceupdates/） | シフトの稼働能力 | SkyPlanner → L7 | シフト変更時 |
| SkyPlannerで設定するスケジューリングルール | 使用可能なリソース、段取り時間マトリクス、工具、作業者 | SkyPlannerで管理 | 導入支援時に設定 |
連携パターン
1. マスタデータの初回取り込み。リソースツリーを読み取り、各設備をSkyPlannerの個別のリソースに対応付けます。L7の一つのリソースに複数の設備が含まれる場合は、設備ごとにリソースを作成し、元のリソースに対応するリソースグループも作成します。製品と製品構成を、工程とともに読み取ります。
2. 製造番号の同期。GET /manufphases/で未完了の作業カードを読み取り、その後はmodifiedAfterで最新の状態に保ちます。製造番号ごとの部品と材料所要量に加え、在庫残高と発注明細も読み取り、各工程が対応する発注明細の納入日まで待機するようにします。
3. スケジュールの書き戻し。エンジンが配置または移動した工程ごとに、SkyPlannerがPUT /manufphases/を呼び出します。リクエストボディには、作業カードごとに一つのworkSheetエントリを含め、次の情報を指定します。
- 作業カードを示す
numberと、選択したリソースを示すresource - L7の作業キューにSkyPlannerの作業順序を反映するための
startDateとpriority - 特定の作業者を割り当てる場合は
person - 日付ごとの計画作業時間を示す
schedulingDays
L7は外部システムが設定した優先順位をそのまま保持するため（出典）、作業キューでもその順序が維持されます。
4. 稼働能力の同期。SkyPlannerでシフト、休日、残業の設定が変わると、POST /resourceupdates/で新しい稼働能力をL7のリソースカレンダーに書き込みます。これにより、L7の負荷表示が計画と一致します。
5. 製造現場の進捗。作業者は引き続きL7の作業キューとVisma LTRで実績を登録し、SkyPlannerはGET /manufevents/でそのイベントを読み取ります。SkyPlanner Mobile Confirmationsで作業実績を登録することもできます。Autopilotは、どちらで登録された情報に基づいても再計画を行い、次回の書き戻しで新しい時刻を反映します。
6. 管理主体と競合時のルール。本稼働前に、次の内容を文書化してください。
| データ | 管理主体 |
|---|---|
| 製品、製品構成、工程、数量、製造番号の状態 | Visma L7 |
| 工程の順序、開始日、日別の作業時間、リソースの選択 | SkyPlanner |
| 使用可能なリソース、段取り時間マトリクス、工具、作業者 | SkyPlanner |
| シフトと不在 | SkyPlanner（L7のリソースカレンダーに書き込み） |
| 生産イベントと在庫の実績登録 | Visma L7の作業キューとLTR |
競合の主な原因は、L7自体の計画機能です。所要量計算や詳細計画によって、ロックされていない工程が再配置されることがあります。これらの機能は材料と引当の処理にのみ使用し、SkyPlannerが管理する工程は再計画しないでください。
標準的な導入手順
通常、導入支援の開始から数週間で実装が完了します。その前に、製造番号、工程、リソースをExcelに出力すれば、自社データを使って30日間の無料トライアルを利用できます。
- 要件定義。マッピング表、管理主体のルール、ポーリング間隔を確定します。
- アクセス権とライセンス。対象のRESTエンドポイントのライセンスを取得します。LTR管理者がAPIユーザー、hash、tokenを作成します。まずテスト用の会社で作成するのが理想です。
- 変更ログ。読み取り対象のテーブルでDBLOGを有効にします。
- 初回取り込み。リソース、製品、製品構成、工程を取り込みます。
- 製造番号の同期。modifiedAfterによるポーリング、削除処理、ページングを実装します。
- SkyPlannerでの制約設定。使用可能なリソース、段取り時間マトリクス、工具、作業者を設定します。
- 書き戻し。テスト用の会社で
PUT /manufphases/とPOST /resourceupdates/をテストします。 - 並行稼働と本稼働。現行の計画と比較してマスタデータを修正し、本番環境で書き戻しを有効にします。
Visma L7連携で事前に検討すべきこと
- エンドポイントごとのライセンス。早い段階ですべてのエンドポイントを洗い出し、テスト前にライセンスを取得してください。
- 機械の台数。L7では、一つのリソースに複数の機械が含まれる場合、それらの機械に作業が分配されます（出典）。SkyPlannerでは機械ごとにリソースを分け、書き戻す際はL7が想定するリソースに対応させてください。
- 日別の時間。L7は計画を日付ごとの時間数として保存します。SkyPlannerは、合計が工程の所要時間と一致する
schedulingDaysを送信します。 - 工場カレンダー。設定に抜けがあると工程が過去の日付にずれるため、漏れなく設定してください（出典）。
- 在庫生産指図。
mainNumber、subNumber、rowNumber、newQuantityは、在庫生産指図の数量を変更する場合にのみ使用します。受注生産では含めないでください。 - 次のERPへの移行。VismaはL7の新規開発を終了しており、製品の利用も2028年末に終了します（Vismaからのお知らせ）。ERPの変更時に引き継げるよう、スケジューリングルールはL7のフィールドではなくSkyPlannerで管理してください。
Visma L7連携の設定とサポートの担当
連携作業では、貴社のリソース、作業工程、L7の設定に合わせてマッピングを行います。SkyPlannerで管理するスケジューリングルールも対象です。使用可能なリソース、段取り時間マトリクス、工具、作業者などを設定します。
- SkyPlannerチームが導入時に設定し、本稼働後もサポートします。L7の運用は工場ごとに異なります。その運用ノウハウを連携設定に反映します。
- 貴社のVismaパートナーも参加できます。パートナーは貴社のL7とLTRの設定を把握しており、APIユーザー、ライセンス、テスト用会社の準備を担当できます。SkyPlannerはREST API、Swagger/OpenAPIドキュメント、Webhookを提供します。
- 自社の開発者による拡張も可能です。同じ公開ドキュメントに沿って、APIトークンでREST APIを利用できます。APIトークンがあれば着手でき、必要に応じてSkyPlannerチームが支援します。
L7を置き換える際も、SkyPlannerの設定をそのまま使って新しいERPに接続できます。Business Central、Visma Net、Lemonsoft、Monitor ERP、Odooの各ページをご覧ください。
SkyPlannerは5リソース込みで月額199 €から利用でき、月ごとの請求となります。連携費用は、貴社の業務プロセスと要件に合わせて、ご利用プランとともに事前にお見積もりします。開始前に総費用を確認できます。
L7標準の計画機能との違いは、Visma L7は設備や人員の能力を考慮した生産スケジューリングに対応していますか？をご覧ください。連携の概要はVisma L7のページで、ほかのシステムとの連携はERP連携一覧で確認できます。
製造業のお客様によるSkyPlannerの評価
1,000件単位の製造指図を自動でスケジューリング
「生産をこれまでとは違う形で管理できるようになり、生産能力の把握もまったく別のレベルになりました。」
Hannu Ryynänen、CEO
Mamec · 産業用ミキサー、ポンプ、ハイテク製品の受託製造
数千件の製造指図を自動でスケジューリングし、組織全体で生産状況をリアルタイムに把握しています。
98%の納期遵守率。約50%から向上
「当社の納期遵守率を維持するうえで、SkyPlannerは決定的な役割を果たしています。」
Hannu Lahtinen、代表取締役
KJH-Comp · 板金加工と受託製造
納期遵守率は約50%から最高98%に向上しました。スケジューリングに必要な管理者も、二人から一人に減りました。
2時間を毎週削減
「SkyPlannerによって、当社の生産計画はExcelでの管理から、リアルタイムの生産最適化へと進化しました。」
Kalle Kalliomäki、サプライチェーン担当スペシャリスト
UTU · 配電盤と開閉装置
生産計画にかかる作業時間を毎週2時間削減でき、新しい作業キューも数秒でラインに届きます。
+90%の生産効率向上
「生産効率が90%向上しました。」
Abdul Rucyinga、IT部門責任者
Laboratory & Allied · 医薬品製造
生産効率が90%向上し、全リソースを対象とする三か月分の最適化された計画を30分未満で作成できます。
よくある質問
Visma L7には生産データ用のAPIがありますか？
はい。Visma LTR上のVisma L7 REST APIでは、作業工程、リソース、部品、材料、生産イベント、製品、在庫残高、販売明細、購買明細にアクセスできます。ライセンスはエンドポイントごとに必要で、LTR管理者がAPIユーザーとトークンを作成します。
スケジュールはどのようにVisma L7に書き戻されますか？
PUT /manufphases/で、各作業票のリソース、開始日、優先順位、担当者、日付ごとの計画時間を更新します。POST /resourceupdates/では、リソースカレンダーに稼働能力を書き込みます。L7は外部から設定された優先順位を保持するため、作業キューはSkyPlannerで決めた順序に従います。
Visma L7はWebhookに対応していますか？
Webhookについての記載はドキュメントにありません。対象テーブルの変更ログを有効にし、modifiedAfterでポーリングしてください。SkyPlanner自身のWebhookは、スケジュールが変更されるたびにその変更をプッシュ通知します。
Visma L7と連携できるスケジューリングソフトウェアは何ですか？
SkyPlanner APSはL7 REST APIを通じてVisma L7と双方向に連携します。VismaもL7連携のページにSkycodeとSkyPlannerを掲載しています。導入時の設定はSkyPlannerチームが担当します。
Visma L7連携は誰が構築しますか？
SkyPlannerチームが導入時に貴社のL7環境に合わせて双方向連携を設定し、本稼働後もサポートします。貴社のVismaパートナーや自社の開発者も、ドキュメントが公開されているSkyPlannerのREST APIを使って開発できます。APIトークンがあれば着手できます。
