Fedex Logo


WEBHOOKの作成 WEBHOOKの管理

Advanced Integrated Visibility Webhooksの種類

Advanced Integrated Visibility Webhookを使用すると、FedExは特定のフェデックス・アカウント・ナンバーに関連する貨物の追跡イベントデータを、ほぼリアルタイムで宛先URLにプッシュすることができます。

FedEx Developer PortalでAdvanced Integrated Visibility Webhookプロジェクトを作成し、選択した契約タイプに基づいて、1つまたは複数のFedExアカウント・ナンバーまたはFedEx追跡番号にそれを関連付けることができます。

次のページへ移動：

Advanced Integrated Visibility Webhookを作成する手順を確認するにはAdvanced Integrated Visibilityアカウント・ナンバーのサブスクリプションまたはAdvanced Integrated Visibility追跡番号サブスクリプション に移動

 

 

FedEx Advanced Integrated Visibilityの概要


FedExのお客様はアカウント・ナンバーまたは追跡番号を登録することで、ラベルの作成から貨物の配達まで、配達証明を含む輸送中の貨物に関するイベントをほぼリアルタイムで受け取ることができます。

サブスクリプションの種類


FedExのお客様は、以下の方法でAdvanced Integrated Visibilityを登録することができます：

  • アカウント・ナンバー別 - フェデックス・アカウントに登録すると、アカウント・ナンバーに一致する貨物の最新情報を受け取ることができます。
  • 追跡番号別-FedEx追跡番号に登録すると、APIエンドポイントを通じて指定した追跡番号に一致する貨物の最新情報を受け取ることができます。

注：現在、サブスクリプションのご請求には、米国を拠点とするFedExの9桁のアカウントが必要で、お客様には追跡番号の数に応じて月額料金が請求されます。Advanced Integrated Visibilityの料金の詳細については、Advanced Integrated Visibility概要料金ガイドをご覧ください。

アカウント・ナンバーで登録する場合、現在の申し込みには、FedExの9桁の米国を拠点とする出荷アカウントが必要となります。

以下の表は、アカウント・ナンバーのサブスクリプションおよびAdvanced Integrated Visibility追跡番号に基づくサブスクリプションの機能に関する情報を示しています。

機能 アカウント・ナンバー登録 追跡番号サブスクリプション
応答 保護されたデータ = 個人を特定可能な情報（PII）データ 荷送人および荷受人のデータ SPOD CDOs（便利な配達オプション）／応答 匿名データ（出荷情報、輸送中の更新情報を含む。ただし、個人を特定可能な情報（PII）および応答は除く）
関連付け アカウント・ナンバーによる関連付け = リンクされたすべての追跡番号を一度に関連付けます 追跡番号の関連付け
所有権 アカウント・ナンバーはユーザー自身が所有する必要があります 追跡番号はユーザーが所有する必要はありません
フィルタリング 輸入、輸出、サードパーティ出荷によるイベントのフィルタリング機能
 イベントのフィルタリングができません
統合 アカウント・ナンバーの関連付けはUIを通じて行われます 追跡番号の関連付けはAPIエンドポイントを通じて行います
制限事項 最大100のアカウント・ナンバーを追加可能です リクエストごとに最大1000の追跡番号を追加することができます
適切な使用例 第1者顧客 - お客様がアカウント・ナンバーを所有している場合 第3者顧客 - お客様がファーストパーティのお客様の追跡番号をお持ちの場合

 

FedEx Integrated Visibility –サブスクリプションタイプ別機能比較

