FedEx 整合供應商
先決條件
您必須擁有FedEx用戶ID，方可登入FedEx Developer Portal並建立組織。
加入您公司的組織，與您的團隊協作。若您的公司沒有組織，您可建立一個組織。
加入現有組織
1.要求邀請
要求您組織的管理員向您傳送邀請。您需在24小時內接受邀請。如邀請已過期，請要求管理員重新傳送。
2.接受邀請
利用您現有的用戶ID和密碼登入。若您的用戶ID已與其他組織相關聯，請建立新的ID。
建立新組織
若您建立組織，您會成為組織的管理員。作為管理員，您可邀請用戶加入組織、指派項目和用戶身份，並管理付款帳戶。
如要了解用戶身份的更多資訊，請參閱《組織管理指南》。
1.在導覽列中選擇「建立或加入組織」。
2.輸入下列詳細資訊：
- 在「我任職的公司」中，選擇「出售或提供使用FedEx技術的軟件解決方案，且希望註冊成為經驗證的FedEx整合供應商」
- 輸入您的公司名稱、公司網站及供團隊識別的組織名稱，例如您的公司名稱、部門、分部或地區。
- 輸入包含您公司網域名稱、註冊所在國家或地區，以及經營軟件解決方案銷售或經銷業務之國家及地區的官方電郵。
3.選擇「下一步」。
您可稍後在選單的「管理組織」下更新或新增詳細資訊。
新增付款帳戶
1.選擇「付款帳戶」索引標籤。若您沒有FedEx付款帳戶，請選擇「開立付款帳戶」以開立新帳戶，或者聯絡FedEx支援部。
請注意：請使用您的帳號，而非顧客的FedEx帳戶號碼。
2.選擇「新增付款帳戶」。
3.輸入您在設置帳戶時使用的FedEx帳戶號碼、帳戶暱稱和美國帳單地址。
請注意：帳單地址必須與您在設置帳戶時使用的地址相符。此帳戶會成為您組織的預設付款帳戶。
4.選擇身份驗證選項。
- 電話通話僅適用於美國和加拿大的整合商。
5.輸入您收到的驗證碼，並選擇「提交」。
6.細閱並接受《FedEx整合商協議》。
以管理員身分邀請用戶
1.導覽至「管理組織」，然後選擇「用戶」索引標籤。
2.選擇+新增用戶。
3.輸入下列詳細資訊：
- 國家或地區
- 首選語言
4.選擇用戶身份（檢視者、研發員或管理員）。
5.（可選填）將用戶指派給項目。
- 您可隨時在項目的「概覽」頁面指派用戶。
6.輸入用戶的電郵地址，然後點擊「邀請」。
- 您每次最多可邀請20位用戶，以逗號分隔每個電郵地址。邀請於24小時內有效。
建立項目
1.從選單導覽至「我的項目」，然後選擇「+建立項目」。
2.輸入項目名稱。
- 建議使用「項目名稱_應用程式名稱」的名稱格式。完成後，選擇「下一步」。
3.為您的項目選擇API和「進階集成可見性」產品，以加入至項目中。
- 「進階集成可見性」產品僅適用於美國FedEx整合供應商。
- 若您選擇任何付費產品，系統將要求您為該項目指派付款帳戶，並接受必要的條款。
指派付款帳戶
請注意：僅當您選擇付費產品時，才需要指派付款帳戶。
1.從已新增至組織的帳戶清單中指派付款帳戶。付款帳戶必須位於美國。
2.接受FedEx Developer Portal授權合約和訂單表格，並選擇「建立」。
在項目中配置「進階集成可見性」
1.在您的應用程式或平台建立目的地網址，以接收回呼。網址必須：
- 使用HTTPS
- 不得包含RFC1918 IP空間、fedex.com及其子網域，以及IP位址，例如localhost或127.0.0.1
2.產生安全令牌以用於身份驗證。令牌必須：
- 包含26至100個字元，並且包含至少一個大寫字母、至少一個小寫字母及至少一個數字
3.從選單中選擇「我的項目」，然後選擇「進階集成可見性」索引標籤。
4.建立「進階集成可見性」項目。
5.選擇用戶類型：
- FedEx寄件人：利用FedEx託運服務，並需將FedEx API整合至自家應用程式
- FedEx Compatible供應商：是獲認證的FedEx Compatible供應商
- FedEx整合供應商：出售或提供使用FedEx技術的軟件解決方案，且公司是經驗證的FedEx整合供應商
6.選擇訂閱類型。您可按帳號或查詢號碼訂閱事件。
7.確認付款帳戶並選擇功能，例如送達證明、預計送達、查詢事件或事件篩選條件。
8.輸入項目詳情。
- 輸入獨特且容易識別的項目名稱。
- 輸入您建立的目的地網址和安全令牌。
- 輸入電郵地址和首選語言，以接收有關「進階集成可見性」最新消息和服務中斷的通知。
9.接受FedEx Developer Portal授權合約和訂單表格，並選擇「建立」。
請注意：視乎您所選的訂閱類型，您可能需完成額外步驟。如需詳細資訊，請參閱我們的Webhook說明文件。
請遵循以下步驟，以驗證您的API整合，並確認您的應用程式能夠傳送及接收測試資料。
1.從選單中選擇「我的項目」，然後選擇「項目名稱」。
2.在「API金鑰」索引標籤的「測試金鑰」下，找到您的測試憑證。
3.登入並使用說明文件頁面頂部的「下載JSON架構」按鈕，下載JSON API系列。檢視您的整合所用端點的要求範例。
4.索取OAuth存取令牌，以在每次API交易中使用。該令牌的有效期為一小時，您可將應用程式配置為於到期前自動重新整理。如需詳細資訊，請參閱API Authorization說明文件。
5.從選單中選擇API目錄，選擇您想使用的API，然後選擇說明文件。
6.從選單中選擇端點。
7.使用您的測試憑證和FedEx測試網址傳送要求範例，然後確認回應是否與說明文件的範例相符。如需詳細資訊，請參閱沙盒虛擬化指南。
8.利用「進階集成可見性」執行測試，以產生樣本資料，並確認您的應用程式正確處理貨件查詢資訊。
請注意：測試無法驗證您的回呼網址。如需詳細資訊，請參閱進階集成可見性說明文件。
驗證步驟因應地區而異
下列步驟僅適用於美國和加拿大的客戶。若您居住在其他國家／地區，請前往「API驗證」頁面尋求支援。
如需將API轉換為正式版，必須驗證API。驗證層級視乎API而異。開始前，請先參閱API驗證要求。
1.從選單中選擇「我的項目」，然後選擇「項目名稱」。
2.在API金鑰索引標籤的測試金鑰下，找到您的測試憑證。
3.針對您計劃部署解決方案的地區或地域，找出測試個案。如需詳細資訊，請參閱整合商測試個案基線。
4.在執行測試個案前，先利用所提供的測試帳號完成註冊交易。
5.完成所有必要的測試個案。
6.填妥「產品資訊工作表 (PIW)」，並填寫您的聯絡資料和所選擇的FedEx服務。
7.填妥「整合商驗證封面頁」。
提交交付項目
請將所有必要資料傳送至validationmtp@fedex.com。
1.準備以下交付項目：
- 已填妥的PIW (PDF)
- 已填妥的驗證封面頁 (PDF)
- 支援多重驗證的終端顧客註冊交易 (JSON)
- 所有適用測試個案的託運標籤掃描本（PDF或PNG）
- 三種標籤格式（PDF、PNG和ZPL (JSON)）的託運交易（用於適用的Shipping and Rate API）
- 顯示以下內容的螢幕截圖 (PDF)：
- 顯示FedEx服務及特別處理的顧客解決方案
- 免責聲明
- 終端使用者授權合約 (EULA)
- 終端客戶註冊流程
2.為免受電郵供應商限制，請將所有檔案壓縮為一個.zip檔案。
3.透過電郵將.zip檔案傳送給驗證團隊。
避免延誤的最佳做法
遵循以下指引，以縮短審查時間：
- 以最低600 DPI列印及掃描標籤。請勿提交直接從API產生的檔案。
- 如使用熱敏打印機，請索取適用於該打印機的圖片類型，例如：ZPLII適用於Zebra打印機。
- 如需使用FedEx International Express®，請附上輔助（次要）空運提單 (AWB)。
- 為多包裹貨件 (MPS) 中的每個包裹附上標籤。
標籤評估
驗證團隊會審查您提交的資料。
- 如標籤被拒絕，請按指示處理交付項目並重新提交。
- 如標籤獲批准，您將收到確認電郵。得到批准後，您的正式版憑證將獲授權進行託運標籤交易。
1.從選單中選擇「我的項目」，然後選擇「項目名稱」。
2.在API部分，複製並安全保管您的正式版API金鑰和秘密金鑰。
請注意：秘密金鑰僅會顯示一次，請將該金鑰保管於安全位置。如果您遺失金鑰，便需要稍後重新產生新的金鑰。
