簡介
貿易文件上傳 API 是 FedEx 國際託運文件上傳解決方案,可簡化您的全球託運需求,讓您以電子化方式上傳國際貨件所需的海關文件。您可以透過電子方式提交大部分的貿易文件,進而減少列印或附加貨件貿易文件的麻煩。
相較於附加至貨件的紙本文件,海關和其他機構會更快收到以電子化方式傳送的文件。由於在託運初期即完成重要貿易資訊的獲取和分享,因此亦可優化海關清關程序。
附註:
- 在某些情況下,您仍需要將特定國際文件的正本附加於包裹。如需詳細資訊,請參閱「出口文件」章節。
- 為讓海關清關順利進行及避免延遲,請確認文件清晰易讀且無任何文字扭曲情形。
貿易文件上傳 API 詳細資料
上傳您的海關文件或使用 FedEx 產生的貿易文件。您也可以上傳公司信箋抬頭/標誌和數位簽名影像,以自訂 FedEx 產生的電子貿易文件。以電子化方式上傳文件可省去手動為所有貨件的海關文件簽屬、摺疊、整理和貼附的麻煩。此外,亦可節省紙張、能源及列印成本。
以下是與此應用程式開發介面 (API) 關聯的功能:
上傳文件
您可以使用託運 API 在建立貨件之前 (出貨前) 或建立貨件之後,一次上傳一份文件。
附註:本文中所提到的建立貨件適用於託運 API - Create Shipment、Open Ship API - Create Open Shipment 及貨運 LTL API- Ship Freight LTL 端點。
上傳多份文件
在託運前和託運後,您每一個上傳請求最多可上傳五份文件。
上傳多份編碼文件
您可以在建立貨件之前 (託運前) 或建立貨件之後 (託運後),一次上傳多份採用 Base64 編碼的文件 (最多五份)。使用此選項,萬一上傳的文件遭遇攔截 (低機率) 時,可以為文件資料提供額外的安全防護。
上傳影像
此功能可讓您上傳自訂的公司信箋抬頭/標誌和數位簽名影像,並用於 FedEx 產生的文件或報告中。首先,請將公司信箋抬頭/標誌和數位簽名影像上傳至 FedEx 伺服器,然後使用 shippingDocumentSpecification 底下的 customerImageUsages 元素,在您的貨件請求 (Create Shipment 端點) 中為個別文件提供這些上傳參考資料。
數位簽名或信箋抬頭/公司標誌會列印在 FedEx 產生的下列文件和報告上:
- 商業發票
- 原產地證明
- OP900
- 形式發票
- USMCA 原產地證明
- USMCA 商業發票和原產地證明
附註:
- 數位簽名 – 簽名限制為 240x25 像素,影像可為 GIF、PNG 格式。
- 公司信箋抬頭/標誌 – 標誌限制為 700x50 像素,影像可為 GIF、PNG 格式。
貿易文件上傳 API 工作流程
在出貨前或出貨後的情況下,您可以使用下列流程上傳文件。
出貨前文件上傳:
託運前文件上傳包含在貨件建立之前,使用此 API 上傳文件。成功上傳文件後,您稍後就可以在貨件請求中為上傳的文件參考資料建立關聯。
此為標準方法,可在確認出貨前上傳您的貿易文件。
執行出貨前文件上傳的步驟如下:
- 根據您的需求,使用下列任一端點
- 上傳文件
- 上傳多份文件
- 上傳編碼的文件
- 提供 workflowName 值做為 ETDPreShipment,以表示其為託運前上傳。
- 提供要上傳的實際檔案或採用 Base64 編碼的檔案。
- 提供文件詳細資料 (商業發票、原產地證明、出口申報單等),其中包括文件類型,以及與文件相關聯的貨件中繼資料。
- 若請求成功,則會將文件上傳至 FedEx 伺服器,並回傳唯一識別碼 (例如 docId) 做為成功的權杖。
- 使用 Create Shipment/Create Open Shipment/Ship Freight LTL 端點。
- 在您所選的 Shipping 端點提供 shipmentSpecialService/specialServiceTypes 做為 ELECTRONIC_TRADE_DOCUMENTS,然後將 docId 值傳遞至 shipmentSpecialServices/etdDetail/attachedDocuments/documentId 元素。 注意:若為多包裹貨件 (MPS),請指定為貨件中所有包裹上傳文件時所產生的 docId。
- 若貨件請求成功,則會向 FedEx 確認電子貿易文件 (ETD) 貨件,並產生追蹤和標籤詳細資料,而 completedEtdDetail 物件會回傳上傳文件的類型和文件識別碼作為參考資料。
- 若為託運前文件上傳,您可以一次上傳 1 份文件或同時最多一起上傳 5 份文件,然後同時為貨件提供所有文件識別碼。
出貨後文件上傳 (PSDU):
出貨後文件上傳 (PSDU) 可讓您在送出貨件且產生追蹤標籤後上傳文件。於此情況下,在建立貨件且產生追蹤號碼後,請在您的文件上傳請求中為此追蹤號碼建立關聯。
如果客戶建立自己的商業發票並透過第三方或遠端辦公室建立海關文件,則此方法會相當方便。
使用此方法時,請務必記住以下幾點:
- 在建立上傳請求前,您應準備好貨件追蹤號碼和託運日期。
- 您應注意寄件人的服務站截件時間,以便及時提交文件。
此 API 也支援提交未來貨件和當天貨件的海關文件。
執行出貨後上傳的步驟如下:
- 使用 Create Shipment/Create Open Shipment/Ship Freight LTL 端點。
- 在 Create Shipment 端點根據你的選擇,指明以下詳細資料。
- 提供 shipmentSpecialServices/specialServiceTypes 作為 ELECTRONIC_TRADE_DOCUMENTS。
- 提供 shipmentSpecialServices/etdDetail/attributes 作為 POST_SHIPMENT_UPLOAD_REQUESTED。
- 若貨件請求成功,則會向 FedEx 確認貨件,並產生追蹤和標籤詳細資料。
- 根據您的需求,使用下列任一端點。
- 上傳文件
- 上傳多份文件
- 上傳多份編碼的文件。
- 提供 workflowName 值作為 ETDPostShipment,以表示其為出貨後上傳。
- 提供要上傳的實際檔案或採用 Base64 編碼的檔案。
- 提供文件詳細資料 (商業發票、原產地證明、出口申報單等)。
- 在 document/meta/trackingNumber 和 document/meta/shipmentDate 元素底下,提供已處理的託運後文件上傳 (PSDU) 貨件的 trackingNumber 和 shipmentDate。
注意:若為多包裹貨件 (MPS),請在上傳文件時使用主貨件追蹤號碼。針對主貨件提供的電子貿易文件 (ETD) 詳細資料亦適用於子貨件。 - 若請求成功,則會將文件上傳至 FedEx 伺服器,並將上傳的文件與貨件建立關聯。
以下是貿易文件上傳應用程式開發介面 (API) 的功能,可讓您上傳與貨件文件相關的文件和影像。
貿易文件上傳 API 的運作方式
以下是 Trade Documents Upload API 的功能,可讓您上傳與貨件文件相關的文件和影像。
上傳文件
使用此端點在出貨前和出貨後上傳貿易文件。
以下為與此請求相關聯的必填輸入資訊:
- attachment – 要上傳的實際檔案。
- workFlowName – 針對出貨前上傳提供 ETDPreShipment,並針對出貨後上傳提供 ETDPostShipment。
- document – 提供文件詳細資料和貨件中繼資料。
- trackingNumber – 提供要上傳文件之出貨後文件上傳 (PSDU) 貨件的追蹤號碼。出貨前上傳不一定要使用此項目。
- shipmentDate – 此為託運日期。出貨前上傳不一定要使用此項目。
對於託運前上傳,得到成功回應後,系統就會將文件上傳至 FedEx 伺服器,並傳回 docId。此 docId 將用於實際的貨件中,以提交貨件並產生標籤。
如果是出貨後上傳,得到成功回應後,系統就會將文件上傳至 FedEx 伺服器,並將上傳的文件與已確認的貨件建立關聯。
上傳影像
使用此端點上傳自訂簽名和信頭影像/公司標誌,並可將其套用在託運文件上。
以下是與此請求相關的必填輸入資訊:
- attachment – 此為影像檔案。
- document – 提供檔案名稱、內容類型及檔案中繼資料等影像詳細資料。
若請求成功,則會將簽名和信箋抬頭影像/公司標誌上傳至 FedEx 伺服器,並傳回 imageIndex。接著,此索引便會在您的貨件請求中傳遞給 shippingDocumentSpecification 底下的 customerImageUsages 個別文件元素,以確保自訂影像或信箋抬頭會列印在貨件文件上。
上傳多份文件
使用此端點在託運前和託運後上傳貿易文件 (最多五份)。以下為與此請求相關聯的必填輸入資訊:
- workFlowName – 針對託運前上傳提供 ETDPreShipment,並針對託運後上傳提供 ETDPostShipment。
- fileName – 提供隨著副檔名類型一起更新的文件名稱或檔案名稱。範例:COD.PDF
- contentType – 從可用選項中提供要上傳的檔案類型和格式。
- shipDocumentType – 提供要上傳的文件類型。
若要取得個別文件的詳細資訊,請參閱本頁的「上傳文件」一節。這是您可以選擇的文件類型清單:
- CERTIFICATE_OF_ORIGIN COMMERCIAL_INVOICE
- ETD_LABEL
- USMCA_CERTIFICATION_OF_ORIGIN
- USMCA_COMMERCIAL_INVOICE_CERTIFICATION_OF_ORIGIN
- 其他
- PRO_FORMA_INVOICE
- carrierCode – 提供 FedEx 營運公司四字母代碼。範例:FDXE
- originCountryCode – 提供貨件的原產國家/地區代碼。
- destinationCountryCode – 提供貨件的目的地國家/地區代碼。 請注意:參閱「參考指南」以搜尋您的國家或地區代碼。範例:US
- shipmentDate – 針對託運後上傳,提供實際的貨件日期。
- trackingNumber – 針對託運後上傳,提供貨件追蹤號碼。範例:7825XXXXXXX。
如果是託運前上傳,得到成功回應後,系統就會將多份文件上傳至 FedEx 伺服器,並傳回文件識別碼 (docId)。此 docId 將用於實際的貨件中,以提交貨件並產生標籤。
如果是出貨後上傳,得到成功回應後,系統就會將多份文件上傳至 FedEx 伺服器,並將上傳的文件與已確認的貨件建立關聯。
上傳多份編碼文件
使用此端點在託運前和託運後上傳採用 Base64 編碼的貿易文件 (最多五份)。
以下為與此請求相關聯的必填輸入資訊:
- workFlowName – 針對出貨前上傳提供 ETDPreShipment,並針對出貨後上傳提供 ETDPostShipment。
- carrierCode – 提供 FedEx 營運公司四字母代碼。範例:FDXE
- contentType – 從可用選項中提供要上傳的檔案類型和格式。
- shipDocumentType – 提供要上傳的文件類型。
若要取得個別文件的詳細資訊,請參閱本頁的「上傳文件」一節。這是您可以選擇的文件類型清單:
- CERTIFICATE_OF_ORIGIN COMMERCIAL_INVOICE
- ETD_LABEL
- USMCA_CERTIFICATION_OF_ORIGIN
- USMCA_COMMERCIAL_INVOICE_CERTIFICATION_OF_ORIGIN
- 其他
- PRO_FORMA_INVOICE
- originCountryCode – 提供貨件的原產國家/地區代碼。
- destinationCountryCode – 提供貨件的目的地國家/地區代碼。 請注意:參閱「參考指南」以搜尋您的國家或地區代碼。範例:US
- fileContentBase64 – 指明 Base64 檔案的位元組程式碼內容,以便上傳。
如果是託運前上傳,得到成功回應後,系統就會將編碼文件上傳至 FedEx 伺服器,並傳回文件識別碼 (docId)。此 docId 將用於實際的貨件中,以提交貨件並產生標籤。
如果是託運後上傳,得到成功回應後,系統就會將編碼文件上傳至 FedEx 伺服器,並將上傳的文件與已確認的貨件建立關聯。
上傳文件
以下是可透過此 API 送出的文件:
原產地證明 (COO)
COO 是用於確認產品製造國家/地區的國際文件。部分國家/地區會禁止從特定國家/地區進口,多數國家/地區會限制進口物品的數量,而有些國家/地區則會為特定國家/地區製造的物品提供優惠待遇。
商業發票 (CI)
此為賣方/出口商提供的文件,內容說明託運交易之相關當事方及欲運輸的物品。此為海關使用的主要文件,應盡量以物品進口國家/地區的官方語言製作。商業發票應包含貨件全部品項之詳細陳述,包括:適當的物品描述 (內容物是什麼?物品成分為何?物品的用途為何?)、數量、製造國家/地區、價格或成本、使用幣別、各商品的國際商品統一分類號碼及遞送條款。有些國家/地區要求簽署印有寄件人信頭的發票正本。出口商應一律在發票上簽名並填上日期,證明文件所提供之詳細資料屬實,且正確反映商業發票涵蓋的內容。
如需更多資訊,請造訪我們的 Global Trade Manager。
電子貿易文件 (ETD) 標籤
此為具備郵政貨件文件上傳條件的貨件採用電子貿易文件(ETD) 特殊服務所產生的貨件標籤。此貨件標籤也可連同其他書面文件一起上傳。
形式發票
形式發票會在完成銷售前核發。收到供應商的形式發票後,購買人會向供應商傳送採購單或開立信用狀。賣方需根據合議的出貨日期,準備好託運物品。
USMCA 商業發票和原產地證明
如果物品屬於以下三個美國-墨西哥-加拿大協議 (USMCA/T-MEC/CUSMA) 參與者其中之一的產品,且符合入關減稅或免稅資格,則需要 USMCA 原產地證明 (COO):加拿大、墨西哥及美國。該證明須由物品的出口商或製造商填寫。
USMCA 原產地證明
如果物品屬於以下三個美國-墨西哥-加拿大協議 (USMCA/T-MEC/CUSMA) 參與者其中之一的產品,且符合入關減稅或免稅資格,則需要 USMCA 商業發票和原產地證明 (COO):加拿大、墨西哥及美國。該證明須由物品的出口商或製造商填寫,並隨附商業發票。
其他
以下章節說明幾種歸類為其他文件的常用文件。此類文件並非託運貨件時須強制上傳的文件,但可能必須在個別貨件進行海關清關提出。根據貨件類型、寄件地、目的地和其他因素,文件可能不同。
- 包裝清單
- FCC 740 有關射頻裝置導致有害干擾至進口之聲明
- 影片影帶申報
一份空運提單中如果有多個包裹,或者貨件重量超過 100 公斤,則需要檢附包裝清單。請注意,根據託運商品而定,這項要求在各別市場可能也有不同。此清單必須正確並清晰說明貨品、數量與重量。
託運具有無線射頻裝置的電器時,如果該裝置可能造成有害干擾,就必須檢附聯邦通信委員會 (FCC) 740 表單。此表包含裝置型號/類型名稱、國際商品統一分類關稅代碼、製造商名稱與地址、收件人姓名與地址,以及進口商名稱與地址等詳細資訊。
電影影片申報單:此為託運電影/影片時提交的申報文件,用於聲明不含猥褻或不道德內容,也不含任何提倡或主張反叛美國的內容。文件包含電影/影片長度、電影/影片拍攝期間以及簡短內容概要等詳細資訊。
免責聲明:以上資訊可能隨時變更。
「其他」文件僅在國家/地區、產品及其他特殊海關文件有要求時才需上傳。若要檢視多數其他常用文件清單,請按一下出口文件。
海關文件和要求
國內和國際託運必須具備準確的文件。每個國家/地區都有具體的國際託運法律與規範。若為美國出口託運,則美國和目的地國家/地區需要不同類型的法規文件。
附註:除了 FedEx 國際空運提單、FedEx International Next Flight 空運提單或 FedEx International Mail Service 空運提單 (例如,商業發票) 之外,如果貨件還需要其他文件,就可能需要更多運輸時間。
管控商品
跨國託運下列商品時,請確認您所選擇的 FedEx 服務接受將這些商品遞送至目的地國家/地區及城市:
- 危險物品
- 國際武器貿易條例 (ITAR)
- 例外數量的危險物品。
附註:若要託運例外數量的危險物品,請使用特殊服務選項 SMALL_QUANTITY_EXCEPTION。 - 微量放射性包裹
免責聲明:以上資訊可能隨時變更;如需詳細資訊,請前往服務指南,或聯絡您的 FedEx 代表。
加拿大出口貨件的出口報單
針對下列情況,必須向加拿大邊境服務局 (CBSA) 提交出口報單以報告加拿大的出口情況。
- 所有包含非限制物品的加拿大出口貨件,如有商用物品價值達 $2,000 加幣或以上,且物品目的地為美國、波多黎各或美屬維京群島以外之國家/地區,就必須提交此出口報單。
- 所有加拿大出口貨件當中包含管制、限制或受到監管之物品者,無論其價值,均必須提交此出口報單。
承運人必須在物品起運離開加拿大之前,先行向出口商索取報告證明編號。出口商必須先送出出口報單,再向承運人提供報告證明編號。
電子出口資訊 (EEI)
EEI 是使用自動化商業環境 (ACE) 中的 AESDirect 填入自動化出口系統 (AES) 的電子出口資料。ACE 安全資料入口網站 (ACE 入口網站) 為貿易共同體的集中式存取點,可連結美國海關暨邊境保護局 (CBP)。
電子出口資訊 (EEI) 等同於電子版的商務部 (Census Bureau) 7525-V 寄件人出口申報單 (SED),但美國政府已不再受理後者。電子出口資訊 (EEI) 中包含國際貨件交易的所有相關出口資料,可提供出口統計與掌握用途。
商品如登載於商業管制清單 (CCL),則電子出口資訊 (EEI) 為必要資料,須由出口商或代理人以電子方式透過自動化出口系統 (AES) 提交。
如果貨件從美國、美屬維京群島或波多黎各寄至中國、俄羅斯、委內瑞拉和香港,無論貨件價值為何,您都必須提供以下資訊:
- 登錄於電子出口資訊 (EEI) 的內部交易號碼 (ITN)
- 每件物品的出口管制分類號碼 (ECCN) 或 EAR99 分類號碼,或
- 適用的登錄豁免文件
如果貨件符合以下條件,可豁免登錄。
- 符合許可證例外 GOV 資格
- 符合出口管理條例和國際貿易法規 (FTR) 的例外條件,或
- 僅包含分類為 EAR99 的物品
附註:從美國出口貨件至其他目的地時,如果任何指定日期的集中託運貨件中有一或多件商品 (B 類編號) 總價值超過 $2,500 美元,您便必須登錄電子出口資訊 (EEI)。
寄件人指示信 (SLI)
SLI 包含美國客戶的國際貨件資訊。
附註:
- 貨件運往加拿大時,我們包含報關的服務會為您完成清關,但需收取費用。並非所有電子產品託運解決方案都適用含報關的服務。
FedEx International Ground® 包裹配送服務可讓 FedEx Ground® 以同一批 FedEx International Ground® 貨件的形式集中託運,僅在一次入關中以單筆報關費用完成清關與處理。
貿易文件上傳 API 的優點
以下是與貿易文件上傳應用程式開發介面 (API)/功能相關的部分優點:
- 減少海關清關問題可降低海關延遲情形,同時增加託運的可靠性和賣家的商譽。
- 您不需要為個別包裹列印及比對多份書面文件,因此可獲得更多創造業務的時間,進而提高公司生產力和利潤。
- 可將公司信頭和簽名影像新增至 FedEx 產生的商業發票或形式發票。
- 獲得更多時間,以便在貨件送達之前,解決海關文件的問題 (例如缺少資訊)。
- 可讓您針對送往加拿大的 FedEx International Ground 貨件,以電子方式提交商業發票。
- 將未來貨件或今天日期到未來 10 天任何日期的海關文件提交至 FedEx。
- 讓您更加安心;發票並未附在包裹上,因此商品資訊不會洩漏給第三方。
- 減少紙張、碳粉、託運材料的消耗及印表機的使用,進而減少碳足跡。
- 由於包裹上沒有發票,商品資訊不會洩露給第三方,因此可降低貨件遭竊的機率。
- 在國際運輸時,節省時間並減少錯誤。
- 此上傳文件功能可用於進口和出口貨件。請檢視適用國家/地區清單,查看您的出口/進口國家/地區是否接受上傳文件。
- 您可透過 FedEx 文件準備中心和「國際文件說明」一節,在線上準備、儲存及重複使用上傳的文件。
商務規則
以下是與上傳文件應用程式開發介面 (API)/功能相關的重要商務規則:
- 上傳文件的有效檔案類型為 PDF、TXT、PNG、JPG、GIF、BMP、TIF、RTF、DOC、DOCX、XLS 及 XLSX。
- 您最長可以在託運前 10 天上傳文件。
- 每個上傳的貿易文件或影像不可超過 5 MB。
- 數位簽名影像的限制為 240x25 像素,影像可為 GIF、PNG 格式。
- 公司信頭/標誌的限制為 700x50 像素,影像可為 GIF、PNG 格式。
- 根據海關規定,部分寄件地/目的地可能不接受信頭影像。
- 影像將以原樣上傳,FedEx 不會提供任何修正。
- 您可以使用下列特殊處理和服務選項,以電子方式上傳海關文件:
- 乾冰
- 危險物品
- 危險材料
- 只要「上傳」啟用,寄件地為美國 (U.S.)、亞太地區、加拿大 (CA) 及歐盟 (EU) 國家/地區的 TPC (第三方收件人) 貨件即須使用此功能。
- 所有具有電子文件的貨件均須在請求託運日當天建立、上傳及收件。
- 使用出貨後文件上傳 (PSDU) 時,請務必在包裹取件前上傳文件。
Response