機能／データ要素 追跡番号サブスクリプション アカウント・ナンバー登録 注意事項
SPOD （配達証明） ご利用いただけません 利用可能（設定が必要） TIFF形式の署名画像、ペイロード内に納品
PPOD（配達証明写真） 利用可能（設定が必要） 利用可能（設定が必要） 配達先のJPEG画像、base64エンコード
PPODA（配達試行証明写真） 利用可能（設定が必要） 利用可能（設定が必要） 配達試みの場合、JPEG 画像を提供
GPS座標（gpsPodCoordinates） ご利用いただけません ご利用いただけます 追跡に基づくサブスクリプションのマスキング
連絡先情報（氏名、電話番号、会社名） マスク済み ご利用いただけます 荷送人、荷受人、出荷地、仕向地、仲介業者など
住所と郵便番号 マスク済み ご利用いただけます streetLinesおよびpostalCodeは、追跡に基づくペイロードでマスクされます。
アカウント ナンバー マスク済み ご利用いただけます billTo、荷送人、および荷受人のアカウント値が含まれます
パッケージの財務情報（例：declaredValue、codAmount） マスク済み ご利用いただけます 関税、代金引換（COD）、および申告価格はマスクされています
お問い合わせ・返送の詳細（お問い合わせコード、返送理由） マスク済み ご利用いただけます アカウントベースのサブスクライバーのみに詳細が表示されます
品目・内容データ マスク済み ご利用いただけます 部品番号、説明、数量を含みます
従業員ID（例：イベントスタッフ） マスク済み ご利用いただけません 両ケースともプライバシー保護のためマスクされています
イベント通知 & EDD/EDTW ご利用いただけます ご利用いただけます 両方でサポートされている配達予定日／時間機能
複数個口貨物（MPS） ご利用いただけます ご利用いただけます 追加の追跡情報付き
配達信頼度およびリスクスコアの推定 ご利用いただけます ご利用いただけます プレミアムティアのみに該当

 

Advanced Integrated Visibilityのためのマスクされたデータフィールド追跡番号に基づくサブスクリプション

サマリー

Advanced Integrated Visibility追跡番号に基づくサブスクリプションではなく、Advanced Integrated Visibilityアカウント・ナンバーのサブスクリプションを使用して貨物の追跡最新情報を購読する場合、お客様のプライバシーを保護し、データセキュリティポリシーに準拠するため、特定のデータフィールドはマスクされます。

このマスキングにより、個人連絡先情報、住所、財務情報などの機密情報は、権限を有する者だけがアクセスできるようになります。Advanced Integrated Visibility 追跡番号に基づくサブスクリプションをご利用のお客様は、以下のマスクされたフィールドには「XXXXX」と表示されますが、このデータはAdvanced Integrated Visibility追跡番号に基づくサブスクリプションを通じて入手可能です。

このマスクの意義には以下の点が含まれます：

  • 出荷地／仕向地の詳細および関係者の情報が限定的にしか確認できません。
  • 個人を特定する情報（例：氏名、電話番号）および財務関連または関税関連のデータが一切含まれていないこと。
  • セキュリティおよび規制順守のために、専有または機密の貨物情報を保護するように設計されています。

業務上またはビジネス上の理由でこれらのマスクされたフィールドへのアクセスが必要な場合は、アカウント・ナンバーを使用してご登録ください。

Advanced Integrated Visibilityでマスクされたデータポイント追跡番号に基づくサブスクリプション：

イベントのスキャン

  • scanEvent/location/locationContactAndAddress/address/streetLines
  • scanEvent/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/location/locationContactAndAddress/contact/companyName
  • scanEvent/location/locationContactAndAddress/contact/personName
  • scanEvent/previousEvents/［Array］/location/locationContactAndAddress/address/streetLines
  • scanEvent/previousEvents/［Array］/location/locationContactAndAddress/contact/phoneNumber
  • scanEvent/previousEvents/［Array］/location/locationContactAndAddress/contact/companyName
  • scanEvent/previousEvents/［Array］/location/locationContactAndAddress/contact/personName

荷送人の情報

  • trackResult/shipperInfo/contactAndAddress/address/postalCode
  • trackResult/shipperInfo/contactAndAddress/address/streetLines
  • trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
  • trackResult/shipperInfo/contactAndAddress/contact/companyName
  • trackResult/shipperInfo/contactAndAddress/contact/personName
  • trackResult/shipperInfo/account/value

