FedEx荷送人
前提条件
FedEx Developer Portalにログインして組織を作成するには、FedExユーザー IDが必要です。
会社の組織に参加して、チームと協力してください。もし、お客様の会社に組織がない場合は、作成することができます。
既存の組織に参加する
1. 招待をリクエストする
組織の管理者に招待状を送信するよう依頼してください。承諾期限は24時間です。招待が期限切れになった場合は、管理者に再送信を依頼してください。
2. 招待を受け入れる
既存のユーザーIDとパスワードでサインインしてください。ユーザーIDが別の組織に関連付けられている場合は、新しいIDを作成してください。
新しい組織を作成する
組織を作成すると、お客様は管理者になります。管理者として、ユーザーを組織に招待したり、プロジェクトやユーザー役割を割り当てたり、出荷先アカウントを管理したりできます。
ユーザーの役割の詳細については、組織管理ガイドラインを参照してください。
1. FedEx Developer Portal にサインインします。
2. メニューから［マイプロジェクト］を選択し、次に［組織の作成］を選択します。
3. 以下の詳細を入力してます。
- ［働いている会社は］に、［FedExで出荷し、自社アプリケーションにFedEx APIを統合する必要がある］を選択してください
- 会社名、会社のウェブサイト、およびチームが認識できる組織名（例：会社名、部署、部門、地域など）を入力してください。
4. ［作成］を選択します。
後でメニューの［組織の管理］から詳細を更新または追加できます。
出荷アカウントを追加する
1. ［アカウントの追加］タイルで［出荷アカウントの追加］を選択します。FedExアカウントをお持ちでない場合は、アカウントの作成を選択して新規アカウントを開設するか、FedExサポートにお問い合わせください。
2. ［+ アカウントの追加］を選択します。
3. フェデックス・アカウント・ナンバー、アカウントのニックネーム、およびアカウント設定時に使用した請求先住所を入力します。
4. ユーザー使用許諾契約に同意するか、またはお客様の会社の権限のある担当者に転送してください。
請求先アカウントを追加する
1. ［請求先アカウント］タブを選択します。FedExの請求先アカウントをお持ちでない場合は、［請求先アカウントを開設］を選び新規アカウントを開設するか、FedExサポートにお問い合わせください。
2. ［請求先アカウントの追加］を選択します。請求先アカウントは米国内の住所でなければなりません。
3. フェデックス・アカウント・ナンバー、アカウントのニックネーム、およびアカウント設定時に使用した米国の請求先住所を入力してください。
4. ユーザー使用許諾契約をお読みいただき、同意してください。
管理者としてユーザーを招待する
1. メニューから［組織の管理］を選択し、次に［ユーザー］タブを選択します。
2. ［+ ユーザーの追加］を選択します。
3. 国または地域と希望の言語を選択し、ユーザーの役割（閲覧者、コントリビューター、管理者）を選択します。
4. （任意）ユーザーをプロジェクトに割り当てます。プロジェクトの［概要］ページから、いつでもユーザーを割り当てることができます。
5. ユーザーのメールアドレスを入力し、［招待］をクリックします。一度に最大20人のユーザーを招待できます。各メールアドレスはカンマで区切ってください。招待は24時間後に期限切れになります。
APIプロジェクトを作成する
1. メニューから［マイプロジェクト］を選択し、次に［API］タブを選択して［+ APIプロジェクトの作成］を選択します。
2. APIの必要な要件を確定します。
3. プロジェクトに含めるAPIを選択します。
4. プロジェクト名を作成し、出荷予定国を選択すると、テスト出荷アカウントが発行されます。欧州域内の貨物については、国ごとに個別のテストアカウントが必要です。国は後で追加または削除できます。
5. 通知設定を変更するには、［通知］の下にある［設定］を選択してください。
6. 利用規約を読み、同意してください。
Advanced Integrated Visibilityプロジェクトを作成する
1. アプリケーションまたはプラットフォーム内で、コールバックを受信するための仕向地URLを作成します。URLは以下の条件を満たしていなければなりません。
- HTTPSを使用する
- RFC1918 IPアドレス空間、fedex.comおよびそのサブドメイン、ならびにlocalhostや127.0.0.1などのIPアドレスを除外する
2. 認証用のセキュリティトークンを生成します。トークン以下の条件を満たしていなければなりません。
- 26～100文字で構成され、少なくとも1つの大文字、少なくとも1つの小文字、および少なくとも1つの数字を含む
3. メニューから［マイプロジェクト］を選択し、次に［Advanced Integrated Visibility］タブを選択します。
4. ［Advanced Integrated Visibilityプロジェクト］の作成を選択します。
5. ユーザータイプを選択します。
- FedEx荷送人：FedExで出荷し、自社アプリケーションにFedEx APIを統合する必要がある
- FedEx Compatible Provider：認定されたFedEx Compatible Providerである
- FedEx Integrator Provider：FedExの技術を使用したソフトウェアソリューションを販売または提供し、FedEx認定インテグレータープロバイダーである
6. サブスクリプションの種類を選択します。イベントは、アカウント・ナンバーまたは追跡番号で登録できます。
7. 請求先アカウントを確認し、配達証明、配達予定日、配送状況追跡、イベントに基づくフィルタリングなど、必要な機能を選択します。
8. プロジェクトの詳細を入力します。
- ユニークで認識しやすいプロジェクト名を入力してください。
- 仕向地のURLと作成したセキュリティトークンを入力してください。
- Advanced Integrated Visibilityのアップデートおよびサービス停止に関する通知を受け取るためのメールアドレスと希望の言語を入力してください。
9. FedEx Developer Portalライセンス契約および注文書に同意し、［作成］を選択します。
注意：選択したサブスクリプションの種類によっては、追加のステップが必要になる場合があります。詳細については、FedExのWebhookドキュメントをご覧ください。
以下のステップに従ってAPI統合を検証し、アプリケーションがテストデータの送受信を実行できるかを確認してください。
テスト認証情報を取得する
1. メニューから［マイプロジェクト］を選択し、次に［プロジェクト名］を選択します。
2. ［APIキー］タブの［テストキー］で、テスト用の認証情報を探します。
3. ドキュメントページ上部の［JSONのダウンロード］スキーマをボタンを使用して、サインインし、JSON APIコレクションをダウンロードします。統合で使用するエンドポイントの例となるリクエストを確認してください。
4. すべてのAPIトランザクションで使用するOAuthアクセストークンをリクエストします。
注意：トークンは1時間有効であり、期限切れ前に更新するようアプリケーションを設定できます。詳細は、API Authorizationドキュメントをご覧ください。
5. メニューから［APIカタログ］を選択し、操作したいAPIを選び、［ドキュメント］を選択します。
6. ［メニュー］からエンドポイントを選択します。
7. テスト用認証情報とFedExテストURLを使用してサンプルリクエストを送信し、応答がドキュメントの例と一致することを確認します。詳細は、サンドボックス仮想化ガイドを参照してください。
8. Advanced Integrated Visibilityを使用してテストを実行し、サンプルデータを生成して、アプリケーションが追跡情報を正しく処理することを確認します。
注意：テストではコールバックURLの認証は行われません。詳細は、Advanced Integrated Visibilityドキュメントを参照してください。
プロジェクトを本番環境に移行する
本番環境に移行する前に、本番構成を設定してください。キーの名前を変更したり、プロジェクト公開後に追加アカウントを追加したり、プロジェクト作成時に選択したアカウント・ナンバーを確認したりできます。このアカウント・ナンバーにより、プロジェクトが本番環境に移行されます。
注意：アカウント・ナンバーに基づくAdvanced Integrated Visibilityプロジェクトは、本番環境では有効化する必要はありません。
1. メニューから［マイプロジェクト］を選択し、次に［プロジェクト名］を選択します。
2. ［プロダクションキー］タブを選択します。
3. 本番環境の認証情報を安全に取得し、保管します。
- 本番用APIキーとシークレットキーを安全な場所にコピーしてください。
- プロダクションキーをリクエストする際は、一度しか表示されないため、安全な場所に保存してください。紛失した場合、後で新しいものを再生成することができます。
4. ［次へ］を選択し、［プロダクションキー］タブでプロジェクトの詳細を確認します。
出荷アカウントを追加するには、出荷アカウント表の上部にある［編集］を選択してください。
検証ステップは地域によって異なります。
以下のステップは、米国およびカナダのお客様にのみ適用されます。これらの国以外にお住まいの方でサポートを必要とされる方は、API検証ページをご確認ください。
APIの検証
一部のFedEx APIでは、本番環境で使用する前に出荷ラベルの検証が必要です。開始前にAPI検証要件を確認してください。
1. メニューから［マイプロジェクト］を選択し、次に［プロジェクト名］を選択します。
2. ［APIキー］タブの［テストキー］で、テスト用の認証情報を探します。
3. テスト完了後、FedEx Developer Portalでプロジェクトを本番環境に移行し、検証を開始します。
- プロダクションキーをリクエストする際は、一度しか表示されないため、安全な場所に保存してください。紛失した場合、後で新しいものを再生成することができます。
4. ラベルカバーシートに、連絡先情報、導入予定のサービス、アカウント・ナンバー、および本番環境用APIキーを含む必要な情報を記入します。
5. FedExテスト環境でテストラベルを作成し、FedExバーコード分析グループに送信してレビューを受けます。ラベル評価には3営業日を要します。
遅延を避けるためのベストプラクティス
- ラベルは最低600 DPIで印刷およびスキャンしてください。APIから直接生成されたファイルを送信しないでください。
- サーマルプリンターの場合、お使いのプリンターに適合するイメージタイプを指定してください。例えば、ZebraプリンターにはZPLIIを指定します。
- サンプルラベルには有効な荷送人および荷受人の住所を使用し、利用する予定のサービスのみにラベルを作成してください。
- FedEx着払い（C.O.D.）の場合、C.O.D.返送ラベルを同封してください。
- FedEx International Express®をご利用の場合は、補助（二次）航空貨物運送状（AWB）を含めてください。
- 複数個口貨物（MPS）の場合、各パッケージごとに1枚のラベルを送信してください。
以下のいずれかの方法で資料を送信してください。
- PDFおよびラベルカバーシートをlabel@fedex.com宛てにEメールで送信してください。
- ラベルの郵送先：
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
注意：ラベルにインクの線や損傷などの目に見える欠陥がないことを確認してください。印刷時にラベルを拡大または縮小しないでください。
6.FedExのバーコード分析グループが提出内容を審査し、ラベルを承認または却下します。ラベルが却下された場合は、フィードバックに対応し、再送信してください。
7. 承認後、FedExバーコード分析グループは、出荷ラベルトランザクションのための本番環境認証情報を承認した後、Eメールで通知します。
注意：承認はプロジェクトごとに適用されます。新しいプロジェクトはそれぞれ承認が必要です。
8. テスト用URLと認証情報を本番環境のURLと認証情報に置き換えます。
9. サンプルデータを用いた最終的な本番テストを実行し、すべてが期待通りに動作することを確認します。
