Lemonsoft連携ガイド SkyPlanner APSで生産スケジューリング
このガイドでは、パートナー企業やITチームに向けて、Lemonsoft ERPとSkyPlanner APSの接続方法を解説します。SkyPlannerはLemonsoftのREST APIを通じて、次のように双方向でデータを連携します。
- 製造番号（työnumero）、工程（työvaihe）、機械、製品構成、資材、シフト計画を取り込みます。
- 開始・終了予定日時と選択した機械を、Lemonsoftの工程に書き戻します。
- 作業者が報告した実績を、完了データとして書き戻します。
- SkyPlannerのWebhookが、スケジュールの変更を発生時に通知します。
Kaskea Groupは、Lemonsoftとの双方向連携でSkyPlannerを運用しています。SkyPlannerチームは、導入支援の際にお客様のLemonsoft環境に合わせて連携を設定し、本稼働後もサポートします。パートナー企業や開発者が、ドキュメントの公開されているSkyPlannerのREST APIを使って連携を構築することもできます（APIリファレンス）。
LemonsoftのREST API
Lemonsoftの連携APIはLemonRestです。Swagger 2.0形式でドキュメントが公開されており、バージョンはv1です。ビルド「LemonRest 2026.10 release-2026.10.2」には422のパスが記載されています。（Swagger）
- ベースURLは環境ごとに異なります。ユーザー管理から環境管理、サービスアドレスへと進み、Rest APIフィールドで確認できます。LemonsoftのAzureプラットフォームでは、ベースURLは
https://rest.lemon.fiです。 - 利用条件。Lemonsoftのプラットフォームサービス（Alustapalvelu）をご利用のお客様にはREST APIがあらかじめインストールされているため、必要なのはユーザー権限の設定だけです。（出典）
- テスト環境。エンドユーザー企業がLemonsoft Service Deskに申し込みます。
別途提供されているKellokorttiの勤怠管理APIは、スケジューリングには不要です。
認証
LemonRestはセッションを使用します。
- UserName、Password、Database、ApiKeyを指定して
POST /api/auth/loginを呼び出すと、session_idが返されます。 - すべての呼び出しで、この値を
Session-Idヘッダーに含めて送信します。 - セッションの更新には
POST /api/auth/renewを使います。ヘルスチェックにはGET /api/auth/aliveを使います。
POST /api/auth/login/tokenは、ユーザー名とパスワードの代わりにTokenを受け取ります。APIキーを持つ連携専用ユーザーを作成し、連携に必要な権限だけを付与してください。（出典）
SkyPlanner側のREST APIは、APIトークン（SkyPlanner Settings > API）で認証します。ドキュメントはSwagger/OpenAPIで公開されています。最初のAPI呼び出しの手順は、連携チュートリアルで解説しています。
差分クエリによる変更検出
LemonRestには、Webhookやサブスクリプション用のエンドポイントはありません。変更は差分クエリで取得します。
GET /api/production/main_ws/changed?updated_after=...は、前回の実行以降に変更された作業を返します。optimization=trueを追加してください。このパラメータはリリース2026.6.3で追加され、ログへの依存をなくしてクエリを高速化します。（リリースノート）GET /api/log/deletion_eventsで削除された作業を検出し、キャンセルされた作業をスケジュールから除外します。
数分おきにポーリングしてください。SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻し側はイベント駆動で動作します。
データのマッピング
| Lemonsoftのオブジェクト（エンドポイント） | SkyPlannerのオブジェクト | 連携方向 | 連携頻度 |
|---|---|---|---|
Tuote、product_code（/api/products） | 製品と資材 | Lemonsoft → SkyPlanner | 初回取り込み後、変更時に連携 |
Työvaiheetの行を含むTuoterakenne（/api/products/structure、all_levels） | 製品構成、子製品、段取り時間を含む工程 | Lemonsoft → SkyPlanner | 初回取り込み後、変更時に連携 |
Kone、Koneryhmä（/api/production/machines、/api/settings/machine_groups） | リソース、リソースグループ | Lemonsoft → SkyPlanner | 初回取り込み後の連携はまれ |
ProductMainWorkStageとして扱うTyönumero（/api/production/workstage、main_ws/changed） | 納期と優先度を含むオーダー | Lemonsoft → SkyPlanner | 数分おきに差分をポーリング |
ProductSubWorkStageとして扱うTyövaihe（main_ws/sub_ws）：machine、setting_time、duration、work_amount_left | リソースごとの作業（工程） | Lemonsoft → SkyPlanner | 数分おきに差分をポーリング |
部品所要量（main_ws/{worknumber}/materials） | 作業ごとの資材所要量 | Lemonsoft → SkyPlanner | 各作業の連携時 |
シフト計画（/api/persons/plannedshifts） | シフト、要員 | Lemonsoft → SkyPlanner | 毎日連携、またはSkyPlannerでシフトを管理 |
製造番号に紐づく受注（/api/orders/work/{work_number}） | 顧客情報と優先度に関する情報 | Lemonsoft → SkyPlanner | 各作業の連携時 |
Työvaiheのstart_time、end_time、machine_id（PUT /api/production/workstage） | 開始・終了予定日時と割り当てリソース | SkyPlanner → Lemonsoft | スケジュール変更時にSkyPlannerのWebhook経由で連携 |
完了登録（POST main_ws/sub_ws/completion_entry） | 実績報告：良品数、不良品数、作業時間、作業者 | SkyPlanner → Lemonsoft | 実績報告の都度 |
| SkyPlannerで設定するスケジューリングルール | 作業ごとに使用可能なリソース、段取り時間マトリクス、工具 | SkyPlannerで管理 | 導入支援時に設定 |
連携パターン
1. マスタデータの初回取り込み。機械と機械グループ、工程を含む製品構成、標準工程を取得します。個々の実機をSkyPlannerのリソースに対応付けます。親機械（Isäkone）は子機械の能力を合算するため、グループ化にのみ使用してください。
2. 製造番号の同期。/api/production/workstageまたはmain_ws/sub_wsから、未完了の製造番号とその工程を取得します。状態で絞り込み、ページ単位で取得してください。その後はmain_ws/changedで最新の状態に保ちます。Lemonsoftは残数量を基準にスケジューリングするため、work_amountではなくwork_amount_leftをマッピングしてください。購買オーダーはSkyPlannerの資材に基づくスケジューリングに反映されるため、工程は購買オーダーの納入日まで待機します。
3. スケジュールの書き戻し。エンジンが配置または移動した各工程について、SkyPlannerは作業とそのsub_workstagesを含めてPUT /api/production/workstageを送信します。各工程にはstart_timeとend_timeを含め、代替機械へ移動した場合はmachine_idも含めます。
4. 製造現場からの実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業実績を報告します。報告の都度、sub_workstage_id、person_number、done_amount、hours、failed_amount、job_doneをcompletion_entryに送信します。工程で資材を消費する場合は、material_consumptionsも併せて送信してください。Lemonsoftでは通常の製造完了処理（valmistuskirjaus）として計上されます。
5. データの管理主体と競合時のルール。本稼働前に明文化してください。
| データ | 管理主体 |
|---|---|
| 製品、製品構成、工程、数量、作業の状態 | Lemonsoft |
| 工程順序、開始・終了日時、機械の選択 | SkyPlanner |
| 作業ごとに使用可能なリソース、段取り時間マトリクス、工具 | SkyPlanner |
| シフトと欠勤・休暇 | 要件定義で選定する一つのシステム |
| 製造完了と在庫の計上 | Lemonsoft。SkyPlannerからの実績報告に基づいて計上 |
競合の主な原因は、Lemonsoft独自の自動スケジューリングと更新操作です。どちらもロックされていない工程を再配置します。SkyPlannerがスケジュールを管理する間は、AUTOTIMINGを0にしてください。有効のまま運用する場合は、書き戻した製造番号ごとにスケジュールをロックします。これにより、その製造番号のすべての工程が固定されます。Koneiden kapasiteetin lukitusだけでは不十分です。自動スケジューリングは、ロックされていない作業を、ロックされた日から別の日へ移動するためです。（出典）
一般的な導入手順
通常、導入支援の開始から数週間で実装が完了します。その前に、製造番号、工程、機械をExcelにエクスポートし、自社データを使って30日間の無料トライアルを利用できます。
- 要件定義。マッピング表、データの管理主体に関するルール、ポーリング間隔を確定します。
- アクセスの準備。エンドユーザー企業がLemonsoft Service Deskにテスト環境を申し込み、連携用ユーザーとAPIキーを作成します。
- 初回取り込み。機械、グループ、製品構成、工程を取り込みます。
- 製造番号の同期。差分ポーリング、削除イベントの取得、セッションの更新を行います。
- SkyPlannerでの制約設定。作業ごとに使用できるリソース、段取り時間マトリクス、工具を設定します。
- 書き戻し。工程の予定時刻と完了実績の登録をテスト環境で検証します。
- 並行運用と本稼働。現在のガントチャートと比較し、マスタデータを修正したうえで、本番環境での書き戻しを有効にします。
Lemonsoft連携で事前に検討すべきこと
- 一工程につき機械は一台。Lemonsoftの各工程には、一台の機械が登録されます。製品ごとに使用できる機械は、導入時にリストまたは製品属性から設定します。SkyPlannerはその候補の中から機械を選びます。
- 日単位の能力。固定能力は一日あたりの量で表され、通常との差分にも時刻情報はありません。実際のシフトをSkyPlannerで設定するか、計画済みのシフトを読み込んでください。
- 残数量。
work_amount_leftをマッピングします。STARTJOB_AUTOTIMENOWとJOBDONE_AUTOTIMENOWの設定は、Lemonsoft側の負荷の配置にも影響します。 - セッションの有効期限。長時間の同期前にはセッションを更新し、再ログインを強制される場合にも対応してください。
- 実績登録のルール。送信前に各実績が工程の状態と整合しているか検証し、呼び出しが集中する場合は送信間隔を調整してください。
- 二つのクライアント。LemonOnlineとWindows版は一つのデータベースを共有しているため、どちらにも同じ連携を利用できます。
- 大規模な製品構成。大量のデータを取り込む場合は、
/api/async/product/structureと/api/async/status/{jobId}を組み合わせて使用します。
Lemonsoft連携の設定とサポートの担当
設定作業には、お客様の機械、作業工程、Lemonsoftの構成に合わせたマッピングが含まれます。SkyPlanner側で管理するスケジューリングルールも対象です。具体的には、作業ごとに使用できるリソース、段取り時間マトリクス、工具を設定します。
- SkyPlannerチームが導入時に設定し、本稼働後もサポートします。工場ごとにLemonsoftの運用は異なります。その運用ノウハウを連携の設定に反映します。
- お客様のLemonsoftパートナーも参加できます。パートナーはお客様の構成を把握しており、APIユーザー、権限、テスト環境の準備を担当できます。SkyPlannerはREST API、Swagger/OpenAPIドキュメント、Webhookを提供します。
- 社内の開発者による追加開発も可能です。ドキュメントが公開されている同じREST APIに、APIトークンでアクセスできます。APIトークンがあれば開発を始められ、必要に応じてSkyPlannerチームが支援します。
接続後は、ArcturusエンジンがLemonsoftの最新の作業番号データを基にスケジュールを作成し、予定時刻を各作業工程に反映します。SkyPlannerは5リソースを含めて月額199 €から利用でき、請求は月単位です。連携費用はお客様の工程と要件に合わせて、利用プランとともに事前にお見積もりします。開始前に総費用を確認できます。
Lemonsoft標準の計画機能との違いは、Lemonsoftの生産スケジューリングでご確認ください。機械や人員の実際の能力を考慮したスケジューリングについて説明しています。概要はLemonsoftのページ、他のシステムとの連携はERP連携一覧をご覧ください。
製造業のお客様によるSkyPlannerの評価
LemonsoftSkyPlannerとの双方向連携
Kaskea Group
受託製造：CNC加工、鋼構造物、組立
Lemonsoftと双方向に連携し、SkyPlannerで生産計画を立てています。
削減材料不足による生産停止
「SkyPlannerの価値は、日々の業務で実際に役立つツールであることです。特に納期の設定で力を発揮しています。」
Tommi Männistö、生産計画責任者
Eskomatic · 受託機械加工
負荷の自動スケジューリングで納期の精度が向上し、材料不足による生産停止も大幅に減少しました。
2時間毎週の作業時間を短縮
「SkyPlannerによって、当社の生産計画はExcelの表計算からリアルタイムの生産最適化へと変わりました。」
Kalle Kalliomäki、サプライチェーン担当スペシャリスト
UTU · 配電盤・開閉装置
生産計画にかかる作業時間を毎週2時間短縮し、新しい作業順序も数秒で製造ラインに届くようになりました。
+90%生産効率の向上
「生産効率が90%向上しました。」
Abdul Rucyinga、IT部門責任者
Laboratory & Allied · 医薬品製造
生産効率が90%向上し、全リソースを対象とする三か月分の最適化された計画を30分未満で作成できるようになりました。
よくある質問
Lemonsoftには生産データ用のAPIがありますか？
はい。LemonRestでは、生産作業と作業工程、機械、製品構成、材料、シフトへのアクセスと、完了実績の登録が可能です。Alustapalveluのお客様にはあらかじめインストールされています。利用にはAPIキーとユーザー権限が必要です。
LemonsoftはWebhookに対応していますか？
LemonRestにはWebhookのエンドポイントは記載されていません。変更は数分ごとのポーリングで、main_ws/changedの差分クエリと削除イベントから取得します。SkyPlanner側のWebhookは、スケジュールの変更が発生するたびに通知を送信します。
予定時刻はどのようにLemonsoftへ書き戻されますか？
PUT /api/production/workstageを使い、作業とその作業工程の開始時刻、終了時刻、機械を更新します。SkyPlannerでスケジュールを管理している間は、Lemonsoftの自動スケジューリングを無効にするか、書き戻した作業番号ごとにスケジュールをロックしてください。これにより、SkyPlannerが設定した時刻が維持されます。
SkyPlannerで作業者が入力した実績をLemonsoftに登録できますか？
はい。各実績は、完了数量、不良数量、作業時間、担当者を含む完了実績として登録されます。お客様の現場で日常的に運用されています。
Lemonsoft連携は誰が構築しますか？
SkyPlannerチームが導入時に、お客様のLemonsoftの構成に合わせて双方向連携を設定し、本稼働後もサポートします。お客様のLemonsoftパートナーや社内の開発者も、ドキュメントが公開されているSkyPlannerのREST APIを使って開発できます。APIトークンがあれば開始できます。
