2025年8月12日
2025年7月および今後のリリースにおけるFedEx Advanced Integrated Visibilityの機能強化
Webhook製品、お客様の可視性、統合体験を改善するための継続的な取り組みの一環として、以下に挙げるいくつかの重要なアップデートを導入し、展開いたしました。
リリース日:2025年7月31日
- 組織内の複数のWebhookサブスクリプションに同じ出荷アカウント・ナンバーを追加する機能。
- Webhookのドキュメントページを再設計し、読みやすさを向上。
- 不具合修正 - Account Number subscription APIとTrack Number Subscription APIからURLを削除。プロダクションURLはデフォルト表示。
- 不具合修正 - WebhookダッシュボードのUI問題を修正したことでユーザーが大量のアカウント・ナンバーを表示および検索が可能に。
今後の機能強化 – 2025 年 9 月
- イベント説明の標準化(終止符(ピリオド)の削除)。
- 貨物の追跡スキーマの非推奨フィールドを削除。
- 住所の詳細と事業所のタイプをFedEx営業所留め、お引き取りノードに追加。
追加の詳細:
今後の変更がWebhook統合に悪影響を与えないように、以下のリリースの詳細を確認してください。
2025年7月31日リリース - 詳細ノート
1. Webhookサブスクリプション間での出荷アカウントの重複
お客様は、同じ組織内でWebhookの作成、または更新時に複数のサブスクリプションIDに同じ出荷アカウント・ナンバーを追加できます。国の制限は適用されません。
シナリオ例:
- 出荷アカウント・ナンバー: ABC123456
- サブスクリプションID:SubscriptionID-001、SubscriptionID-002、SubscriptionID-003
Webhookの作成または更新時にABC123456を3つのサブスクリプションすべてに追加できるようになり、お客様の組織のシステム全体で一貫した追跡とイベント処理を可能にします。
更新されたWebhookドキュメント
Webhookの[ドキュメント]ページには、開発者をサポートするためにフォーマットと視覚的な補助が改善され、より明確で詳細な説明が追加されました。
不具合修正
- このリリースの一環として、Account Number Subscription APIとTracking Number Subscription APIの両方のAPIエンドポイントドキュメントにあるプロダクションサーバーのURLのみを共有しています。これは、明確さを確保し、混乱を減らし、実稼働環境対応の実装をサポートすることを目的としています。
- FedEx Developer Portal(FDP)で出荷アカウントの一括処理を使用してWebhookを作成しようとした際に、ユーザーがエラーに遭遇する問題を解決しました。このエラーは、Webhookの設定プロセス中にすべてのアカウントのリストを読み込むことや表示することができなかったために発生しました。ユーザーは、複数の出荷アカウントを使用してWebhookを設定する際に、すべてのアカウントを問題なく表示および選択できるようになります。
2025年9月リリースの詳細
今後のリリースの詳細は以下に記載されていますので、ご確認ください。必要な開発作業が完了しましたら、詳細なリリーススケジュールを速やかにお知らせいたします。
1. Webhookデータのイベント説明の標準化
システムと統合全体の一貫性を確保するため、イベントの説明から終止符 (ピリオド) を削除します。この変更は、すべてのイベントタイプに適用され、プラットフォーム全体で一貫した形式を維持するのに役立ちます。
この変更がWebhook統合に与える影響はどのようなものですか?
システムが正確なイベント記述形式(解析やマッチングなど)に依存している場合、これは重大な変更になる可能性があります。
影響を受けるイベントのリストは以下に一覧で示されています。
| 現在のイベントの説明(変更前) | 新しいイベントの説明(変更後) |
|---|---|
| 空港でのマニフェストデータ。 | 空港でのマニフェストデータ |
| 通関業者で通関済み。 | 通関業者で通関済み |
| 通関業者に到着。 | 通関業者に到着 |
| 通関業者での通関遅延。 | 通関業者での通関遅延 |
| 仕向地のFedEx事業所に到着。 | 仕向地のFedEx事業所に到着 |
| 仕向地のFedEx事業所にて。 | 仕向地のFedEx事業所にて |
| 仕向地のFedEx事業所に予定通りに到着。 | 仕向地のFedEx事業所に予定通りに到着 |
| 仕向地のFedEx事業所に早期到着。 | 仕向地のFedEx事業所に早期到着 |
| 仕向地のFedEx事業所でのお引き取りの準備が整う。 | 仕向地のFedEx事業所でのお引き取りの準備が整う |
| 仕向地のFedEx事業所で配達に関する例外的状況。 | 仕向地のFedEx事業所で配達に関する例外的状況 |
| 仕向地のFedEx事業所で遅延。 | 仕向地のFedEx事業所で遅延 |
| 仕向地のFedEx営業所留め。 | 仕向地のFedEx営業所留め |
| 配達場所に到着。 | 配達場所に到着 |
| 配達先の配達に関する例外的状況。 | 配達先の配達に関する例外的状況 |
| 配達場所に予定通りに到着。 | 配達場所に予定通りに到着 |
| 配達場所に早期到着。 | 配達場所に早期到着 |
| 配達場所での配達遅延。 | 配達場所での配達遅延 |
| 配送中に配達オプションリクエストがキャンセル。 | 配送中に配達オプションリクエストがキャンセル |
| 配送中に早期到着。 | 配送中に早期到着 |
| 配送中に予定通りに到着。 | 配送中に予定通りに到着 |
| 配送中にお引き取り遅延。 | 配送中にお引き取り遅延 |
| 配送中に通関済み。 | 配送中に通関済み |
| 配送中に配達遅延。 | 配送中に配達遅延 |
| FedEx事業所での通関手続き完了。 | FedEx事業所での通関手続き完了 |
| FedEx事業所で通関遅延。 | FedEx事業所で通関遅延 |
| FedEx事業所にて。 | フェデックス施設で |
| FedEx事業所から出発。 | FedEx事業所から出発 |
| FedEx事業所に到着。 | FedEx事業所に到着 |
| FedEx事業所で通関手続き中。 | FedEx事業所で通関手続き中 |
| FedEx事業所に予定通りに到着。 | FedEx事業所に予定通りに到着 |
| FedEx事業所に早期到着。 | FedEx事業所に早期到着 |
| 出荷地のFedEx事業所に到着。 | 出荷地のFedEx事業所に到着 |
| FedEx事業所での遅延。 | FedEx事業所での遅延 |
| 出荷地のFedEx事業所から出発。 | 出荷地のFedEx事業所から出発 |
| FedEx事業所でFedExの管理下にある。 | FedEx事業所でFedExの管理下にある |
| FedEx事業所での転送。 | FedEx事業所での転送 |
| FedEx事業所でのオンデマンドケア。 | FedEx事業所でのオンデマンドケア |
| 出荷地のFedEx事業所に予定通りに到着。 | 出荷地のFedEx事業所に予定通りに到着 |
| 出荷地のFedEx事業所に早期到着。 | 出荷地のFedEx事業所に早期到着 |
| 出荷地のFedEx事業所で通関遅延。 | 出荷地のFedEx事業所で通関遅延 |
| 出荷地のFedEx事業所で場所が変更。 | 出荷地のFedEx事業所で場所が変更 |
| 出荷地のFedEx事業所での通関手続き完了。 | 出荷地のFedEx事業所での通関手続き完了 |
| 出荷地のFedEx事業所での転送。 | 出荷地のFedEx事業所での転送 |
| お引き取り場所に予定通りに到着。 | お引き取り場所に予定通りに到着 |
| お引き取り場所に早期到着。 | お引き取り場所に早期到着 |
| お引き取り場所でのFedExによる保管。 | お引き取り場所でのFedExによる保管 |
| 車両に早期到着。 | 車両に早期到着 |
| 車両に予定通りに到着。 | 車両に予定通りに到着 |
| 仕向地を出発。 | 仕向地を出発 |
| 仕向地に到着。 | 仕向地に到着 |
| 仕向地に早期到着。 | 仕向地に早期到着 |
| 仕向地に予定通りに到着。 | 仕向地に予定通りに到着 |
| お引き取り場所に到着。 | お引き取り場所に到着 |
| お引き取り場所でのお引き取り遅延。 | お引き取り場所でのお引き取り遅延 |
2. スキーマのクリーンアップおよびフィールドの削除
冗長性を減らし、ペイロードを簡素化するために、次のフィールドは貨物の追跡応答スキーマから削除されます。
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
これらのフィールドはもはや必要ではなく、今後のリリースで廃止される予定です。
3. 営業所留めの機能強化、お引き取り準備完了イベント
営業所の場所の詳細が追加されました。以前、表示されていた営業所留めイベント:
<Facility>で営業所留め
これは次のように置き換えられます。
<Address>(<Facility Type>)で営業所留め
この変更により、お客様は荷物が保管されている正確な場所をより明確に把握できるようになり、全体的な配達体験が向上します。
「お引き取り準備完了」イベントを、マスクを解除し、住所行を直接イベントの説明文に追加することで実施します。この機能強化により、お客様は追加のフィールドを参照しなくても、パッケージのお引き取りが可能かどうかをすぐに確認できます。
例:
以前:
FedEx Officeでお引き取り
以後:
お引き取り準備完了
(パッケージはFedEx Office – 610.9TH ST、 DURHAM, NCでお引き取りいただけます)
これにより、お客様は正確な場所を把握し、パッケージを引き取ることができます。特に、近隣に複数のFedEx拠点がある場合、非常に便利です。
