API連携によるERPシステムとSalesforce Manufacturing Cloud販売合意の統合

本記事の執筆者：Salesforce 統合エンジニア

背景と応用シナリオ

製造業において、事業運営の基盤となるのは基幹業務システム（ERP）です。ERPは受注、在庫、生産、出荷、請求といった中核的な業務データを一元管理しています。一方で、顧客との関係管理、販売予測、商談管理などはSalesforceのようなCRMプラットフォームが担うことが増えています。特に、Salesforceの Manufacturing Cloud は、製造業特有のビジネスプロセスに特化した機能群を提供し、その中心的な機能の一つが「販売合意（Sales Agreement）」です。

販売合意は、特定の顧客と特定の商品について、一定期間内の予定販売数量や価格を契約として管理する機能です。これにより、企業は需要予測の精度を高め、生産計画や在庫管理を最適化できます。しかし、この販売合意が真価を発揮するためには、実績データとの連携が不可欠です。顧客からの実際の注文（実績）はERPシステムで管理されているため、Salesforce上の販売合意（予測）とERP上の受注実績を突き合わせ、契約の履行状況をリアルタイムで可視化する必要があります。

この予測と実績のギャップを埋めるのが、システム間連携です。本記事では、Salesforce 統合エンジニアの視点から、Salesforce の REST API を活用して、外部のERPシステムと Manufacturing Cloud の販売合意オブジェクトを連携させるための技術的なアプローチ、具体的な実装例、そして注意点について詳しく解説します。この連携により、営業部門は契約遵守率を正確に把握でき、経営層はより精度の高いデータに基づいた意思決定を下せるようになります。

原理説明

ERPシステムとSalesforce Manufacturing Cloudの連携を実現するための核心は、Salesforceが提供する標準の REST API を利用して、データを作成・更新・取得することです。この連携アーキテクチャでは、通常、MuleSoftやInformaticaといった連携ミドルウェア、あるいはカスタム開発された連携アプリケーションが中間に位置し、システム間のデータ変換、プロセスのオーケストレーション、エラーハンドリングなどを担います。

連携の対象となる主要なManufacturing Cloudのオブジェクトは以下の通りです。

SalesAgreement: 販売合意のヘッダー情報（顧客、契約期間、ステータスなど）を格納するオブジェクトです。
SalesAgreementProduct: 販売合意に含まれる個々の商品情報（商品、合計数量、価格など）を格納します。SalesAgreementの関連リストとして存在します。
SalesAgreementProductSchedule: 各商品について、期間ごとの予定数量や予定金額をスケジュールとして格納します。例えば、「1月は100個、2月は120個」といった情報を保持します。

実績データを反映させるために重要な役割を果たすのが、標準オブジェクトであるOrder（注文）です。ERPで受注が作成または更新されるたびに、その情報をSalesforceのOrderオブジェクトとして連携します。このとき、最も重要なのが、作成するOrderレコードをどのSalesAgreementに関連付けるかです。Orderオブジェクトには、そのための専用の参照項目 `SalesAgreementId` が用意されています。ここに該当する販売合意のレコードIDを設定することで、Salesforceは自動的にその注文数量を販売合意の実績数量として集計します。

連携の基本的なデータフローは以下のようになります。

ERP側でのイベント発生: ERPシステムで新規受注が登録される、または既存の受注が更新される。
データ抽出と送信: 連携ミドルウェアがERP側の変更を検知（例：Webhook、DBポーリング）し、必要なデータを抽出する。
データ変換: 抽出したERPの受注データを、SalesforceのOrderオブジェクトのデータ構造にマッピング・変換する。この際、ERPの顧客コードをSalesforceのAccountIdに、商品コードをPricebookEntryIdに変換するなどの処理が必要になる場合があります。
Salesforce APIコール: 変換後のデータを含むJSONペイロードを作成し、SalesforceのREST APIエンドポイントに対してPOST（新規作成）またはPATCH（更新）リクエストを送信する。このとき、`SalesAgreementId` を正しく指定することが極めて重要です。
レスポンス処理: Salesforce APIからのレスポンス（成功または失敗）を受け取り、結果をログに記録する。エラーが発生した場合は、リトライ処理や通知などのエラーハンドリングを実行する。