荷受人の情報

  • trackResult/recipientInfo/contactAndAddress/address/postalCode
  • trackResult/recipientInfo/contactAndAddress/address/streetLines
  • trackResult/recipientInfo/account/value
  • trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
  • trackResult/recipientInfo/contactAndAddress/contact/companyName
  • trackResultecipientInfo/contactAndAddress/contact/personName

出荷地と仕向地

  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

配達および住所変更の詳細

  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

通関業者情報

  • trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
  • trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
  • trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
  • trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

パッケージおよび財務の詳細

  • trackResult/packageDetail/customsValue/value
  • trackResult/packageDetail/declaredValue/value
  • trackResult/packageDetail/originalTransportationCharge/value
  • trackResult/codDetail/codAmount/value

お問い合わせ・品目情報

  • trackResult/inquiries/［Array］/categoryCode
  • trackResult/inquiries/［Array］/code
  • trackResult/inquiries/［Array］/createTime
  • trackResult/inquiries/［Array］/statusCode
  • trackResult/commodityInfo/［Array］/description
  • trackResult/commodityInfo/［Array］/code

パッケージの内容と返送理由

  • trackResult/contents/［Array］/partNumber
  • trackResult/contents/［Array］/partCode
  • trackResult/contents/［Array］/description
  • trackResult/contents/［Array］/quantity
  • trackResult/returnReason/［Array］/code
  • trackResult/returnReason/［Array］/description

請求情報

  • trackResult/billToParties/［Array］/billToParty/accountNumber

お客様の利点：

  • 配達予定日と配達時間枠の曜日に関する輸送中の変更を事前に通知することで、荷受人との信頼関係を構築することができます。
  • FedExの配達証明写真を提供することで、WISMO（Where Is My Order「注文はどこにあるのか」）に関するお問い合わせや配達調査依頼にかかるお客様サービスのコストを削減します
  • ほぼリアルタイムで出荷状況に関する通知を提供することで、顧客体験を向上させることができます。
  • 最新の追跡情報を貨物ごとにチェックする継続的なポーリングに代わり、貨物に関する最新のプッシュ情報をリアルタイムでお届けすることで運用効率を向上させることができます。

機能と追跡イベント


追跡イベント

この機能により、貨物のステータスを追跡し、貨物のライフサイクルにおけるさまざまな更新をお客様に積極的に通知することができます。これによりお客様は、通知／アラートの受け取りを希望する出荷プロセス／イベントの正確な段階を指定するオプションを利用することができます。利用可能な出荷イベント：

  • 出荷：このオプションは、選択した出荷イベントが発生したときに通知を送信します。例：ラベル作成、集荷など
  • 輸送中：このオプションは、出荷輸送イベントの通知を送信します。例：輸送中、配達オフィスに保留された品目など。
  • 配達：このオプションは、出荷配送イベントの通知を送信します。例：配達中、配達済みなど。
  • 例外：このオプションは、配達に関する例外的状況の通知を送信します。例：通関遅延など
  • 便利な配達オプション：パーソナライズされた追跡イベントの通知を受け取るには、このオプションを選択してください。例：営業所留めリクエスト受付。

利用可能な出荷イベントオプションの詳細については、Advanced Integrated Visibility追跡イベントのステータスコードとステータスの表を参照してください。


配達証明


