新增匯入模板
目錄
一、功能介紹
這個頁面用來建立一份新的匯入模板：先指定模板屬於哪個貨主、選好匯入類型，再把貨主檔案的表頭一條條對應到系統欄位，必要時為某些欄位設定固定的預設值。建好後，這個貨主以後用同樣格式的檔案匯入時，選用模板即可自動把欄位讀進正確位置。
1.1 選擇貨主
進入新增頁時，會先請您選定這個模板要屬於哪個貨主。模板綁定單一貨主、只能用在該貨主的匯入；可對應的系統欄位也會依這個貨主而定（例如貨主自訂的屬性欄位）。選好貨主後才進入下方表單。
1.2 基本資料
標示 * 的欄位為必填項目
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| *模板名稱 | 輸入好辨識的模板名稱，建議帶上貨主與用途，例如「A貨主-每月訂單」 | 必填 |
| *匯入類型 | 選擇這份模板適用的匯入類型 | 必填。可選訂單、商品、入庫單、退貨單、聯絡地址、組合；選定後下方欄位選項會跟著切換，建立後無法修改 |
1.3 欄位映射
選好匯入類型後，下方「欄位映射」會出現對應表，每一列填一組對應：
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| Excel 表頭 | 輸入貨主檔案裡的表頭名稱，要跟檔案完全一致（含空格、大小寫） | 留空的整列不會被儲存 |
| 系統欄位 | 從清單選擇這個表頭要對應到的系統欄位，可輸入關鍵字搜尋 | 同一個系統欄位只能對應一次；已被其他列或預設值選走的欄位不會再出現在清單 |
選好匯入類型後，系統會自動把該類型的必填欄位先列成幾列（系統欄位已選好、表頭留空待填）。按右上角的新增可新增更多對應列，每列右側的刪除鈕可移除整列。
1.4 預設值
如果某些欄位整批資料都填同一個固定值，可在這個區塊設定，匯入時自動帶入：
| 欄位名稱 | 如何填寫 | 注意事項 |
|---|---|---|
| 欄位名稱 | 選擇要設固定值的系統欄位 | 設了預設值的欄位會自動從上方欄位映射移除——預設值優先，不需也不能再對應表頭 |
| 預設值 | 輸入或選擇要帶入的固定值 | 依欄位型別不同，可能是文字輸入、數字輸入或下拉選擇 |
預設一開始沒有任何預設值，按新增新增。
1.5 儲存
填好後，頁面下方提供兩個儲存選項：
- 建立：建立模板，完成後進入該模板的詳情頁。
- 儲存並新增下一筆：建立後留在新增頁、清空表單，方便連續替同一貨主建立多個模板。
儲存時系統會檢查每個必填欄位是否都有對應的表頭或預設值；若缺，會提示缺哪些欄位、不予儲存。若該類型沒有必填欄位，則至少要有一組有效的欄位映射。
二、常見問題
2.1 FAQ
▪ 為什麼選了匯入類型，欄位映射就自動多了幾列？
那些是該匯入類型的必填欄位，系統先幫您把系統欄位選好、表頭留空，提醒您每個必填欄位都要對應到一個表頭（或改設預設值），否則匯入會失敗。
▪ 系統欄位清單裡找不到我要的欄位？
確認您選的匯入類型正確（不同類型的欄位不同），以及該欄位是否已被其他列或預設值選走（同一欄位只能用一次）。貨主自訂的屬性欄位也會依選定的貨主出現在清單。
▪ 一個系統欄位可以對應兩個表頭嗎？
不行。同一個系統欄位只能對應一次，已被選走的欄位不會再出現在其他列的清單中。
▪ 設了預設值的欄位，為什麼從欄位映射消失了？
因為預設值優先：設了預設值就會自動帶入固定值，不需也不能再對應檔案表頭，所以該欄位會自動從上方移除。把這個預設值刪掉或改成別的欄位，原欄位若是必填會自動長回欄位映射。
▪ 儲存時提示「缺少必填欄位」怎麼辦？
代表有必填欄位既沒對應表頭、也沒設預設值。依提示補上對應的Excel 表頭、或為它設一個預設值，再儲存。
▪ 看不到新增按鈕或進不了這個頁面？
新增匯入模板需要貨主寫入權限。如果看不到，請聯繫管理員確認權限。
2.2 注意事項
⚠️ 重要提醒
- 匯入類型與所屬貨主建立後鎖定，事後無法修改；選錯只能刪掉重建。
- 切換匯入類型會清空已填的預設值與欄位映射（欄位是綁定特定類型的，換類型後舊設定會對不上）。請先確定類型再開始對應欄位。
💡 提示：Excel 表頭務必跟貨主檔案的表頭一字不差，包含空格與大小寫，否則匯入時對不上、該欄位會讀不到值。
三、相關功能
| 功能 | 說明 | 連結 |
|---|---|---|
| 匯入模板列表 | 回到所有模板的列表 | 前往 |
| 編輯匯入模板 | 建立後再修改模板內容 | 前往 |
| 匯入商品 | 匯入商品時選用模板 | 前往 |
| 匯入訂單 | 匯入訂單時選用模板 | 前往 |