Katana連携ガイド SkyPlanner APSで生産スケジューリングを行うために
このガイドでは、コンサルタントやITチームに向けて、Katana Cloud Inventory (Katana MRP)をSkyPlanner APSに接続する方法を解説します。SkyPlannerは、公開されているKatana APIを介してKatanaと双方向に連携します。
- 製造指図、工程行、製品レシピ、製造工程、リソース、在庫、購買発注をSkyPlannerに取り込みます。
- スケジュール上の実行順序をKatanaのScheduleタブに書き戻し、各製造指図に生産期限を設定します。
- 工程のステータスと実績時間を工程行に書き戻します。
- KatanaのWebhookで変更を受け取り、SkyPlannerのWebhookでスケジュールの変更を発生時に送信します。
SkyPlannerチームが導入時にお客様のKatana環境に合わせて連携を設定し、本稼働後もサポートします。このガイドは、連携の構築に参加するコンサルタントや開発者、またはSkyPlannerのドキュメント化されたREST API（APIリファレンス）を使って独自に開発する方を対象としています。
Katana API
Katanaは単一のマルチテナント型クラウド製品のため、すべてのお客様が同じAPIを利用します。REST APIのバージョンはv1で、接続先はhttps://api.katanamrp.com/v1です。OpenAPI 3.0仕様はhttps://api.katanamrp.com/v1/openapi.jsonで公開されています。ドキュメントはKatana Developer Hubにあります。
スケジューラで使用するエンドポイントは以下のとおりです。
- マスタデータ：
/products,/materials,/variants,/recipe_rows,/bom_rows,/product_operation_rows。 - 指図：
/manufacturing_orders,/manufacturing_order_operation_rows,/manufacturing_order_recipe_rows,/manufacturing_order_productions。 - 実行順序：
/manufacturing_order_rerank。 - 需給：
/inventory,/purchase_orders,/purchase_order_rows,/sales_orders,/sales_order_rows。
/resourcesエンドポイントはありません。リソースは、製品の工程行および製造指図の工程行にあるresource_idとresource_nameで表されます。
認証と利用上限
認証には、APIキーをBearerトークンとして使用します：Authorization: Bearer <api key>。キーはSettings > API > Add new API keyで作成します。（出典）
同期処理は、以下の制限を踏まえて設計します。
- Katana APIでは、デフォルトで60秒あたり60件のリクエストが許可されています（出典）
- 制限を超えると、APIは
Retry-Afterを伴う429を返します。残りのリクエスト数はX-Ratelimit-Remainingで確認できます。 - 一覧取得用のエンドポイントはページネーションと更新日時によるフィルタリングに対応しているため、差分データを小さく抑えられます。
SkyPlanner側のREST APIはAPIトークン（SkyPlanner Settings > API）で認証し、仕様はSwagger/OpenAPIで公開されています。初回の呼び出し手順は連携チュートリアルで解説しています。
Webhook
HTTPSのURLと必要なイベントを指定し、POST /webhooksでWebhookを登録します。（出典）スケジューリングに役立つイベントは以下のとおりです。
manufacturing_order.created,.updated,.deleted,.in_progress,.blocked,.donemanufacturing_order_operation_row.created,.updated,.in_progress,.paused,.completedcurrent_inventory.material_updated,.material_out_of_stockpurchase_order.*およびpurchase_order_row.*（入荷済みを含む）product.*、product_recipe_row.*およびsales_order.*
ペイロードはリソース種別、アクション、hrefのみの軽量な構成です。受信側はhrefからオブジェクト全体を取得します。各配信には、検証用のx-sha2-signatureヘッダー（HMAC SHA-256）が付与されます。受信エンドポイントは10秒以内に20Xを返す必要があります。Katanaは30秒後、2分後、15分後の三回、再試行します。
データマッピング
| Katanaのオブジェクト（エンドポイント） | SkyPlannerのオブジェクト | 連携方向 | 連携頻度 |
|---|---|---|---|
製品、資材、バリアント（/products, /materials, /variants） | 製品と資材 | Katana → SkyPlanner | 初回取り込み時、以後はWebhook受信時 |
製品レシピ / BOM（/recipe_rows, /bom_rows） | 製品構成、子製品 | Katana → SkyPlanner | 初回取り込み時、以後はWebhook受信時 |
製造工程（/product_operation_rows）：種別、リソース、時間 | 所要時間と段取り時間を含む工程 | Katana → SkyPlanner | 初回取り込み時、以後は変更時 |
リソース（工程行のresource_id、resource_name） | リソース、リソースグループ | Katana → SkyPlanner | 初回取り込み時、およびリソース追加時 |
工程行を含む製造指図（/manufacturing_orders, /manufacturing_order_operation_rows） | 指図と作業 | Katana → SkyPlanner | Webhookでリアルタイムに同期 |
製造指図の構成資材（/manufacturing_order_recipe_rows） | 作業ごとの資材 | Katana → SkyPlanner | Webhookでリアルタイムに同期 |
在庫、入荷日を含む購買発注（/inventory, /purchase_order_rows） | 在庫と入荷予定資材 | Katana → SkyPlanner | Webhookでリアルタイムに同期 |
受注のdelivery_date（/sales_orders） | 指図の納期、顧客の優先度 | Katana → SkyPlanner | Webhookでリアルタイムに同期 |
製造指図の実行順序（POST /manufacturing_order_rerank） | 未完了の製造指図のスケジュール上の順序 | SkyPlanner → Katana | スケジュール変更時 |
製造指図のproduction_deadline_date（PATCH /manufacturing_orders/{id}） | 完了予定日時 | SkyPlanner → Katana | スケジュール変更時 |
工程行のstatus、total_actual_time（PATCH /manufacturing_order_operation_rows/{id}） | Mobile Confirmations、時間記録 | SkyPlanner → Katana | 作業実績の記録時 |
| Katanaには該当データなし | シフト、不在、段取り時間マトリクス、工具、作業者数、代替リソース | SkyPlannerで管理 | 導入時に設定 |
連携パターン
1. マスタデータの初回取り込み。レート制限を超えないようにリクエストを調整しながら、製品、資材、バリアント、レシピ行、製品の工程行をページごとに取得します。工程行に含まれるリソースを重複なく抽出してSkyPlannerのリソースを作成し、キーを1:1で対応付けます。Katanaにはリソースカレンダーがないため、SkyPlannerでリソースごとにシフト、休暇、残業を設定します。
2. 指図の同期。製造指図、工程行、在庫、購買発注のイベントを購読します。イベントを受信するたびにhrefからオブジェクトを取得し、作業を更新します。SkyPlannerは発注済み資材を購買発注の納入日に利用可能として扱い、入荷時に在庫を更新します。毎晩、更新日時フィルターを使って照合し、受信漏れのあったイベントを補完します。
3. スケジュールの書き戻し。二つのAPI呼び出しで計画をKatanaに反映します。
- POST
/manufacturing_order_rerankは、”moves one or more manufacturing orders to an exact place in the production schedule”（一件以上の製造指図を生産スケジュール内の指定位置に移動します）。リクエストごとに最大250件の未完了の製造指図を、先頭、末尾、または指定した製造指図の前後に配置できます。（出典） - PATCH
/manufacturing_orders/{id}でproduction_deadline_dateを設定します。Katanaがこの更新を受け付けるのは、対象の工場拠点で期限の自動計算が無効になっている場合のみです。（出典）
並べ替えの影響は、一覧の表示順だけにとどまりません。Katanaでは、”higher-priority MOs reserve required materials and subassemblies first”（優先度の高い製造指図から先に、必要な資材とサブアセンブリが引き当てられます）。そのため、SkyPlannerで決めた順序は、Katanaでどの製造指図に在庫を引き当てるかも左右します。
4. 製造現場での実績報告。作業者はSkyPlanner Mobile Confirmations、Production Timer、Quick Log Modeのいずれかで作業実績を記録します。SkyPlannerはステータスと実績時間を製造指図の工程行に書き込みます。工場でKatana Shop Floor Appを引き続き使用する場合は、代わりにSkyPlannerが工程行のイベントを読み取ります。工場ごとに報告経路を一つに統一してください。
5. データの管理主体と競合時のルール。本稼働前に、以下を明文化してください。
| データ | 管理主体 |
|---|---|
| 製品、レシピ、製造工程、在庫、購買、受注 | Katana |
| 工程の実行順序、開始・終了日時、工程ごとのリソース | SkyPlanner |
| Scheduleタブでの製造指図の順位と生産期限 | SkyPlannerで管理し、Katanaに書き戻し |
| シフト、不在、段取り時間マトリクス、工具、代替リソース | SkyPlanner |
| 工程のステータスと記録済み時間 | 要件定義で決めた一つの経路 |
一般的な導入手順
導入は通常、オンボーディング開始から数週間で完了します。その前に、KatanaからCSV形式でエクスポートした自社データを使って、30日間の無料トライアルを実施します。Make画面のTasksリストなどを利用できます。
導入プロジェクトは、次の手順で進めます。
- プランの確認とキーの作成。 Katanaの契約プランにAPIとManufacturing Managementが含まれていることを確認し、APIキーを作成します。
- 納期モード。 生産納期をSkyPlannerで管理するため、対象の工場拠点で納期の自動設定をオフにすることに合意します。
- マッピング。 マッピング表、リソースキー、データの管理主体に関するルール、実績報告の経路を確定します。
- 初期データの取り込み。 製品、バリエーション、レシピ、生産工程、リソースを取り込みます。
- イベント同期。 オーダー、工程、在庫、発注のWebhookを設定し、毎晩データを照合します。
- SkyPlannerでの制約設定。 シフト、段取り時間マトリクス、工具、作業者数、代替リソースを設定します。
- 書き戻し。 まず並べ替えと納期を反映し、次に工程のステータスと時間を書き戻します。
- 並行テストと本稼働。 SkyPlannerの日程を現在のScheduleタブと比較し、マスタデータを修正してから書き戻しを有効にします。
Katana連携で事前に検討すべき点
- 納期モードによる日付の上書き。 “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.”（自動モードを有効にすると、手動で設定した納期はすべて上書きされ、復元できません。）モードはキックオフ時に決定し、以後は変更しないようにします。
- リソースカレンダーがない。 Weekly throughputの単一の値からシフトを算出しないでください。SkyPlannerでリソースごとに設定します。
- リソースは工程行にのみ存在。 Katanaのリソース名はSkyPlannerのリソースと対応付けるキーになるため、変更せずに維持してください。
- 時間の単位。
planned_time_parameterの単位は秒です。per-unit型の工程では単位当たりの時間を、process、setup、fixed型では合計時間を表します。型を正しく対応付けないと、所要時間が数量倍になったり、数量で割った値になったりします。 - 受注生産のグループ。 並べ替え時には、同じ販売オーダーに紐づく製造オーダー（MO）がまとまって移動するため、グループ単位で順序を設定します。
- 並べ替えの動作変更。 2026年10月7日以降、rerankエンドポイントは指定された位置どおりにオーダーを配置します。以前の動作を前提に実装した連携は、再テストが必要です。（出典）
Katana連携の設定とサポートの担当
連携作業では、貴社のリソース、生産工程、オーダーの流れ、納期モードを扱います。さらに、Katanaでは保持していないシフト、段取り時間マトリクス、工具、作業者数、代替リソースを追加します。
- SkyPlannerチームがオンボーディング中に設定し、本稼働後もサポートします。 Katanaでのリソースや工程の設定は工場ごとに異なります。その違いに対応するノウハウを、この設定に活かします。
- 貴社のKatanaコンサルタントや連携パートナーによる構築も可能です。 SkyPlannerはREST API、Swagger/OpenAPIのドキュメント、Webhookを提供します。
- 貴社の開発者も、APIトークンを使って連携を開発できます。 APIトークンがあれば着手でき、必要に応じてSkyPlannerチームが支援します。発注や製品・資材APIを含む製品ドキュメントは、SkyPlannerドキュメントで確認できます。
SkyPlannerは5リソースを含み、月額199 €から利用できます。請求は月単位です。連携費用は、貴社の業務プロセスと要件に合わせて、利用プランとともに事前にお見積もりします。開始前に総費用を確認できます。料金と機能をご覧ください。Katana標準のスケジューリング機能との比較は、Katanaの生産スケジューリングで紹介しています。概要はKatanaのページ、他のERPとの連携はERP連携一覧をご覧ください。
製造業のお客様によるSkyPlannerの評価
2時間毎週の作業時間を削減
「SkyPlannerによって、当社の生産計画はExcelの表計算から、リアルタイムでの生産最適化へと進化しました。」
Kalle Kalliomäki、サプライチェーン担当スペシャリスト
UTU · 配電盤・開閉装置
生産計画にかかる作業時間を毎週2時間削減し、新しい作業キューを数秒で製造ラインに届けています。
+90%生産効率が向上
「生産効率が90%向上しました。」
Abdul Rucyinga、IT責任者
Laboratory & Allied · 医薬品製造
生産効率が90%向上。全リソースを対象に最適化した三か月分の計画を、30分未満で作成しています。
削減資材不足による生産停止
「SkyPlannerの価値は、日々の業務で実際に使えるツールであることです。特に納期の設定で役立っています。」
Tommi Männistö、生産計画マネージャー
Eskomatic · 機械加工受託
負荷を自動で割り付けることで納期の精度が向上し、資材不足による生産停止も大幅に減少しました。
1,000件単位製造指図を自動でスケジューリング
「生産の管理がこれまでとは変わり、生産能力の把握もまったく違うレベルになりました。」
Hannu Ryynänen、CEO
Mamec · 産業用ミキサー、ポンプ、ハイテク製品の受託製造
数千件の製造指図を自動でスケジューリングし、組織全体で生産状況をリアルタイムに把握しています。
よくある質問
KatanaにAPIはありますか。どのプランが必要ですか。
はい。KatanaはOpenAPI 3.0仕様の公開REST API v1を提供しています。料金ページでは、FreeプランとAdvantageプランでAPIを利用できると記載されています。認証には、Settings > APIで取得したAPIキーをBearer方式で使用します。
SkyPlannerからKatanaにスケジュールを書き戻せますか。
はい。SkyPlannerは/manufacturing_order_rerankを使い、KatanaのScheduleタブ上で未完了の製造オーダーをSkyPlannerの計画順に並べ替え、各MOのproduction_deadline_dateを書き込みます。工程のステータスと実績時間は、MOの工程行に反映します。リソースごとの時刻付きの計画はSkyPlannerで管理し、作業者は自分の作業キューに沿って作業します。
Katanaは変更をリアルタイムに通知しますか。
はい。KatanaのWebhookは、製造オーダー、工程行、在庫、発注、販売オーダーに対応しています。SkyPlannerは変更された各オブジェクトを取得し、毎晩データを照合します。そのため、イベントを取り逃しても、作業データが古いまま残ることはありません。
KatanaのリソースはSkyPlannerのリソースにどう対応付けられますか。
Katanaの工程行にある個々のリソースを、キーで1:1に対応付けてSkyPlannerのリソースにします。その後、SkyPlannerでシフト、不在、代替リソースを設定します。
連携を構築する前にSkyPlannerを試せますか。
はい。30日間の無料トライアルでは、KatanaからCSVをインポートして最大20リソースを利用できます。クレジットカードは不要です。無料トライアルを開始するか、連携の要件定義について営業担当にご相談ください。
