Fedex Logo


WEBHOOKの作成 WEBHOOKの管理

ビジネスルールと検証プロセス


  • 1つの出荷アカウント・ナンバーは、複数のAdvanced Integrated Visibilityでは使用できません。
  • お客様が作成したリンク先URL／エンドポイントは次のとおりでなければなりません。
    • HTTPSホストであること。
    • POSTリクエストに応答し、JSONペイロードを解析すること。
    • 文字数制限は200文字まで
    • URLに以下の内容が含まれている場合、URLはブロックされます
      • RFC1918 IPスペース
      • fedex.comまたはそのサブドメインのいずれか
      • URL内のIPアドレス（localhost、127.0.0.1を含む）

 

  • Advanced Integrated Visibilityセキュリティ：有効な認証局（CA）からの証明書で構成されたTLS（SSL）1.2以降のプロトコルバージョンを使用するHTTPS接続のみがサポートされます。中断することなくFedExサーバーから最新情報を受信するには、以下のIPアドレスをホワイトリストに登録してください。
    製品

         お客様はホワイトリストに登録できます：“nat.fxconnect.eastus2.heap-prod.fedex.io”

         CIDR "20.65.16.22/31"を使用
  • 顧客は追跡イベントの最新情報を順番どおりに受け取らないことがあります。ですから、スキャンイベントのタイムスタンプをチェックして順序か正しいかどうかを確認する必要があります。
  • FedEx Developer Portalのアカウントを削除する：
    • ユーザー／顧客は以下の場合、アカウントを削除できません。
      1. アクティブな Advanced Integrated Visibility に関連付けられている場合。
      2. アカウントが利用可能な場合、またはプロジェクトに関連付けられている場合。
      3. プロジェクト／Advanced Integrated Visibility で唯一のアカウントの場合。
        注：ユーザー／お客様は、まずプロジェクト／Advanced Integrated Visibility からアカウントを削除してから、組織からアカウントを削除する必要があります。
    • ユーザー／顧客は以下の場合、アカウントを削除できます。
      1. アカウントは同じ貴社に属している必要があります。
      2. 貴社からアカウントを削除するには、ユーザー／顧客は管理者でなければなりません。

共通の制約

  • FedEx Express®、FedEx Ground®、FedEx Ground®Economy（旧称：FedEx SmartPost®）の各運営会社のFedEx9桁アカウント・ナンバーに関連するお客様の貨物は、仕向地や発送地（輸入、輸出、国際、国内など）にかかわらず、すべて対象となります。
  • Advanced Integrated Visibility Webhookは、9桁のエンタープライズ／小口貨物対応アカウントのみをサポートしています。エンタープライズアカウントでは、FedEx ExpressやFedEx Groundを含む、FedExオペレーティングカンパニーに関連する運送状の作成が可能です。

    • 注：9桁のLTLフレイト専用アカウントはサポートされていません。LTLフレイトアカウントを追加する場合は、FedExカスタマーサービスにご相談いただきLTLをエンタープライズアカウントに変換する必要があります。
  • 顧客は、ご自身で、受信した出荷追跡イベントの順序を管理する必要があります。
  • 登録されたAdvanced Integrated Visibility Webhookに何らかのアクティビティ（保存/失敗/作成/更新/キャンセル/削除）があるたびに、自動メール通知が送信されます。
  • 翻訳：

 


FedEx Developer Portalユーザーの役割：


FedEx Developer Portal 内では、設定された役割に基づいて特定の機能を実行できます。
FedEx Developer Portalの詳細については、貴社の管理ガイドでご確認ください。

Advanced Integrated Visibility検証プロセス

MAC／HMACとは？検証プロセスでどのように使用されますか？

メッセージ認証コード（MAC）は、秘密キーに基づいて、信頼性の低い媒体上で送信または保存された情報の完全性を検証する方法を提供します。通常、MACは、秘密キーを共有する2つの当事者間で送信される情報を検証するために使用されます。

暗号化ハッシュ関数に基づくMACメカニズムはHMACと呼ばれます。HMACは、秘密共有キーと組み合わせて、SHA256などの任意の暗号化ハッシュ関数と併用できます。HMACはRFC 2104で指定されています。FedEx Advanced Integrated Visibility Webhookは HMAC SHA256を使用します。

SHA256（セキュリティトークン + ペイロード） = ペイロードの一部としてBase64エンコードされたfdx-signature ヘッダー

