01｜Excel 首次匯入
進入材料管理頁面後，請遵循以下步驟執行匯入作業：
下載 Excel 模板
開啟下載視窗，點選畫面右上方的
圖示。
圖一 - 點選「Excel 匯入」
下載標準模板：在開啟的視窗中，點擊
。請務必使用系統提供的原始模板進行資料填寫，以確保資料格式能精確對應。
圖二 - 下載模板
【Excel 模板填寫規範與補充】
欄位名稱 | 填寫規範與實務建議 |
|---|---|
廠商（選填） | 此欄位為「選填」，系統會根據填寫內容執行不同的自動歸類動作：
|
合約（選填） | 填寫該材料所屬的合約名稱，配合廠商欄位。同廠商下可區分不同合約（如：水泥採購、紅磚供應），以利後續針對單一合約進行增補紀錄管理與對帳。 若未填寫：系統將自動歸類於該該廠商下的『沒有合約』分類，方便後續再行手動調整歸屬。 |
分類（必填） | 定義材料屬性（如結構材、裝修材、機電設備）。 |
材料或設備編號（必填） | 填入材料識別碼（如：01, 02...）。 |
材料或設備名稱（必填） | 須與採購契約或規範之品名完成一致（如4000psi 預拌混凝土、D13 鋼筋）。建議標註規格，方便現場人員進行離線點交時核對。 |
單位（必填） | 填入營建常用單位（依標案需求填寫，沒有限制）。 |
契約數量（必填） | 填寫合約原始總量。 |
單價（必填） | 填入合約原始單價。 |
圖三 - 材料模板
填寫 Excel 模板
【重要警告】Excel 模板規範與格式限制
由於系統必須精確判讀各項資料，請在填寫 Excel 材料模板時，務必嚴格遵守以下規範：
嚴禁變動模板結構
勿自行添加欄位：請勿在模板中插入任何自訂的欄位、欄位名稱或備註資訊。系統後台已固定讀取位置，多出的欄位將導致資料偏移，進而引發匯入錯誤或數據錯位。
勿漏項必填欄位：標註為必填(*) 的項目（如：分類、材料編號、名稱、單位、數量、單價）絕對不可留白。一旦缺少核心數據，系統將無法建立該材料，甚至導致整份檔案匯入失敗。 禁止公式運算：請直接填寫「數值」，切勿在數量或單價欄位中使用 Excel 公式（如：
=SUM(...)）。
格式純淨化原則
禁止公式運算：請直接填寫「數值」，切勿在數量或單價欄位中使用 Excel 公式（如：
=SUM(...)）。禁止特殊格式化：請勿對表格進行儲存格合併、更改字體顏色或加上框線樣式。維持模板原始的純淨格式，能確保匯入過程的穩定性。
數據填寫邏輯
單位一致性：請參照系統建議的營建常用單位填寫。
廠商名稱精確度：如前所述，若欲將材料新增至已建立的廠商，名稱必須與系統內完全一致。差一個空格或符號，系統就會視為新廠商而重複建立。
圖四 - 填寫模板
上傳 Excel 模板
材料檔案填寫完畢並確認格式無誤後，請依序執行以下步驟完成匯入：
開啟匯入視窗：點選材料管理頁面右上方之
圖示。
圖五 - 點選「Excel 匯入」
上傳檔案：於『Excel 模板檔案上傳』欄位，選擇或拖曳您填寫完畢的 Excel 檔案。
執行匯入：點選
按鈕，系統將開始判讀資料並自動建置廠商、合約與材料。
圖六 - 上傳檔案
完成畫面如下：
實務說明與最終檢查
資料核對：匯入成功後，系統會自動跳轉至材料清單。建議立即核對總筆數是否正確，以及各材料的『契約複價』是否與原始價單一致。
錯誤排除提醒：若匯入過程中出現錯誤提示，通常是因『編號重複』或『必填欄位漏項』所致。請修正 Excel 檔案後，再次執行匯入，以維持資料的純淨性。
透過 Excel匯入後，若您需要更動/增加材料資訊，則可 手動編輯 或 再次匯入Excel。
（請注意，再次匯入並不會覆蓋原有檔案，且若再次匯入之材料編號不可與既有資料重複。因此，若需修改資料則請手動修正；若需額外添加材料則可再次執行 Excel匯入。）
圖七 - 完成畫面
02｜Excel 重複匯入
在材料管理模組中，Excel 匯入功能具備較高的操作彈性。與「施工項目」必須在完全無資料狀態下才能匯入的限制不同，材料管理支援在既有資料庫的基礎上進行「重複匯入」。
為了確保工程材料數據的嚴謹性，系統在執行重複匯入時遵循以下邏輯：
非覆蓋原則
系統採取「僅增補、不覆蓋」機制。匯入作業不會對系統內已存在的既有資料進行任何修改、替換或刪除。
編輯唯一性檢核
系統以「材料編號」作為唯一識別基準。若 Excel 表單中欲匯入的材料編號與系統既有編號重複，該筆資料將會被判定為重複而導致匯入失敗。
實務應用
基於上述機制，此功能在管理實務上具備明確的適用範圍：
適用於「批次新增材料」： 當專案進入不同施工階段（如由結構轉裝修期），需額外納入大量新型號材料、五金配件或新進場物資時，可直接整理成 Excel 檔進行增補匯入，無需清空原有的材料清單。
不適用於「既有資料修改」： 若需針對已在系統內的材料進行單價、規格描述或分類異動，透過再次匯入 Excel 的方式將無法達成（因編號重複會被系統攔截）。此類修改需求應直接於系統介面進行編輯，或透過專門的資料更新功能處理。
填寫 Excel 模板
請參考下圖圖示，依據系統提供的 Excel 範本填寫欲新增之材料項目：
圖八 - 填寫材料模板
上傳 Excel 模板
材料檔案填寫完畢並確認格式無誤後，請依序執行以下步驟完成匯入：
開啟匯入視窗：點選材料管理頁面右上方之
圖示。
圖九 - 點選「Excel 匯入」
上傳檔案：於『Excel 模板檔案上傳』欄位，選擇或拖曳您填寫完畢的 Excel 檔案。
執行匯入：點選
按鈕，系統將開始判讀資料並自動併入或建置廠商、合約與材料。
圖十 - 上傳新增材料
完成畫面如下：
圖十一 - 完成畫面