上傳標籤
如何進入此功能
「託運管理」 → 「上傳標籤」
目錄
一、關於此功能
1.1 功能簡介
從物流商後台下載了一批標籤 PDF，要上傳到系統讓它自動配對到對應的出貨單時，就用這個功能。上傳後系統會為每張標籤建立託運單並與出貨單關聯，省去逐筆配對的麻煩。如果檔名對不到出貨單，可以手動搜尋指定。
1.2 如何進入此功能
「託運管理」 → 「上傳標籤」
1.3 應用範例
情境 1：從物流商後台批次下載標籤後上傳
狀況：從黑貓宅急便後台下載了 50 張標籤 PDF，需要批次上傳到系統。
怎麼做：
- 在物流商後台下載標籤時，確保檔名（去掉 .pdf 副檔名後）與出貨單名稱完全一致
- 進入「上傳標籤」頁面
- 選擇正確的貨主
- 拖曳所有 PDF 檔案到上傳區
- 如果檔名就是出貨單名稱，跳過上傳對照表步驟
- 預覽確認後點擊「確認上傳」
結果：上傳完成後，系統會為每張標籤建立託運單並關聯到對應的出貨單，可到「託運單列表」查看。
情境 2：使用 CSV 對應複雜的檔名
狀況：物流商提供的標籤檔名格式是流水號（001.pdf, 002.pdf...），需要使用 CSV 指定對應關係。
怎麼做：
▸ 準備 CSV 檔案
- 點擊「下載範本」取得 CSV 範本
- 在 Excel 中填寫對應關係（出貨單名稱、物流單號、檔名）
- 儲存為 CSV 格式
▸ 上傳檔案
- 進入「上傳標籤」頁面
- 上傳所有 PDF 檔案
- 上傳 CSV 對照表
- 預覽確認對應正確後點擊「確認上傳」
結果：上傳完成後，即使檔名不是出貨單名稱也能正確對應，可到「託運單列表」查看。
情境 3：補上傳遺漏的標籤
狀況：發現有幾張出貨單的標籤沒有上傳成功，需要補傳。
怎麼做：
- 確認需要補傳的出貨單名稱
- 準備對應的 PDF 標籤檔案
- 進入「上傳標籤」頁面
- 選擇正確的貨主
- 上傳遺漏的 PDF 檔案
- 預覽確認後點擊「確認上傳」
結果：上傳完成後，遺漏的標籤已補齊，可到「託運單列表」確認。
二、功能介紹
2.1 操作流程總覽
上傳標籤採用三步驟精靈流程：
| 步驟 | 名稱 | 必填 |
|---|---|---|
| 步驟 1 | 上傳標籤 — 上傳 PDF 標籤檔案 | 是 |
| 步驟 2 | 上傳對照表 — 上傳 CSV 對照檔 | 否（可跳過） |
| 步驟 3 | 預覽確認 — 確認配對結果並上傳 | 是 |
2.2 步驟說明
▸ 步驟 0：選擇貨主
在開始上傳前，必須先選擇目標貨主。
- 在「選擇貨主」區塊的下拉選單中選擇目標貨主（若您只有一個貨主，系統會自動選取）
- 選擇後若要更換，點擊「更換」重新選擇
▸ 步驟 1：上傳標籤
- 將 PDF 檔案拖曳到上傳區域，或點擊選擇檔案
- 可以一次選擇多個 PDF 檔案
- 確認已選擇的檔案數量正確
- 點擊「下一步」
支援的檔案格式：PDF 檔案（.pdf）
檔案命名建議：
- 建議使用出貨單名稱作為檔名（例如：ORD-2024-001.pdf）
- 如果不上傳 CSV 對照表，系統會把檔名（去掉 .pdf 副檔名）當作出貨單名稱進行配對，檔名必須與出貨單名稱完全一致
- 同名檔案無法重複加入，系統會提示檔名已存在
▸ 步驟 2：上傳對照表（可選）
這個步驟是可選的。如果您的 PDF 檔名就是出貨單名稱，可以跳過此步驟。
何時需要上傳 CSV？
- PDF 檔名不是出貨單名稱時
- 需要同時登錄物流單號時
- PDF 檔名格式複雜，無法自動對應時
CSV 格式說明：
標示 * 的欄位為必填項目
| 欄位 | 如何填寫 | 注意事項 |
|---|---|---|
| *出貨單名稱 | 填寫系統中的出貨單名稱 | 必須與系統中的出貨單名稱完全一致 |
| 物流單號 | 填寫物流商提供的追蹤號碼 | 選填，填寫後會登錄到建立的託運單上 |
| 檔名 | 填寫對應的 PDF 檔名（含 .pdf 副檔名） | 選填，必須與上傳的 PDF 檔案名稱完全一致；留空或對不到檔案時，該筆只會登錄物流單號、不會附上標籤 |
CSV 格式規則：
- 第一列為標題列，標題名稱必須與範本一致（出貨單名稱、物流單號、檔名）
- 使用逗號（,）分隔欄位
- 建議點擊「下載範本」取得正確格式的範本再填寫
▸ 步驟 3：預覽確認
系統會顯示所有待上傳標籤的配對結果，確認無誤後點擊「確認上傳」。上傳過程會逐筆進行並顯示整體進度，完成後顯示成功與失敗筆數。
2.3 預覽確認
預覽表格欄位
| 欄位 | 說明 |
|---|---|
| 出貨單名稱 | 將關聯的出貨單 |
| 物流單號 | 如 CSV 有指定則顯示 |
| 檔名 | 上傳的 PDF 檔案 |
| 配對狀態 | 標籤與出貨單是否配對成功 |
| 上傳結果 | 顯示「上傳成功」或「上傳失敗」（含失敗原因） |
配對狀態說明
| 配對狀態 | 顯示 | 說明 | 處理方式 |
|---|---|---|---|
| 配對成功 | 綠色勾號 | 出貨單和檔案都已正確配對 | 可以上傳 |
| 檔案缺失 | 紅色文字 | CSV 中指定的檔案未上傳 | 該筆仍會上傳，但只登錄物流單號、不附標籤；如需附標籤請回到步驟 1 補上檔案 |
| 出貨單不存在 | 紅色文字 | 出貨單名稱在系統中不存在 | 點擊該欄位可搜尋並手動指定出貨單；未指定的項目不會上傳 |
三、常見問題
3.1 FAQ
▪ PDF 檔名不是出貨單名稱怎麼辦？
使用 CSV 對照表來指定對應關係：
- 點擊「下載範本」
- 填寫出貨單名稱與檔名的對應
- 在步驟 2 上傳 CSV
如果只有少數幾筆對不到，也可以在預覽確認步驟直接搜尋並手動指定出貨單。
▪ 可以同時上傳多少個 PDF 檔案？
系統沒有數量限制。標籤會逐筆上傳，檔案越多花費時間越長，上傳過程中請保持頁面開啟。如果檔案很多，建議分批上傳。
▪ 上傳失敗怎麼辦？
根據失敗原因處理：
| 失敗原因 | 處理方式 |
|---|---|
| 出貨單不存在 | 確認出貨單名稱是否正確，是否屬於所選貨主 |
| 檔案格式錯誤 | 確認檔案為 PDF 格式 |
| 網路錯誤 | 重新整理頁面後再試 |
| 系統錯誤 | 聯絡技術支援 |
上傳失敗的項目會在「上傳結果」欄位顯示失敗原因，已成功的項目不受影響，修正後只需補傳失敗的部分。
▪ 可以重複上傳同一張出貨單的標籤嗎？
可以，但每次上傳都會為該出貨單建立一張新的託運單。如果需要分箱配送，可以上傳多張標籤；如果是誤傳同一張標籤，會造成重複的託運單，建議上傳前先到「託運單列表」確認該出貨單是否已有標籤。
▪ CSV 檔案格式錯誤怎麼辦？
檢查以下常見問題：
- 編碼問題：確保 CSV 使用支援中文的編碼格式
- 標題列：第一列標題必須與範本一致（出貨單名稱、物流單號、檔名）
- 分隔符號：必須使用逗號（,）分隔
- 檔名完整：檔名必須包含副檔名（.pdf）
建議使用系統提供的範本，確保格式正確。
▪ 上傳後標籤會存放在哪裡？
標籤會儲存在系統中。可到「託運單列表」找到對應的託運單（標籤狀態顯示「已產生標籤」），或在「訂單列表」開啟訂單詳情，在託運單區塊點「下載」取得標籤檔案。
▪ 支援哪些檔案格式？
目前僅支援 PDF 格式（.pdf）。如果您的標籤是其他格式（如 PNG、JPG），請先轉換為 PDF 後再上傳。
▪ 上傳過程中可以關閉頁面嗎？
不建議。標籤會逐筆上傳，關閉頁面會中斷還沒上傳的項目。已上傳成功的檔案不會受影響，未上傳的檔案需要重新操作。
3.2 注意事項
⚠️ 重要提醒
- 貨主選擇：上傳前務必確認選擇正確的貨主，標籤只會配對到所選貨主的出貨單
- 出貨單驗證：出貨單名稱必須在系統中存在且屬於所選貨主，顯示「出貨單不存在」且未手動指定的項目不會上傳
- 避免重複上傳：每次上傳都會建立新的託運單，請先確認該出貨單是否已有標籤
- 檔案準備：確保 PDF 檔案可以正常開啟，上傳過程中保持頁面開啟與網路連線穩定
四、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 託運單列表 | 查看上傳後建立的託運單 | 前往 |
| 訂單列表 | 在訂單詳情查看與下載已上傳的標籤 | 前往 |