このフローを通じて、ERPの受注データがほぼリアルタイムでSalesforceに反映され、営業担当者やマネージャーは常に最新の販売合意の履行状況をダッシュボードやレポートで確認できるようになります。

示例代码

ここでは、ERPから連携された受注情報を基に、Salesforce REST API を使用して特定の販売合意に関連する `Order` レコードを作成する例を示します。この例では、`curl` コマンドを使用してAPIリクエストを直接実行していますが、実際の連携ではミドルウェアがこの処理を担います。

1. 販売合意（SalesAgreement）の情報をSOQLで取得

まず、注文を関連付ける対象の販売合意のIDを特定する必要があります。ここでは、契約番号（Agreement Number）を基にSOQLクエリを実行してIDを取得します。

# curlコマンドによるSOQLクエリの実行例
# -H "Authorization: Bearer YOUR_ACCESS_TOKEN" は有効なアクセストークンに置き換えてください
# YOUR_INSTANCE_URL はSalesforceインスタンスのURL（例: mydomain.my.salesforce.com）に置き換えてください

curl "https://YOUR_INSTANCE_URL/services/data/v58.0/query/?q=SELECT+Id,Name,AccountId+FROM+SalesAgreement+WHERE+Name='SA-000123'" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"

このクエリは、`SA-000123` という名前の販売合意のID、名前、関連取引先IDを返します。返却されたJSONから `Id` (`0SAxx0000000001AAA`のような形式) と `AccountId` を次のステップで使用します。

2. 販売合意に関連する注文（Order）を作成

次に、取得した `SalesAgreementId` と `AccountId` を使用して、`Order` オブジェクトに新しいレコードを作成します。`EffectiveDate` (注文日) や `Status` (状況) といった必須項目もペイロードに含めます。このコードは、Salesforce Developer ドキュメントの「Create a Record」セクションの標準的な例に基づいています。

# curlコマンドによるOrderレコードの作成例
# このリクエストは、販売合意ID '0SAxx0000000001AAA' に関連付けられた新しい注文を作成します。
# Pricebook2Idには、組織で有効な価格表のIDを指定する必要があります。

curl "https://YOUR_INSTANCE_URL/services/data/v58.0/sobjects/Order" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "AccountId" : "001xx0000000001AAA",
  "SalesAgreementId" : "0SAxx0000000001AAA",
  "EffectiveDate" : "2023-10-26",
  "Status" : "Draft",
  "Pricebook2Id" : "01sxx0000000001AAA"
}'

コードの解説：

エンドポイント: `/services/data/v58.0/sobjects/Order` は、Orderオブジェクトに対して操作を行うための標準REST APIエンドポイントです。
HTTPメソッド: `POST` メソッドを使用しているため、新規レコードの作成を意味します（`curl` では `-d` オプションを指定するとデフォルトでPOSTになります）。
ヘッダー: `Authorization` ヘッダーで認証を行い、`Content-Type` ヘッダーで送信するデータがJSON形式であることを示します。
リクエストボディ (ペイロード):
- `"AccountId"`: この注文がどの取引先に属するかを指定します。販売合意の取引先と一致させる必要があります。
- `"SalesAgreementId"`: これが最も重要な項目です。この注文がどの販売合意の実績としてカウントされるかを指定します。
- `"EffectiveDate"`: 注文日です。必須項目です。
- `"Status"`: 注文のステータスです。選択リストの値（例: 'Draft', 'Activated'）を指定します。
- `"Pricebook2Id"`: この注文で使用する価格表を指定します。注文商品（OrderItem）を追加する際に必須となります。

このリクエストが成功すると、SalesforceはHTTPステータスコード `201 Created` と、作成された新しいOrderレコードのIDを含むJSONレスポンスを返します。このIDは、後続の処理（例えば、注文商品の追加）で使用するためにログに記録しておくことが推奨されます。

注意事項

ERPとManufacturing Cloudの連携を設計・実装する際には、以下の点に特に注意する必要があります。

権限とプロファイル (Permissions and Profiles)

