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

Oracleは今後の方針を示しています。2026.1以降、新規連携はOAuth 2.0を使用するSuiteTalk REST Webサービスで構築すべきとされています。2027.1以降は、SOAPまたはToken-Based Authentication（TBA）を使用した新規連携はできません。2028.2ではSOAPエンドポイントが無効になります。これから着手するスケジューリング連携にはRESTを使用すべきです。

認証

サーバー間で接続するスケジューラには、OAuth 2.0 Client Credentials（マシン間認証）を使用します。管理画面での設定場所は、Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setupです。公開証明書をアップロードし、エンティティ、ロール、連携レコードに紐付けます。連携レコードごとに、有効な証明書を最大五つ保持できます。

連携専用のロールを作成します。品目、BOMリビジョン、工順、作業区には閲覧権限を、製造指図、完了、出庫には編集権限を付与してください。SkyPlanner REST API（APIリファレンス）はJWTを使用するため、ミドルウェアで両方の認証情報を保持します。

イベント：標準のWebhookはない

Oracleのドキュメントには、標準機能として外部に通知を送るWebhookの記載はありません。実装では、Work OrderのSuiteScript User Eventスクリプト（afterSubmit）から、N/taskまたはMap/Reduceスクリプトを使って外部呼び出しをキューに入れ、N/httpsで送信します。afterSubmit内で同期的に外部を呼び出してはいけません。ユーザーの保存処理中に実行されるため、エンドポイントの応答が遅いと、保存の遅延や失敗につながります。

User Eventでは、すべての変更経路をカバーできません。一括更新やCSVインポートでは、イベントが実行されない場合があります。変更を取りこぼさないよう、イベントスクリプトに加え、SuiteQLでlastmodifieddateを定期的にポーリングしてデータを照合します。逆方向の書き戻しはSkyPlanner独自のWebhookを起点に行うため、計画が変わるとすぐに新しい日付がNetSuiteに反映されます。

1. マスタデータの初期取り込み。SuiteQLで、まず作業区を読み込み、次に品目、BOMリビジョン、工順を読み込みます。工順は作業区を参照するため、この順序が重要です。トライアルでは同じデータをCSVにエクスポートし、SkyPlannerにインポートします。コードを書き始める前に、スケジュールを検証します。

2. オーダーの同期。ステータスがReleasedおよびIn Processの製造指図を取得します。Plannedの製造指図も取り込むかどうかは、早い段階で決めてください。取り込む場合は、暫定需要として扱います。同じサイクルで未完了の発注書も同期します。これにより、スケジュール作成時に、在庫だけでなく入荷予定の資材も含めて各作業の資材を確認できます。

3. スケジュールの書き戻し。スケジュールが変わると、SkyPlannerのWebhookが新しい工程日付をミドルウェアに送信します。ミドルウェアは、変更された工程ごとにPATCH /services/rest/record/v1/manufacturingOperationTask/{id}（Oracleのレコードリファレンス）を送信し、startDateとendDateを指定します。さらに、workOrderヘッダーへのPATCHでProduction Start and End Dateを設定します。書き込むのは日付だけとし、カスタムの順序フィールドを使用している場合はそれも対象にします。数量やBOMデータは決して書き戻さないでください。多数の工程を単一のトランザクションで更新する場合は、小規模なRESTletを使い、工程リスト全体を一度の呼び出しで保存します。基本はrecord APIを使用します。

4. 製造現場からの実績報告。作業者はSkyPlanner Mobile Confirmationsで作業を記録します。ミドルウェアは、Work Orderの変換処理を使い、各実績報告をPOST /services/rest/record/v1/workOrder/{id}/!transform/workOrderCompletionで送信します。送信内容には、startOperation、endOperation、完了数量、工程明細に記録された作業時間を含めます。WIPを使用しない製造指図は、代わりに!transform/assemblyBuildで完了処理を行います。REST経由のWork Order Completionには、Manufacturing Work In Process機能が必要です。在庫と原価の計上は引き続きNetSuiteで行います。

5. 冪等性と再試行。各完了レコードでは、SkyPlannerのタイムログIDをNetSuiteの外部IDとして使用します。外部IDはレコードタイプごとに一意なので、Webhookが再送されても重複として拒否され、数量や原価が二重計上されません。書き込みはキューを経由します。同時実行数の上限、レコードのロック、証明書の期限切れなどで呼び出しに失敗した場合は、再試行してログに記録します。それでも失敗する処理は、連携をサポートするSkyPlannerチームが確認できます。

6. 管理の分担。何を作るか、つまり品目、数量、BOM、工順、拠点はNetSuiteで管理します。いつ、どこで作るか、つまり工程順序、リソース、開始・終了はSkyPlannerで管理します。NetSuiteで日付を編集しても、次の書き戻しで上書きされます。そのため、フォームのカスタマイズまたはワークフローでProduction Start/End Dateをロックしてください。

• 工順のない製造指図。Manufacturing Routingがない製造指図には、スケジュールに割り付ける工程がありません。Oracleも、実際の能力を考慮する自社の生産スケジューラについて、同じ注意事項を示しています：”Work orders not associated with a NetSuite routing should not be scheduled.”（NetSuiteの工順に紐付いていない製造指図は、スケジュールに割り付けるべきではありません。）本稼働前にSuiteQLで該当する製造指図を洗い出してください。
• 作業区で管理できる情報は限られる。NetSuiteの作業区はGroupで、Machine ResourcesとLabor Resourcesという二つの数量項目（いずれも初期値は0）と、一つのWork Calendarを持ちます。通常は”Default Work Calendar”が設定されています。作業区は一度取り込み、その後はSkyPlannerで個々のリソース、作業者ごとのシフト、工具、段取り時間マトリクス、代替リソースを管理します。
• Setup TimeとRun Rateのデータ精度。NetSuiteは能力の上限を考慮しないスケジューリングでもこれらのフィールドを使用しますが、能力を考慮しないため、値が誤っていても気付かれません。実際の能力を考慮した生産スケジューリングでは、運用初日からこうした誤りが表面化します。
• WIPか非WIPか。Manufacturing WIPを使用する場合、生産実績はWork Order Issue、Work Order Completion、Work Order Closeを通じて計上します。WIPを使用しない場合はAssembly Buildを使用します。連携では、WIP品目には完了レコードを、それ以外には組立レコードを登録するため、品目ごとのモデルもマッピングに含めます。
• 同じアカウントでのAdvanced Manufacturingの利用。同じアカウントでAdvanced Manufacturing SuiteAppも使用している場合、そのManufacturing Work Benchレコードの工程順序、工程名、作業区は、工順と完全に一致していなければなりません。どちらのシステムで工程の日付を設定するか決めてください。同じ製造指図に二つのスケジューラを使えば、二つの計画が競合します。
• 同時実行数の上限。WebサービスとRESTletの呼び出しには、共通のアカウント単位の同時実行数上限が適用されます。上限はサービス階層で決まり、SuiteCloud Plusライセンスごとに10が加算されます。レコード単位で並列にポーリングすると、すぐに上限に達します。読み取りにはページングを使用したSuiteQLを使い、書き込みはキューに入れてください。
• サンドボックスのリフレッシュでM2M設定が消える。OAuth 2.0のクライアント認証情報のマッピングは、サンドボックスのリフレッシュ時に消去され、アカウント間でもコピーされません。証明書が期限切れまたは失効すると、新しいマッピングを作成するまで同期が停止します。認証失敗時にはアラートが出るようにしてください。