加入您公司的組織,與您的團隊協作。若您的公司沒有組織,您可建立一個組織。
加入現有組織
1.要求邀請
要求您組織的管理員向您傳送邀請。您需在24小時內接受邀請。如邀請已過期,請要求管理員重新傳送。
2.接受邀請
利用您現有的用戶ID和密碼登入。若您的用戶ID已與其他組織相關聯,請建立新的ID。
建立新組織
若您建立組織,您會成為組織的管理員。作為管理員,您可邀請用戶加入組織、指派項目和用戶身份,並管理託運帳戶。
如要了解用戶身份的更多資訊,請參閱《組織管理指南》。
1.登入FedEx Developer Portal。
2.從選單中選擇「我的項目」,然後選擇「建立組織」。
3.輸入下列詳細資訊:
- 在「我任職的公司」中,選擇「利用FedEx託運服務,並需將FedEx API整合至自家應用程式」
- 輸入您的公司名稱、公司網站及供團隊識別的組織名稱,例如您的公司名稱、部門、分部或地區。
4.選擇「建立」。
您可稍後在選單的「管理組織」下更新或新增詳細資訊。
新增託運帳戶
1.在「新增帳戶」模組上選擇「新增託運帳戶」。若您尚未擁有FedEx帳戶,請選擇「建立帳戶」以開立新帳戶,或者聯絡FedEx支援團隊。
2.選擇「+新增帳戶」。
3.輸入您在設置帳戶時使用的FedEx帳戶號碼、帳戶暱稱和帳單地址。
4.接受《終端使用者授權合約》,或者將該合約轉交予您公司的授權代表。
新增付款帳戶
1.選擇「付款帳戶」索引標籤。若您沒有FedEx付款帳戶,請選擇「開立付款帳戶」以開立新帳戶,或者聯絡FedEx支援部。
2.選擇「新增付款帳戶」。付款帳戶必須位於美國。
3.輸入您在設置帳戶時使用的FedEx帳戶號碼、帳戶暱稱和美國帳單地址。
4.細閱並接受《終端使用者授權合約》。
以管理員身分邀請用戶
1.從選單中選擇「管理組織」,然後選擇「用戶」索引標籤。
2.選擇「+新增用戶」。
3.選擇國家或地區及首選語言,然後選擇用戶身份:檢視者、研發員或管理員。
4.(可選填)將用戶指派給項目。您可隨時在項目的「概覽」頁面指派用戶。
5.輸入用戶的電郵地址,然後點擊「邀請」。您每次最多可邀請20位用戶,以逗號分隔每個電郵地址。邀請會於24小時後失效。
建立API項目
1.從選單中選擇「我的項目」,然後選擇「API」索引標籤,並選擇「+建立API項目」。
2.確認您的API需求。
3.選擇要加入項目中的API。
4.建立項目名稱,並選擇您打算託運的國家/地區,以接收測試託運帳戶。如為歐洲本地貨件,您需為每個國家/地區建立獨立的測試帳戶。您可稍後再新增或移除國家/地區。
5.選擇「通知」下的「設定」,設定您的通知偏好設定。
6.細閱並接受條款及細則。
建立「進階集成可見性」項目
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.利用「進階集成可見性」執行測試,以產生樣本資料,並確認您的應用程式正確處理貨件查詢資訊。
請注意:測試無法驗證您的回呼網址。如需詳細資訊,請參閱進階集成可見性說明文件。
將您的項目轉換為正式版
在項目上線前,設置正式版配置。您可將金鑰重新命名、在項目上線後新增其他帳戶,以及查看於項目建立期間所選擇的帳號。此帳號會將您的項目轉換為正式版。
請注意:基於帳號的「進階集成可見性」項目無需正式版啟動。
1.從選單中選擇「我的項目」,然後選擇「項目名稱」。
2.選擇「正式版金鑰」索引標籤。
3.檢索並安全保管您的正式版憑證。
- 將正式版API金鑰和秘密金鑰複製至安全位置。
- 正式版金鑰僅會顯示一次,當您索取時,請將該金鑰保管於安全位置。如果您遺失金鑰,便需要稍後重新產生新的金鑰。
4.選擇「下一步」,以在「正式版金鑰」索引標籤上檢視項目詳細資訊。
如需新增更多託運帳戶,請在託運帳戶表格頂部選擇「編輯」。
驗證您的API
部分FedEx API需要先驗證託運標籤,方可在正式版中使用。開始前,請先參閱API驗證要求。
1.從選單中選擇「我的項目」,然後選擇「項目名稱」。
2.在「API金鑰」索引標籤的「測試金鑰」下,找到您的測試憑證。
3.測試完成後,請在FedEx Developer Portal中將您的項目轉換為正式版,以開始驗證。
- 正式版金鑰僅會顯示一次,當您索取時,請將該金鑰保管於安全位置。如果您遺失金鑰,便需要稍後重新產生新的金鑰。
4.請在標籤封面頁上提供必要資料,包括聯絡資料、您計劃實施的服務、帳號及正式版API金鑰。
5.在FedEx測試環境中建立測試標籤,然後將標籤提交予FedEx條碼分析團隊進行審查。請預留三個工作天以評估標籤。
避免延誤的最佳做法:
- 以最低600 DPI列印及掃描標籤。請勿提交直接從API產生的檔案。
- 如使用熱敏打印機,請索取適用於該打印機的圖片類型,例如:ZPLII適用於Zebra打印機。
- 使用有效的寄件人和收件人地址製作標籤樣本。僅為您計劃使用的服務建立標籤。
- 如需使用FedEx貨到付款 (C.O.D.),請附上 C.O.D. 回件標籤。
- 如需使用FedEx International Express®,請附上輔助(次要)空運提單 (AWB)。
- 如為多包裹貨件 (MPS),請為每個包裹提交一張標籤。
請使用下列其中一個選項,提交您的材料:
- 將PDF及標籤封面頁電郵至:label@fedex.com。
- 將實體標籤郵寄至:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
請注意:如為實體標籤,請確保沒有可見的缺陷,例如墨水線條或損壞。列印時,請勿放大或縮小標籤。
6.FedEx條碼分析團隊會審查您提交的資料,並批准或拒絕標籤。如果標籤被拒絕,請按指示處理標籤並重新提交。
7.批准後,FedEx條碼分析團隊會授權您的託運標籤交易正式版憑證,然後向您傳送電郵通知。
請注意:每個項目均須經批准。每個新項目均需經批准。
8.以正式版網址及憑證取代測試網址及憑證。
9.以樣本數據執行最終正式版測試,確認一切運作符合預期。
