Odoo連携ガイド SkyPlanner APSで生産スケジューリング

廃止への対応は今から計画してください。Odooは、Odoo 22（2028年秋）とOdoo Online 21.1（2027年冬）でXML-RPCとJSON-RPCを廃止する予定です。19.0ではJSON-2を使って構築し、旧バージョンのデータベース向けのRPC処理は一つのアダプターに集約してください。アップグレード時の変更を一か所に抑えられます。@route(type='jsonrpc') を使うカスタムコントローラーは、この廃止の影響を受けません。

認証

ManufacturingとInventoryへの読み取り権限、製造指図への書き込み権限を持つ連携専用ユーザーを作成します。Preferences > Account Security > New API Keyから、そのユーザーのキーを生成してください。19.0ではキーの有効期間が最長三か月のため、ミドルウェアにはキーのローテーションと認証失敗時のアラートが必要です。これらがないと、キーの期限切れによる同期停止に気づけません。SkyPlanner側のREST APIはJWTを使用するため、ミドルウェアで両方の認証情報を保持します。

JSON-2の各呼び出しは個別のSQLトランザクションで実行されるため、複数の呼び出しに分かれた書き込みはアトミックではありません。製造指図ごとに書き込み、それぞれの結果を記録してください。

イベント

Odooは自動化ルールを通じて変更をプッシュ送信します。mrp.production または mrp.workorder に対し、トリガーを「On create and edit」（作成・編集時）、アクションを「Send Webhook Notification」（Webhook通知を送信）に設定すると、選択したフィールドを含むPOSTが指定URLに送信されます。ルールはStudioで作成するか、開発者モードのAutomation Rulesフォームから作成します。インポートによる変更やルールで拾えなかった変更も取得できるよう、search_read による定期ポーリングを併用し、write_date を条件に変更を抽出してください。逆方向では、SkyPlannerのWebhookがスケジュールと状態の変更を発生時にプッシュ送信します。

フィールド名はバージョンによって異なります。19.0では、各データベースのモデル、フィールド、メソッドが /doc に一覧表示されます。旧バージョンでは fields_get を呼び出してください。記憶に頼らず、これらの情報を基にマッピングします。

“ POST /json/2/mrp.workorder/write Authorization: bearer <api-key> {"ids": [4711], "vals": {"date_start": "2026-11-03 06:00:00", "date_finished": "2026-11-03 09:30:00", "workcenter_id": 7}} “

JSON-2は、ids と context に加え、各メソッド引数を名前で受け取ります。そのため、write(vals) の引数は vals キーとして渡します。16.0〜18.0では、同じ処理をXML-RPCまたはJSON-RPC経由で execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) として呼び出します。16.0の日時キーは date_planned_start と date_planned_finished です。日時はUTCで送信します。書き戻しを正しく行うため、次のルールを守ってください。

• 両方の日時を同じ呼び出しで送信します。
• エンジンが代替設備を選んだ場合にのみ workcenter_id を追加します。
• 書き込むのはスケジューリング用のフィールドだけにし、数量やBoMは決して変更しないでください。

日時を書き込むとOdoo側の作業区の予約枠も移動するため、Odooの計画ビューにSkyPlannerの計画が表示されます。

製造現場の実績をOdooへ返す。作業者はSkyPlanner Mobile Confirmationsで作業を記録します。連携処理は報告ごとに create を呼び出し、mrp.workcenter.productivity のレコードを作成します。JSON-2では、POST /json/2/mrp.workcenter.productivity/create に vals_list を渡します。workorder_id、workcenter_id、date_start、date_end と、loss_id（タイプはProductive）を設定すると、Odooに作業時間と原価が計上されます。

工程が完了すると、連携処理が生産数量を設定し、製造指図の button_finish を呼び出します。最後の製造指図が完了すると、製造オーダーは button_mark_done を実行できる状態になります。各実績報告は一度だけ登録し、OdooのレコードIDをSkyPlannerの作業時間記録とともに保持します。そのため、Webhookを再試行してもTime Logsのレコードが重複して作成されることはありません。

EnterpriseのShop Floorアプリを使う工場では、連携の向きが逆になります。SkyPlannerが製造指図の状態と qty_produced を読み取り、生産状況が変わるとAutopilotが自動で再スケジューリングします。

