概要
Advanced Integrated Visibility Webhookを活用することで、FedExは、1つ以上のFedExアカウント・ナンバーに関連付けられた貨物について、ほぼリアルタイムで安全な追跡イベントデータを指定された仕向地URLにプッシュ送信することができます。FedEx Developer Portalを通じて、この機能を利用するための Webhook プロジェクトの作成することができます。
ナビゲーション・パス
以下のいずれかの方法から、Webhook作成ページにアクセスできます。
1. マイプロジェクトから：
- 左ナビゲーションパネル →［Webhooks］ タブ →［+Webhookプロジェクトを作成］
2. APIカタログから：
左側のナビゲーションパネル → APIカタログ
Advanced Integrated Visibilityで検索またはフィルタリング
選択：
- 概要 → ［ドキュメント］をクリック → Sandboxコンソールで、［+プロジェクトの作成］をクリックします
- ［ドキュメント］ → ［+Webhookの作成］をクリックしてください
Webhookの作成手順
ステップ1：会社形態を選択します
+プロジェクトの作成をクリックし、ドロップダウンメニューから会社の種類を選択します。
1. FedExでの出荷を行い、あわせてFedEx Webhookをお客様のシステムへ統合する必要があります。
2. FedExのデータを用いたソフトウェアソリューションを販売または提供していますが、FedEx Compatible Providerではありません。
3. 認定されたFedEx Compatible Providerです。
現在、FedEx Advanced Integrated Visibility Webhookソリューションは、このオプションではご利用いただけません。FedEx Compatibleプログラムのメンバーとして、Basic Integrated Visibilityやその他のFedEx統合ソリューションへのアクセスをご希望の場合は、担当のチャネルマネージャーにお問い合わせください。担当のチャネルマネージャーがわからない場合は、会社の管理者にお問い合わせください。
次に、サブスクリプションの種類としてAdvanced Integrated Visibility アカウント・ナンバーのサブスクリプションを選択します。
Advanced Integrated Visibilityアカウント・ナンバーのサブスクリプションの作成
作成プロセスには、4つの重要なステップがあります。
ステップ1：Advanced Integrated Visibilityアカウント・ナンバー・サブスクリプションを有効にする
このステップは、第三者のお客様からのリクエストに際し、FedEx管理担当者またはFedEx担当者が対応いたします。
- MNDAドキュメント： FedEx管理担当者またはFedEx担当者が、相互秘密保持契約（MNDA）と、第1当事者／荷送人のアカウント・ナンバーの一括リストを回収いたします。
注：今回のアップロードでは、他の組織に関連付けられている重複するアカウント・ナンバーも許可されます。
- 該当する場合、組織レベルでカスタム料金設定が有効になります。
注：この機能は、7月のエクスペリエンスには含まれていません。
ステップ2：＋プロジェクトを作成する
［製品の選択］ページでは：
1. ［Advanced Integrated Visibility – アカウント・ナンバー］をクリックし、続いて［次へ］をクリックしてください。
2. ［請求先アカウント］を選択し、支払い条件に同意して、［次へ］をクリックしてください。
少なくとも1つの請求先アカウントを追加する必要があります。
3. ［詳細の確認］ページでは：
- プロジェクト情報を確認します。
- 利用規約に同意します。
- カスタム料金設定が適用される場合、関連する書類が自動的に表示されます。
4. 作成に成功すると、確認メッセージが表示されます。
「製品を［マイプロジェクト］に正常に追加しました。」
5. プロジェクトの概要 – APIキーの有効化手順
- ［プロジェクトの概要］ページのAPIセクションにある［APIキー］タブでは、サブスクリプションの本番環境ステータスは、最初は「無効」と表示されます。
- FedExの管理担当者または担当者が、リクエストに際して製品を有効化いたします。
- 有効にすると、［実稼働キー］タブが利用可能になり、本番環境のステータスが「確認待ち」に更新されます。
- FedExの管理者または担当者による最終的な有効化が完了すると、実稼働ステータスは「有効」と表示されます。
ステップ3：プロジェクトの概要 – Webhookの設定
1. ［プロジェクトの概要］ページに移動します。
2. ［Webhook］タブを選択してください。
3. ［+ Webhookの設定］ボタンをクリックして、Webhookの設定を開始してください。［Webhook］タブに移動します。
機能の説明
| 項目名 | 説明 |
|---|---|
| 配達証明 | 貨物が正常に配達されたことを証明できます。含まれるもの：
|
| 配達予定日 | 荷受人が計画を立てられるよう、サポートできます：
|
| 追跡イベント | 通知を受け取るイベントカテゴリを1つ以上選択できます：
|
| イベントに基づくフィルタリング | Webhookの応答を絞り込み、以下の情報を含めるように設定します。
|
2.［詳細の入力］ページで、次の情報を入力します。
| 項目名 | 説明 |
|---|---|
| Webhookプロジェクト名 | Webhookプロジェクトの一意の空フィールドではない名前。提案された名前は自動的に入力されますが、編集できます。この名前は、他のWebhookで繰り返し使用することはできません。 |
| リンク先 URL | FedExが追跡イベントデータを送信する安全なHTTPSエンドポイントです。 必要条件：
|
| セキュリティトークン | HMAC を使用して Webhook の応答を認証および検証するために使用される共有秘密です。 必要条件：
|
| ペイロード言語（国） | ドロップダウンリストから、追跡データの翻訳に使用する言語を選択します。 |
| 追跡（種類） | 追跡データの配信方法を選択してください。
|
| Eメールアドレス | 通知を受け取るには、有効なメールアドレスを入力してください。 |
| Eメールの言語（国） | Eメール通知の希望言語を選択してください。 注意：米国のロケールのみをサポートします（例：en-US、es-US）。 |
ステップ3：出荷先アカウントを選択する
［出荷アカウントの選択］ページで：
- Webhookプロジェクトに関連付けるには、1つ以上のFedExアカウント・ナンバーを選択します。
重要な注意事項：
- 他のWebhookにまだ関連付けられていないアカウントのみが表示されます。
- 続行するには、少なくとも1つのアカウントを関連付ける必要があります。
- Webhook UIから最大100件のアカウントを追加できます。
- 100件を超えるアカウントを関連付けるには、Webhook APIを使用してください。
APIアクセスをリクエストするには、FedExカスタマーサービスまたはヘルプデスクにお問い合わせください。
ステップ4：詳細を確認して作成する
［詳細の確認］ページでは：
1. Webhookプロジェクトに入力したすべての情報を確認してください。
2. チェックボックスにチェックを入れて、利用規約に同意してください。
3. ［作成］をクリックして、Webhookの設定を完了してください。
送信に成功すると、システムが生成したサブスクリプション IDで Webhook が作成され、アクティブステータスに設定されます。
検証ルール：
一般的な要件：
- Webhook名は一意でなければなりません。
- リンク先URLは、標準化された構文形式（セキュアなHTTPS、fedex.comまたはそのサブドメインは指定できません）に従う必要があります。
- すべての必須フィールドに入力してください。必須フィールドを空欄のままにすることはできません。
- 少なくとも1つの有効なFedEx出荷アカウント・ナンバーがWebhookに関連付けられている必要があります。
検証の成功：
Webhookが正常に作成されると、お客様は次の確定メッセージを受け取ります。
<<Webhook name>>が正常に作成されました。ただし、変更が有効になるまでに最大10分かかることがあります。
検証の不成功／失敗：
FedExがリンク先 URLからHTTP 200（OK）または202（Accepted）以外の応答を受信した場合、Webhookの検証は失敗したと見なされます。
