Business Central連携ガイド SkyPlanner APSで生産スケジューリングを行うために

連携には、Business Centralに標準搭載されている次の二つのインターフェースを使います。

1. API v2.0は、販売・購買と在庫のデータに使用します。items、itemVariants、itemLedgerEntries、locations、unitsOfMeasure、salesOrders、salesOrderLines、purchaseOrders、purchaseOrderLines、vendors、customers、employeesを公開しています。製造関連のエンティティはないため、生産データにはもう一方のインターフェースを使用します。
2. OData v4 Webサービスは、製造データに使用します。Business Centralのどのページも、Web ServicesページからOData v4 Webサービスとして公開できます。オブジェクトの種類にPageを選び、ページIDとサービス名を指定して、Publishedを選択します。これでエンドポイントが利用可能になり、ALコードの作成も拡張機能のデプロイも不要です。この連携では、リリース済み製造オーダー、Prod. Order Routing Lines、作業区、機械区、工順の標準ページを公開し、/ODataV4/Company('{name}')/{ServiceName}で提供します。

公開したページでは読み取りも書き込みも可能です。Microsoftは “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,”（編集可能なページをWebサービスとして公開すると、OData呼び出しで基になるテーブルのデータにアクセスし、変更できます）と説明しており、更新にはPATCHを使います。計画日時もこの仕組みでBusiness Centralに書き戻します。生産計画担当者が使うのと同じページを経由し、同じ検証が行われます。

SOAPは使わないでください。MicrosoftはSOAP Webサービスを非推奨としており、2026 release wave 2（v29）ではMicrosoftのUIページをSOAPとして公開する機能が削除されます。

Business Centralでは、POST /api/v2.0/subscriptionsを使って、itemsやsalesOrdersなどのAPI v2.0エンティティに対するWebhookサブスクリプションを作成できます。次のルールがあります。

• サブスクリプションの作成にはハンドシェイクが必要です。受信側のエンドポイントは、200 OKとともにvalidationTokenを返す必要があります。
• サブスクリプションは三日で期限切れになります。PATCHで更新すると、ハンドシェイクが再度実行されます。
• 通知に含まれるのは、リソースパス、changeType、指定したclientStateであり、レコード全体ではありません。通知を受けた後でレコードを読み取ります。
• 通知は即時には届きません。Business Central onlineは最初の変更から30秒待機し、その間に変更されたレコードが1,000件を超えると、まとめて一つのcollection通知を送信します。
• オンライン環境では、Webhookサブスクリプションの上限は環境ごとに200件です。

製造オーダー、工順明細、発注は、公開ページとpurchaseOrdersを数分ごとにポーリングして取得します。未完了のオーダーに絞り込み、ページングを行うことで、リクエスト数をBusiness Centralの制限内に十分収められます。

SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻し処理はイベント駆動で動作します。

1. マスタデータの初期取り込み。公開ページからCertifiedの工順と製造BOM、作業区、マシンセンターを取得し、API v2.0から品目と単位を取得します。各作業区やマシンセンターをSkyPlannerのリソースにどう対応付けるか、明確に決めてください。例えば、三つのマシンセンターを持つ作業区を、一つのリソースグループにするのか、三つのリソースにするのかを決定します。

2. オーダーの同期。公開ページからReleasedの製造オーダーを工順明細・構成品とともに読み取ります。Firm Plannedもスケジュール対象とする場合は取り込みます。あわせてAPI v2.0から未完了の購買オーダー明細を取得します。SkyPlannerは発注済みの資材を購買オーダーの納入日に利用可能とみなし、購買オーダーがDeliveredになると在庫を更新します。そのため、スケジューリングでは在庫と入荷予定の両方を確認します。

Plannedの製造オーダーは絶対にスケジュール対象にしないでください。Microsoftによると、Business Centralは “deletes them the next time you run planning.”（次回の計画実行時にこれらを削除します）。Planning Worksheetは引き続き供給を提案し、SkyPlannerは確定したオーダーを実際の能力に合わせてスケジューリングします。

