# 匯入客戶 ## **概述** 客戶匯入功能讓你能一次性批量匯入客戶資料於系統。例如你原來在 Excel 表中的資料，或者從其他系統導出的資料，可通過此功能快速的轉移到 FIRST LINE。 ## **範本管理** 名單匯入功能可透過點擊「應用程式」中的「客戶」分類中的「客戶匯入」進入匯入管理頁面。 匯入管理頁面包含「匯入範本」、「匯入紀錄」和一個「新增匯入」按鈕。 * **匯入範本：** 在進行匯入之前，需要為匯入檔案新增一個對應的範本，設定檔案中的欄位內容。初次設定後，之後的匯入將更加便捷，同時保持高度的擴展性和協同操作。 * **匯入紀錄：** 每一次匯入都會被詳細記錄，包括開始時間、結束時間、成功數等，甚至原始檔案都會被保存，以方便您管理名單的來龍去脈。 * **新增匯入按鈕：** 點擊後將進入設定畫面，下方將進一步詳細介紹相關內容。
## **新增範本** ### 基本資料 1. **範本名稱**：必填欄位，用於辨別所使用的匯入範本，你可根據名單來源、欄位內容進行命名，如 XX銀行名單、網路購物會員名單等，方便操作人員識別。 2. **描述**：額外補充範本資料，此欄位也會顯示於範本列表，方便用於識別。 ### 比對條件 你可以在「比對條件」中新增判斷是否為重複客戶的條件。當系統根據這些條件找到相同客戶時，將會進行更新。例如，如果將「比對條件」設為「客戶編號」，在下次匯入時，會比對新資料中的「客戶編號」，如果發現相同編號的客戶，則會自動更新其資料。 為確保匯入資料的 正確性與可控性，「比對條件」設計具備以下邏輯與限制： #### 1. 比對條件邏輯 * 可自定一或多個欄位作為「唯一識別依據」。 * **所有條件需同時滿足**，才會視為同一筆客戶資料並執行更新。 * **任一條件不符，或缺值、格式不一致等，將視為新客戶**，將新增資料。 #### 2. 常見錯誤來源 * 多重比對條件但實際匯入資料不一致（如地址略有不同、標點符號不同），會導致無法比對成功。 * 指定欄位（如「客戶編號」）在匯入資料中缺值或留空，視為比對失敗。 #### 3. 多筆符合的處理 * 若比對條件導致命中多筆現有資料（例如重複的「姓氏＋編號」），將不針對現有符合客戶更新，而會採用項目一的條件不符情境，避免不確定性問題。 #### 4. 不設定比對條件 * 將一律視為新增客戶資料，無論是否與既有資料雷同。
### 範本編輯 您可以透過範本編輯頁面右側的預設欄位，進行「點擊」或是「拖曳」的操作，將欄位加入至左側的範本中，以新增對應的欄位。 **如果客戶自訂欄位中有必填欄位，請務必連同新增至範本內，否則將被檢核規則阻擋**。確保您的範本包含了所有必填欄位，以順利進行名單匯入。
## 開始匯入 ### 確認匯入檔案符合欄位與格式 在進行名單匯入之前，請確認您的匯入檔案（CSV）的欄位是否與您所設定的匯入範本相符。**此外，請確保您的匯入檔案是使用UTF-8編碼，以確保正確匯入資料。**若匯入檔案的編碼不正確，系統可能無法正確辨識檔案內容。
### 選擇匯入檔案 的匯入範本設定完成後，請找到您本次要使用的範本，在右側點選「開始匯入」，開啟匯入視窗。在上傳檔案時，如果原始資料中包含表頭，請勾選進階設定，以避免將表頭內容視為資料進行匯入。這樣可以確保匯入的正確性。
### 開始匯入 當您點選「進行匯入」後，頁面上方將顯示進度條，顯示匯入的狀態。同時，您可以切換到「匯入紀錄」分頁，查看每筆資料的上傳紀錄，包括成功與否以及匯入筆數等資訊。 如果以後有需要，您還可以從該筆紀錄後方點選「下載匯入檔案」，以獲取當時該筆匯入的原始資料，方便進行管理和保存。
## 常見錯誤項目 ### 沒有匯入成功或欄位錯誤 當無法成功匯入時，可以點擊進入「匯入紀錄」，查看每一筆被拒絕匯入的原因。若發現大量筆數無法匯入，請檢查以下可能原因： 1. **匯入檔案與範本不一致：** 確保您匯入的檔案欄位與所設定的匯入範本相符。例如，如果範本的第一欄是「會員編號」，則檔案的第一欄也應該是「會員編號」。欄位有遺漏或不一致可能導致整個資料錯誤。 2. **必填欄位遺漏：** 如果有必填欄位未在匯入檔案中提供數據，系統會拒絕匯入。確保所有必填欄位都有正確的數據。 3. **欄位格式錯誤：** 如果匯入的資料包含日期等欄位，確保其對應格式正確。系統可能會拒絕格式不正確的資料。
### 常見拒絕項目 #### **The xxxxxx field is required.** 表示該欄位為必填項目，但在匯入的欄位或檔案中沒有包含此欄位的資訊。為了成功匯入，您需要確保檔案中包含了所有必填的欄位，以符合資料的要求。 #### **The xxxxxxx is duplicated.** 表示有唯一值對應欄位重複。若要成功匯入，請再檢查比對條件中是否設定對應欄位，例如，如果匯入檔案中有「身分證字號」欄位，請確認比對條件是否也設定了「身分證字號」欄位，以確保系統可以辨識並處理重複的身份證字號資訊。 #### **The xxxxxx is not a valid date.** 表示輸入的欄位資料不符合日期格式的要求，合法的日期格式應該像是 1987-11-22 或 1967-10-05。請確保日期欄位的數據符合正確的日期格式，系統雖然針對多數常見的格式進行處理，例如 1998/10/02 等形式，但仍建議使用以 YYYY-MM-DD 格式，使系統能夠正確處理這些資訊。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.firstline.cc/feature/crm/import.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.