この機能は、注文が目的の仕向地に正常に到着したことを確認するために使用されます。機能：

  • 配達証明写真機能（PPOD）：PPODを使用すると、お客様はパッケージが玄関先に配達されたときに、その正確な位置の写真を受け取ることができます。
    Advanced Integrated Visibilityでは、PPOD画像をBase64形式のJSONペイロードで配信します。画像はその後、JPEG形式に変換できます。

    注：

    • PPODは、米国、カナダ、プエルトリコ、香港、ニュージーランド、英国、アイルランドでご利用いただけます。
    • PPODは、FedEx GroundおよびFedEx Express、個人宅宛て荷物／個人宅住所でのみご利用いただけます。
    • SPODが必要ない場合は、対象となる荷物にPPODをご利用いただけます。PPODとSPODは併用できません。
    • PPODは、顧客に直接渡されない（例：配達時に直接お客様に渡されない）署名不要（NSR）配達にご利用いただけます
    • PPODは14000～33000バイトの画像サイズをサポートします（320×240解像度の画像に適用可能）。

     

  • 配達試行証明写真機能（PPODA）： 配達できなかった場合、PPODAはお客様に、荷物の配達予定場所の正確な位置の写真を送ります。Advanced Integrated Visibilityでは、PPOD画像をBase64形式のJSONペイロードで配信します。画像はJPEG形式に変換できます。
    • PPODAは、アメリカ合衆国およびプエルトリコでご利用いただけます。
    • PPODAは、FedEx Ground、FedEx Express、および個人宅および法人宛てパッケージ／住所でのみご利用いただけます。
    • PPODA画像は次のようなものがあります。
      1. ドアに貼られた不在票の写真。
      2. 配達場所まで到達できない理由の写真（例：施錠されたゲート）。
      3. 配送先でのパッケージの配達状況を示す写真。
    • PPODAは14000～33000バイトの画像サイズをサポートします（320×240解像度に適用可能）。

    •  

  • 署名配達証明機能（SPOD）：SPODを使用すると、お客様は荷受人の署名の画像、名前、配達日、時刻、場所に関する情報を受け取ることができます。SPOD情報は画像ではなくバイト配列として表示されます。バイト配列はBase 64でエンコードされた文字列ですので、PNG形式の署名画像を取得するにはデコードする必要があります。
    • SPODは、Advanced Integrated Visibility追跡番号に基づくサブスクリプションではご利用いただけません。
    • SPODの画像サイズは4000バイトから6000バイトになります（400x95解像度の画像に適用）。
    • SPODの画像サイズは4000バイトから6000バイトになります（400x95解像度の画像に適用）。

    •  

  • GPS配達証明（GPSPOD）：
    • GPS PODにより、お客様は配達場所の地理座標を受け取ることができます。

      注：GPSPOD は、dvanced Integrated Visibilityアカウント・ナンバーのサブスクリプションでデフォルトでご利用いただけます。

配達予定日と配達時間枠イベント


この機能はお客様に貨物の配達予定の日付や時間範囲を提供するため、荷受人は予定を立てることができます。機能：

  • 配達予定日（EDD）：このオプションでは、荷受人に貨物の配達予定日が提供されます。例：20XX年11月20日。
  • 配達予定時間帯（EDTW）：このオプションでは、実際の配達日に、荷受人に配達の予定時間枠をお知らせします。例：午後２時から午後６時まで。


イベントに基づくフィルタリング


この機能によりお客様は貨物の請求方法に基づいてWebhookプロジェクトを整理できます。オプションは次のとおりです。

  • 輸入：お客様に配達され、荷受人であるお客様が代金を支払う貨物の場合は、このオプションを選択してください。
  • 輸出：荷送人であるお客様が出荷し、料金を支払う貨物の場合は、このオプションを選択してください。
  • サードパーティー：サードパーティーの支払者として請求される輸入および輸出の貨物の場合は、このオプションを選択してください。

注：フェデックス・アカウント・ナンバーは、貨物の請求または支払いに使用されます。サードパーティー支払者の場合、お客様は荷送人または荷受人ではない可能性がありますが、料金はお客様のフェデックス・アカウント・ナンバーに請求されます。


再試行ポリシー

この機能により、クライアント側で問題が発生した場合にFedExが追跡イベントデータを送信できなくなります。FedExはデータを保留し、5分間隔で3回の再送を試みます。

定義された期間内に正常な応答を受信しない場合、FedExはその特定のイベントの再配達を停止します。ただし、Advanced Integrated Visibility Webhookプロジェクトの詳細ページにある再試行ボタンを使用して、過去7日間の見逃したイベントをリクエストすることができます。

再試行ポリシーの詳細については、「再試行メカニズム」セクションでご確認ください。

CLOSE

Response

Copy