3. スケジュールの書き戻し。標準のProd. Order RoutingページをOData v4 Webサービスとして公開します。エンジンが配置または移動した各工程について、SkyPlannerはIf-Match ETagを付けて該当する工順明細にPATCHを送信します。Starting Date-TimeとEnding Date-Timeを設定し、工程を代替機械に移動した場合はTypeとNo.も設定します。

PATCHによってページとテーブルのトリガーが実行されるため、Business Centralは独自のロジックでフィールドを検証します。生産計画担当者がProd. Order Routingページを編集する場合とまったく同じです。製造オーダー明細のStarting Date-TimeとEnding Date-Timeも、それに合わせて更新されます。数量、状態、原価は引き続きBusiness Centralが管理します。

4. 製造現場での実績入力。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録し、その時間記録がスケジュールを最新に保ちます。生産実績は従来どおり、Business CentralのProduction JournalまたはOutput Journalから報告できます。

生産実績と消費実績の転記を完全に自動化する場合は、Output Journalへの転記用にBusiness Centralの標準APIページを追加します。これによりSkyPlannerが工程ごとの段取り時間、稼働時間、生産数量を転記します。転記するとCapacity Ledger Entriesが更新され、工順の最終工程で生産実績を計上すると品目が在庫に追加されます。

生産実績の転記経路は一つに絞ってください。SkyPlannerとBusiness CentralのProduction Journalの両方から転記すると、二重計上になります。

5. データの管理主体と競合時のルール。本稼働前に、次の内容を文書化してください。

競合の主な原因は、製造オーダーのRefreshとReplanです。Microsoftは “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.”（Refreshアクションで製造オーダー明細を再計算すると、Business Centralは既存の明細を削除して新しい明細を計算します）と説明しています。Replanでも必要能力が変わることがあり、構成品を再計算すると “deletes previous changes in the components.”（構成品に加えた以前の変更が削除されます）。

Refresh後のオーダーは新しいバージョンとして扱い、再同期してSkyPlannerでスケジュールを組み直してください。Autopilotを使えば、生産に変更があったときにSkyPlannerが自動で再スケジューリングします。

• 工順の単位。Setup Timeは製造オーダー単位、Run Timeは製品一個当たりの時間で、それぞれにUnit of Measure Codeがあります。Wait TimeとMove Timeは作業区の能力を消費しません。作業区の単位がDaysの場合、一日は八時間のシフトではなく24時間です。取り込み時に換算しないと、すべての所要時間が誤った値になります。
• カレンダーの更新漏れ。対象期間についてCalculate Work Center Calendarを実行して初めて、能力データが作成されます。初期取り込みの前にCalendar Entries Available Untilフィールドを確認してください。
• マシンセンターの能力が含まれない。Consolidated Calendarがオフの場合、計画に使われるのは作業区自体の能力だけです。”The machine center capacity is excluded.”（マシンセンターの能力は除外されます）。作業区の合計値に頼らず、マシンセンターの能力を直接読み取ってください。
• CapacityとEfficiency。Business CentralはRun Time / Efficiency / Capacityで所要時間を計算します。計算済みのカレンダーエントリには、すでに両方の値が反映されています。EfficiencyをSkyPlannerのリソース効率に対応付ける際は、二重に適用しないでください。
• Alternate Work Centerは参考情報。Microsoftによると、これは “isn’t automatically included in planning processes.”（計画処理に自動では含まれません）。代替先はSkyPlannerの代替リソースとして明示的に設定してください。
• スロットリング。オンライン環境の制限はユーザー単位で適用され、サービスプリンシパルもユーザー一人分として数えられます。5分間のスライディングウィンドウ内でODataリクエストは6,000件まで、同時リクエストは5件までです。ページサイズの上限は20,000件、$batchの上限は100操作で、操作は8分でタイムアウトします。レート制限を超えると429が返されます。全件を再読み込みするのではなく、バッチ処理、ページング、差分ポーリングを使用してください。
• ライセンス。製造機能を使えるのはPremiumのエクスペリエンスのみです。Essentialsのユーザーは、Premiumに設定された会社にサインインできません。