例（HMAC SHA256ハッシュを説明するための疑似コードスニペット）：

  • まず、HMAC SHA256アルゴリズムとセキュリティトークンを秘密キーとして使用してMACを初期化します。
  • 次に、FedExが送信したリクエストペイロードを16進エンコードしてMAC操作を確定します。
  • この最終ハッシュは、FedExが送信したPUSHのヘッダー「fedex-signature」の値と一致しなければなりません。

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

新しい文字列を返します (Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

注：使用する秘密キーは、Advanced Integrated Visibilityの設定時、あるいはAdvanced Integrated Visibility URLのテスト時に指定するセキュリティトークンです。

 

レイテンシの計算

 

イベント作成時刻は、ネットワーク上でイベントが実際に発生した時刻を表します。イベントがシステムに記録される（メッセージ作成タイムスタンプで示される）までは、Webhookやその他のシステムではそのイベントを処理したり配信したりすることはできません。

推奨事項

遅延を測定する際は、イベントがデジタルシステムで利用可能になった時点を最も正確に表すメッセージ作成タイムスタンプを使用してください。。このタイムスタンプは、FedExのデジタル更新のタイミングと最も一致しており、通常、fedex.com上で確認できる更新情報よりも速い、あるいはほぼ同時に反映されます。

 

検証ルール：

  • Advanced Integrated Visibility Webhook名は一意である必要があります。
  • Advanced Integrated Visibility Webhookの宛先URLは、標準化された構文形式でなければなりません。
  • Advanced Integrated Visibility Webhookの作成に必要なすべてのフィールドを空フィールドにすることはできません。
  • Advanced Integrated Visibility Webhookを作成するには、少なくとも1つの利用可能なFedEx出荷アカウント・ナンバーを関連付ける必要があります。
  • 検証を成功させるには：
    • Advanced Integrated Visibility Webhookが正常に削除されると、確定メッセージが作成されます。

      サンプル確定メッセージ：<<Advanced Integrated Visibility Webhook名>>が正常に作成されました。ただし、変更が有効になるまでに最大10分かかることがあります。

  • 検証が不成功／失敗した場合：
    • FedExが200（OK）または202（Accepted）以外の応答を受信した場合、Advanced Integrated Visibility Webhook宛先URLの検証は失敗したものとみなされます。

ビジネスルールの例と検証プロセス


  • 1つの出荷アカウント・ナンバーは、複数のAdvanced Integrated Visibilityでは使用できません。
  • お客様が作成したリンク先URL／エンドポイントは次のとおりでなければなりません。
    • HTTPSホストであること。
    • POSTリクエストに応答し、JSONペイロードを解析すること。
    • 文字数制限は200文字まで
    • URLに以下の内容が含まれている場合、URLはブロックされます
      • RFC1918 IPスペース
      • fedex.comまたはそのサブドメインのいずれか
      • URL内のIPアドレス（localhost、127.0.0.1を含む）

 

  • Advanced Integrated Visibilityセキュリティ：有効な認証局（CA）からの証明書で構成されたTLS（SSL）1.2以降のプロトコルバージョンを使用するHTTPS接続のみがサポートされます。中断することなくFedExサーバーから最新情報を受信するには、以下のIPアドレスをホワイトリストに登録してください。
    製品

         お客様はホワイトリストに登録できます：“nat.fxconnect.eastus2.heap-prod.fedex.io”

         CIDR "20.65.16.22/31"を使用
  • 顧客は追跡イベントの最新情報を順番どおりに受け取らないことがあります。ですから、スキャンイベントのタイムスタンプをチェックして順序か正しいかどうかを確認する必要があります。
  • FedEx Developer Portalのアカウントを削除する：
    • ユーザー／顧客は以下の場合、アカウントを削除できません。
      1. アクティブな Advanced Integrated Visibility に関連付けられている場合。
      2. アカウントが利用可能な場合、またはプロジェクトに関連付けられている場合。
      3. プロジェクト／Advanced Integrated Visibility で唯一のアカウントの場合。
        注：ユーザー／お客様は、まずプロジェクト／Advanced Integrated Visibility からアカウントを削除してから、組織からアカウントを削除する必要があります。
    • ユーザー／顧客は以下の場合、アカウントを削除できます。
      1. アカウントは同じ貴社に属している必要があります。
      2. 貴社からアカウントを削除するには、ユーザー／顧客は管理者でなければなりません。
CLOSE

Response

Copy