在建立貨件之前或之後,請以電子方式上傳商業發票以加速清關
情境 1 - 建立貨件前文件上傳
目標:在建立貨件之前,上傳最多 5 份託運文件 (例如「商業發票」)
端點:使用 Upload Multiple Documents 端點。
動作:上傳您的文件
1. 傳送包含託運文件的請求 (例如「商業發票」)。
2. 對於每份成功上傳的文件,回應將包含 docID。
結果:您將收到每個成功上傳文件的 docID,您須在下一步中使用該 docID。
目標:在建立貨件時,與步驟 1 中的 docID 建立關聯。
端點:使用 Create Shipment 端點。
動作:
1. 在貨件建立承載中的 ShipmentSpecialServices.etdDetail.attachedDocuments.documentId 欄位下,加入上一步的 docID 值。
承載範例:
2. 在建立貨件的請求內文中,您需要在適當的結構下方,為步驟 1 中上傳的每份文件指定 documentId:
結果:您的文件現已連結至貨件並準備好提交。
目標:最後確認建立貨件並與附加文件一起送出。
動作:送出包含完整承載的貨件建立請求,其中包括步驟 2 的 documentId 值。
結果:系統會建立貨件,並附上附加的文件。
情境 2 - 建立貨件後文件上傳
目標:建立具有電子貿易文件參數的貨件。
端點:使用 Create Shipment 端點。
動作:
1. 傳送貨件請求,將貨件層級的 specialServiceTypes 設為「ELECTRONIC_TRADE_DOCUMENTS」,並列出在 shippingDocumentTypes 下提到的託運文件清單 (例如「COMMERCIAL_INVOICE」)。
2. 若成功建立貨件,回應中將包含 folderId。
結果:您會收到一個 masterTrackingNumber,須在下一步中使用。
目標:上傳文件,並與步驟 1 建立的貨件 masterTrackingNumber 建立關聯。
端點:使用 Upload Multiple Documents 端點。
動作:
1. 在 documentInformation 下方加入上一步的 masterTrackingNumber 值。請求承載中的 trackingNumber 欄位。
2. 在「上傳多份文件」的請求承載中,您需要在適當的結構下,指定步驟 1 中的 masterTrackingNumber 以及與每份文件相關聯的中繼資料。
結果:您的文件已上傳並已連結至貨件。
您覺得應用程式開發介面 (API) 配方有幫助嗎?