データの管理主体。本稼働前に、次の管理ルールを文書化してください。

SkyPlannerでスケジュールするMOについては、計画担当者はOdooのPlanとUnplanを操作しないようにします。操作すると、Odooが独自に作業枠を予約し、SkyPlannerで設定した日時を上書きしてしまいます。

• 日時フィールドの名称変更。16.0までは、date_planned_start と date_planned_finished に予定日時、date_start/date_finished に実績日時が格納されていました。17.0以降は、date_start と date_finished が予定日時です。16.0のプロジェクトからマッピングを流用すると、17+では警告もなく実績を予定として読み取ってしまいます。
• 製造指図の日時は作業区の予約と連動。19.0では、date_start と date_finished（mrp.workorder のフィールド）は、作業区カレンダー上の resource.calendar.leaves レコード（leave_id）から計算されます。製造指図の日時を書き込むと、その予約が更新されます。このテーブルには絶対に直接書き込まないでください。
• 着手済みの製造指図があると計画解除できない。Odooでは「Some work orders have already started」（一部の製造指図がすでに開始されています）の状態では、製造オーダーの計画解除ができません。書き戻し時には progress または done の製造指図を除外し、未着手のものだけを移動してください。
• 所要時間の変動。Computedに設定された工程は、直近の製造指図（デフォルトでは10件）を基に所要時間を算出し、Time Efficiencyで補正します。トライアル中はFixedに設定するか、入力値が変動することを前提にしてください。工程は各BoMに属し、共通の工順マスタはないため、BoMごとにデータの整備が必要です。
• カレンダーの不備。すべての作業区に稼働時間カレンダーが必要です。Odoo標準のスケジューラーは最大700日先まで検索し、枠が見つからないと”Impossible to plan the workorder”（製造指図を計画できません）と表示して停止します。初回取り込みの前にカレンダーを修正してください。
• 計量単位。mrp.bom.line には独自の product_uom_id があり、製品の在庫単位と異なる場合があります。資材の利用可否を確認する前に単位を換算してください。

連携によって日々の業務で効果を得る鍵は、データの書き戻しです。これが稼働すると、次のことが実現します。

• Odooの製造指図に実行可能な日時を反映。Arcturus AIエンジンは未完了のすべての製造オーダーの作業順序を数秒で決定します。算出した日時とリソースの割り当て先が mrp.workorder に反映され、Odooの計画画面に表示されます。
• 手作業での再計画が不要に。生産に変更が生じると、Autopilotが自動でスケジュールを組み直し、Webhookが新しい日時をOdooに送信します。
• 製造現場の実績まで連携。作業者はスマートフォンやタブレットでMobile Confirmations、Production Timer、Quick Log Modeを使って作業を記録します。Time Logsは在庫と原価計算のためにOdooへ送信されます。EnterpriseだけでなくCommunityでも、スケジューリングと作業の実行管理を一つのツールで行えます。
• Odooでは扱えない制約もスケジュールに反映。段取り時間マトリクスでは、製品の組み合わせごとに、作業順序に応じた段取り替え時間を設定します。工具は設備間で共有する有限のリソースとして扱い、一つの作業に複数の作業者を同時に割り当てることもできます。通常使う設備や人員が利用できない場合、エンジンは代替の設備や人員を選びます。mrp.workorder に書き戻す日時は、これらすべての制約を満たしています。
• 資材の入荷に合わせた計画。手持ち在庫とOdooの未完了の購買オーダーを基に、資材の状況を反映したスケジュールを作成します。発注済みの部品はPOの納入日に使用可能とみなされ、POがDeliveredになると在庫が更新されます。各作業について、倉庫にある資材と入荷予定の資材を照合します。

連携作業に着手する前に、スケジュールを評価できます。CSVエクスポートを使って30日間の無料トライアルを始め、実際のOdooの製造指図をガントチャートで確認してください。最大20のワークステーションを利用でき、クレジットカードは不要です。料金は5つのワークステーションを含めて月額199 €から。月払いで、いつでも解約できます。連携費用はお客様の工程や要件に合わせ、ご利用プランとともに事前にお見積もりするため、開始前に総費用を把握できます。機能や導入事例をご覧いただくか、デモをご予約ください。