API連携には、専用の「連携ユーザ」を作成することを強く推奨します。このユーザには、必要最小限の権限のみを付与するべきです（最小権限の原則）。Manufacturing Cloudの販売合意関連オブジェクト（`SalesAgreement`, `SalesAgreementProduct`など）および `Order` オブジェクトに対する作成・参照・更新権限が必要です。また、`Manufacturing Sales Agreements` 権限セットライセンスが連携ユーザに割り当てられていることを確認してください。フィールドレベルセキュリティ（Field-Level Security）も適切に設定し、連携に必要な項目のみアクセス可能とすることがセキュリティ上重要です。

API制限 (API Limits)

Salesforceには、組織ごと、24時間ごとに実行できるAPIコール数に上限（ガバナ制限）が設けられています。大量の受注データを高頻度で連携する場合、この上限に抵触するリスクがあります。対策として、以下のような設計を検討すべきです。

一括処理: 1件ずつAPIコールを行うのではなく、複数のレコードをまとめて処理する。Salesforceが提供する Composite API や Bulk API は、1回のAPIコールで複数の操作を実行できるため、APIコール数を大幅に削減できます。
差分連携: 全件データを毎回同期するのではなく、前回の連携以降に変更があったデータのみを連携する差分同期の仕組みを導入します。

エラーハンドリングと監視 (Error Handling and Monitoring)

システム連携において、エラーは必ず発生するものです。ネットワーク障害、Salesforce側のメンテナンス、不正なデータ（例：存在しないIDの指定）など、原因は多岐にわたります。堅牢な連携を構築するためには、以下のようなエラーハンドリング機構が不可欠です。

リトライ機構: 一時的なエラー（例：タイムアウト）の場合に、処理を自動的に再試行する仕組みを実装します。
デッドレターキュー: 何度リトライしても成功しない処理は、エラーキュー（デッドレターキュー）に隔離し、手動での調査・対応を可能にします。
監視とアラート: 連携処理の成功・失敗、処理件数、API使用量などを常に監視し、異常が検知された際には管理者へ自動で通知（メール、Slackなど）する仕組みを構築します。

データマスタとID管理 (Data Master and ID Management)

顧客マスタや商品マスタがERPとSalesforceの両方に存在する場合、どちらを正（マスタ）とするかを明確に定義する必要があります。また、ERP側のレコードIDとSalesforce側のレコードIDを紐付けて管理する仕組み（相互参照テーブルなど）を連携ミドルウェア層に持つことが一般的です。これにより、更新処理の際に正しいレコードを特定できます。

まとめとベストプラクティス

Salesforce Manufacturing Cloud の販売合意機能とERPシステムの受注実績データをAPI連携させることは、製造業におけるDX（デジタルトランスフォーメーション）の重要なステップです。この連携により、予測と実績のデータを一元化し、ビジネスの可視性を飛躍的に高めることができます。

成功のためのベストプラクティスを以下にまとめます。

段階的なアプローチ: 最初から全てのデータを連携させようとせず、まずは主要なデータ（例：新規受注の作成）から連携を開始し、段階的に対象範囲（更新、キャンセルなど）を拡大していくアジャイルなアプローチを取ります。
連携ミドルウェアの活用: ポイント・ツー・ポイントの直接連携は避け、MuleSoftなどの連携プラットフォームを活用しましょう。これにより、データ変換、プロセスの管理、エラーハンドリング、再利用性が向上し、将来的な拡張も容易になります。
宣言的なツールの検討: コーディングを伴うAPI連携だけでなく、Salesforce Flow や MuleSoft Composer などのローコード/ノーコードツールで実現可能かどうかも検討します。これにより、開発・保守コストを削減できる場合があります。
明確なガバナンス体制: データマスタの所有者、連携仕様の変更管理プロセス、障害発生時の対応フローなど、関係者間での役割と責任を明確にするガバナンス体制を構築することが、長期的に安定した運用には不可欠です。

本記事で解説した技術的な原理とベストプラクティスを参考に、貴社のビジネス価値を最大化するシステム連携を実現してください。

にゃんこのSalesforce日記

このブログを検索