程式資訊

程式 ID：CUDATA
所屬子系統：E.營業收款
狀態：stable

客戶基本資料¶

功能簡介¶

「客戶基本資料」（CUDATA，俗稱客戶主檔）是維護所有往來客戶的中央資料庫。它把一個客戶的基本識別、交易與付款條件、地址、聯絡人、財務與銀行帳戶、代理商、麥頭、自定義分類等資料集中保存，並提供統計、應收帳款、客戶報價、訂單、出貨等即時查詢頁籤。

這支主檔是整個銷售流程的源頭：建立銷售訂單、開客戶報價、做出貨與開立發票時帶出的幣別、稅別、收付款條件、業務員、收貨／請款地址等預設值，全都來自這裡。負責維護的通常是業務助理或業務主管。

與「客戶信用額度」是兩支程式

本頁只負責客戶的基本資料。客戶的信用額度與帳款上限另有獨立程式客戶信用額度（CUDATAM）維護；本頁雖然保留了一個「信用額度」查詢頁籤的程式骨架，但目前並未掛上工具列，請以 CUDATAM 為準。

前置需求¶

權限：E-010 客戶基本資料 的瀏覽／新增／修改／刪除權限。部分頁籤另需對應程式的瀏覽權限才會顯示（見下表）。
基礎資料：欄位的下拉與帶值依賴下列主檔／參數，建議先維護——

資料	影響什麼
系統小代碼（SMEMS：等級 C283、類別 C262、區域 C21582、交易類別 C273、交易條件 C202、付款方式 C203、運送方式 C201）	對應下拉選單的可選值；沒設這些代碼，下拉會是空的
收付款條件（PAYTERM）	收付條件號的下拉與說明
稅別（TAXTYPE）	稅別的下拉與名稱
業務員主檔	業務員1／業務員2的姓名帶值
客戶群組（GRPM）	群組代號的群組說明，以及「自定義分類」要套用的分類項目
幣別主檔	幣別／資本額幣別控件；新增時預設帶本位幣
系統參數 5002（倉儲別預設）	新增客戶時自動帶入的倉儲別

與頁籤顯示有關的權限

財務頁籤需有本程式的檢視價格權限；其餘整合查詢頁籤各自需要對應程式的瀏覽權限，沒有權限的頁籤不會出現——

頁籤	需要的瀏覽權限
應收帳款	`RECEIVE`
客戶報價	`CUPDMA`
訂單	`ORMAST`
出貨	`TRSAMA`
索引分類帳	`ABOOK2`
信件搜尋	`MAILSEARCH`

查工商登記需要對外連線

統一編號欄的自動帶入功能會即時查詢政府的商工登記公示資料平臺，使用端必須連得到該平臺。內網有對外白名單管制時請先請 IT 放行；連不出去時只是查無結果，不影響手動輸入。

操作步驟¶

新增客戶¶

從主選單開啟 E 銷售訂單 → 客戶基本資料。
點選工具列 新增。系統會自動帶入下列預設值（見欄位連動與附加功能）：
- 建檔日期＝今天（唯讀）
- 幣別＝公司本位幣
- 倉儲別＝系統參數 5002 設定值
在基本資料頁籤輸入 客戶代號（最多 10 碼）、客戶簡稱、客戶名稱。
依需要填寫統一編號、集團代號、群組代號等。
切到交易與付款條件區，設定 等級、類別、區域、交易類別、收付條件號、稅別、付款方式、運送方式等。
切到地址資訊填寫公司／請款／送貨地址，必要時按 複製到付款資訊 把公司地點複製成請款地點。
切到其它頁籤（財務／其他）補齊銀行帳戶、代理商、麥頭、備註等資料。
點選工具列 儲存。

小技巧

可用 Ctrl+S 快速儲存。

查工商登記（輸入統編自動帶入公司資料）¶

建檔時不必再一欄一欄照抄名片或營業登記。在統一編號欄輸入 8 碼統編，游標一離開欄位，系統就自動向政府的商工登記公示資料平臺查詢，把客戶名稱、負責人、公司地點、登記資本額帶回來填好。

按 新增（或對既有客戶按 修改）進入編輯狀態。
在統一編號欄輸入 8 碼數字。
按 Tab 或點到其他欄位——游標一離開，系統自動查詢。也可以按統編欄旁的 查工商登記 按鈕隨時手動查一次，不必把統編刪掉重打。
看它把資料填回來：查得到的欄位才填，官方沒有的欄位不動。
- 欄位原本空白 → 直接填入。
- 欄位原本已有值且與登記不同 → 系統把有差異的欄位集中列出、跳一次確認視窗（「下列欄位與工商登記資料不同，是否以登記資料覆蓋？」），按 是 才覆蓋，按 否 保留你原本填的。
新增客戶時輸入統一編號並按「查工商登記」，名稱與地址自動帶入（實機截圖）。
查無資料時顯示「查無統一編號 XXXXXXXX 的工商登記資料。」，原有欄位不動。
補齊其他欄位後 儲存。

帶回來的欄位	來源
客戶名稱	登記的公司名稱（公司登記查無時改抓商業登記的商號名稱）
負責人	登記的負責人姓名
公司地點	登記地址
登記資本額	登記資本額，以「萬」為單位回填（平臺提供的是「元」，系統自動換算）

只有在新增／修改時才會去查

瀏覽狀態下輸入或翻閱統編不會觸發網路查詢——單純翻資料不會對外連線，只有真的在建檔或改檔時才查。此外統編必須是 8 碼純數字才會觸發，格式不符時系統靜默不查。

查回來的資料跟手上的不一樣，正是重點

名稱差在「股份有限公司」幾個字：多半是名片印簡稱、登記是全名。開發票、寄正式文件要用登記名稱，建議覆蓋。
地址不一樣：常見於工廠與登記地不同的客戶。登記地址適合用在正式文件，實際收貨地請另外維護在送貨地點欄。
負責人不一樣：對方換過負責人，值得順手通知業務——往往連窗口都換過了。

修改客戶¶

用工具列的搜尋（放大鏡）或上下筆瀏覽找到要修改的客戶。
點選 修改，調整欄位後 儲存。

刪除客戶¶

瀏覽到要刪除的客戶。
點選 刪除 並確認。

注意

若該客戶已被訂單、出貨、發票或應收帳款引用，刪除會被資料庫關聯擋下。建議改用停用（把「停用」設為「是」）讓客戶不再被選用，而非實際刪除。

列印¶

瀏覽到目標客戶。
點選工具列 列印，選擇 Print Customer 報表。系統會以目前客戶代號作為列印條件帶入（單一客戶）。

統計與帳款查詢¶

切換到右側的頁籤即可查看該客戶的衍生資料，全部以目前瀏覽的客戶為對象（見欄位連動與附加功能）：

統計資料：銷售統計（特別查詢）。
應收帳款：未收／已收帳款明細與合計。
客戶報價／訂單／出貨：嵌入對應主檔的查詢，預設鎖定本客戶。
索引分類帳：這家客戶在總帳上的分類帳（見下一節）。
信件搜尋：與這家客戶的往來信件（見信件搜尋分頁）。

索引分類帳分頁¶

客戶打電話來對帳時，不必離開客戶主檔跳到總帳、手動輸入客戶代號、選期間——切到 索引分類帳 分頁即可，這是完整的索引分類帳（ABOOK2），內嵌在客戶主檔裡。

在客戶主檔用查詢或上下一筆翻到要對帳的客戶。
切到 索引分類帳 分頁。切進去的當下系統已經自動帶好條件並查詢完成：
- 索引種類 ＝客戶或廠商代號
- 索引範圍起訖 ＝目前這家客戶的代號
- 期間＝索引分類帳的預設期間（當月）
先看上半部：每一列是「這家客戶 × 某個科目」的期初、本期借方、本期貸方、期末餘額，客戶問「總共多少」時直接報這裡。
再點下去看明細：點選上半部任一列，下半部帶出該科目底下的逐筆傳票明細——第一列固定是期初起始列，其後每筆都帶累計餘額。
要看更早的期間：條件面板完整開放，把日期起訖往前拉、按 查詢 重查即可；要限定科目就設科目代號起訖。
要一份書面對帳資料：按 列印，索引分類帳原有的報表格式都可用；也可以在資料表格上按右鍵匯出 Excel。
換下一家客戶：回主檔翻到下一家，再切回這個分頁，系統會自動改帶新客戶重查——游標停在哪家，看的就是哪家的帳。

沒有這個分頁？

索引分類帳分頁需具備 ABOOK2（索引分類帳）的瀏覽權限；無權限者不會看到這個分頁，規則與財務、應收帳款等分頁一致。不另設獨立權限項目。

查的是總帳，不是訂單出貨

這個分頁看的是已過帳的傳票。若某筆出貨或收款尚未轉成傳票、或傳票尚未過帳，就不會出現在分類帳上——這種「單據上有、帳上還沒有」的差異屬正常，請回頭確認轉帳與過帳作業是否已完成。

自己調過的條件不會被洗掉

同一家客戶重複切進切出這個分頁不會重帶條件——你把期間放寬後切去別的分頁再切回來，看到的還是你調過的條件。只有換到另一家客戶時才會重新帶入該客戶與預設期間。

信件搜尋分頁¶

客戶打電話來問「上次那封報價信」時，不必離開客戶主檔跑去開信箱或另外開信件搜尋、再輸入一次代號——切到 信件搜尋 分頁即可，這是完整的信件搜尋（MAILSEARCH），內嵌在客戶主檔裡。

在客戶主檔用查詢或上下一筆翻到要看的客戶。
切到 信件搜尋 分頁。切進去的當下系統已經自動帶好條件並查詢完成，直接看到這家客戶的往來信件：
- 客廠部代號 ＝目前這家客戶的代號
- 日期起訖 ＝信件搜尋的預設區間（近 3 個月）
- 結果筆數上限 200 封，與信件搜尋主程式相同
點選任一列看內文：下方預覽區顯示該封信的主旨、寄件人、日期與純文字內文；有附件時抬頭會接上附件檔名（附件本體不在系統裡，要開檔請回原信箱）。
要改條件重查：條件面板完整開放——加上關鍵字（同時搜主旨、內文與附件檔名）、把日期起訖往前拉，再按面板旁的 查詢 重查即可。
想用問的：AI「用問的」在這個分頁一樣可用，例如問「最近抱怨交期的信」，用法與信件搜尋主程式相同。
換下一家客戶：回主檔翻到下一家，再切回這個分頁，系統會自動改帶新客戶代號重查——游標停在哪家，看的就是哪家的信。

沒有這個分頁？

信件搜尋分頁需具備 MAILSEARCH（信件搜尋）的瀏覽權限；無權限者不會看到這個分頁，規則與財務、應收帳款、索引分類帳等分頁一致。不另設獨立權限項目。

查到的是同步進來的信，不是即時信箱

信件由排程每日同步一次，且只查登記在您名下、屬於目前帳套的信箱。剛收到還沒同步的信查不到；某家客戶的信老是查不出來，多半是客戶的 Email 沒維護導致歸戶不到，補進主檔或聯絡人資料後，之後同步進來的信就會歸戶。詳見信件搜尋。

欄位說明¶

基本資料頁¶

欄位	必填	說明/格式/預設
客戶代號	是	最多 10 碼，主鍵，新增後即為識別碼
客戶簡稱	是	最多 40 字；輸入後自動產生速查碼
客戶名稱	是	完整公司名稱
速查碼	—	系統依客戶簡稱自動產生（唯讀）
建檔日期	—	新增時自動帶今天（唯讀）
停用	—	是／否；停用後不再被單據選用
幣別	—	新增時預設本位幣；之後可改，會帶到訂單／報價
統一編號	—	客戶統編
集團代號	—	透過客戶查詢選取，帶出集團簡稱
群組代號	—	透過群組查詢（SK_GRPM2）選取，帶出群組說明

交易與付款條件¶

欄位	必填	說明/格式/預設
等級	—	下拉 C283
類別（客戶類別）	—	下拉 C262
區域（區域代碼）	—	下拉 C21582
交易類別	—	下拉 C273
收付條件號	—	PAYTERM 查詢，帶出說明
稅別	—	TAXTYPE 查詢，帶出名稱
交易條件	—	下拉 C202
付款方式碼	—	下拉 C203
運送方式碼	—	下拉 C201
收付款代號	—	另一客戶代號，作為帳務歸戶對象；帶出收付款簡稱

地址資訊¶

欄位	必填	說明/格式/預設
發票抬頭	—	最多 50 字
公司地點／公司郵遞號	—	公司地址
請款地點／發票郵遞號	—	請款（發票）地址，可由公司地點一鍵複製
送貨地點／送貨郵遞號	—	出貨地址

聯絡資訊¶

欄位	必填	說明/格式/預設
Email	—	公司 Email
電話／傳真	—	公司電話、公司傳真
Website	—	公司網址
聯絡人1／聯絡1電話	—	主要聯絡人

Email 欄會影響「信件搜尋」的客戶歸戶

信件搜尋靠客戶主檔與聯絡人資料的 Email（完全相符或同公司網域）把往來郵件自動歸到客戶名下。這裡的 Email 沒維護或寫錯，該客戶的信就查不到（歸戶客戶代號空白）。一格可寫多個地址，系統會逐一擷取比對。

銷售與帳款¶

欄位	必填	說明/格式/預設
業務員1／業務員2	—	業務員主檔查詢，帶出姓名
帳款起始日	—	數字，帳款計算的起算日設定
付款天數	—	數字天數
發票方式	—	「隨貨」（空白）或「月結」（M）
附回郵／附對帳單	—	是／否

財務頁¶

欄位	必填	說明/格式/預設
銀行名稱／帳號／支存帳號／活存帳號	—	收款銀行資訊（帳號類欄位多為唯讀顯示）
資本額幣別／登記資本額／年營業額	—	公司財務概況
Leadtime(Stock)／Leadtime(Trans)	—	庫存／調撥前置天數
扣庫存	—	兩位小數比例
自行帶料	—	是／否

其他頁¶

欄位	必填	說明/格式/預設
自訂欄位	—	自由文字
包裝規範	—	檔案路徑（可帶附件路徑）
代理商1／代理商2 + 生效／截止日	—	客戶查詢選取代理商，帶出簡稱
頁尾備註／產品說明／注意事項	—	多行文字
麥頭種類／麥頭	—	麥頭種類下拉（空白／三角／菱形／其他），麥頭為多行文字

員工聯絡人明細（基本資料頁下方）¶

欄位	說明
序號／人員別	系統維護（唯讀）
員工編號／姓名／部門／職稱／職務內容	該客戶的窗口人員
電話／傳真／手機／Email／郵遞區號／地址	聯絡方式
代理人／代理人電話／備註	代理窗口

明細的刪除判定

員工聯絡人這一列若姓名為空白即視為空列、儲存時自動略過；自定義分類那一列若分類為空白也同理。

欄位連動與附加功能¶

這是本頁最重要的一節。以下行為皆來自實際程式碼（ViewModel／Source／XAML）。

新增時自動帶入的預設值¶

當你按 新增，系統在 AfterAddNew 會對新客戶做：

建檔日期 ← 今天（TodayYYYYMMDD，唯讀，不可改）。
幣別 ← 公司本位幣（Context.Env.LocalCurrency）。
倉儲別 ← 系統參數 5002（VFP addagain 的 U_PRGPAR(5002)）。
同時呼叫 GetDescription()，補上代理商１／２、收付款對象的簡稱顯示。

客戶簡稱 → 速查碼自動產生¶

當你在客戶簡稱欄位輸入並離開（LostFocus），系統會以客戶簡稱去查詢產生速查碼並填入（客戶簡稱Binding 的 setter 呼叫 GetQuickFindCode）。速查碼欄位本身唯讀，不需手動維護。

集團／群組／代理商／收付款 → 帶出簡稱¶

集團代號（CustomerSearch）選取後帶出集團簡稱。
群組代號（GroupSearch，別名 SK_GRPM2）選取後帶出群組說明。
收付款代號（客戶搜尋）輸入後帶出收付款簡稱。
代理商1／代理商2（客戶搜尋）輸入後帶出代理簡稱1／2。
切換客戶（上下筆瀏覽）後，AfterMoverRecord 會重新以 DescriptionHelper 補算集團簡稱、收付款簡稱，確保顯示同步。

收付條件號／稅別 → 帶出說明名稱¶

收付條件號（PaymentTermSearch）帶出條件說明。
稅別（TaxTypeSearch）帶出稅別名稱。
這些欄位旁的標籤是可點的超連結（TsNavigateLabel），點下去會跳到對應的代碼／條件設定畫面。

複製到付款資訊按鈕¶

地址資訊區的 複製到付款資訊 按鈕（CopyAddressToBillCommand）：當你按下時，系統把公司地點直接複製到請款地點。只有在編輯狀態下（非瀏覽）才會作用。

自定義分類（設定按鈕）¶

基本資料頁右側的「自定義」區，設定 按鈕（SelfDefinedCommand）依群組代號載入該群組定義的自定義分類項目：

按下後，系統先把現有分類列標記刪除，再依群組（GrpmBll.GetSelfDefined）重新產生分類列，每列帶一組可選的分類內容下拉清單，預設選第一項。
進入修改狀態（Edit）時，系統也會自動把每列的分類內容下拉重新對應到群組設定，確保選項是最新的。

折扣率欄位需特別權限

若使用者權限備註含 EditDiscountRate，編輯狀態下折扣率才可改；否則折扣率欄位維持唯讀。

儲存時的自動補值與檢核¶

按 儲存 時，系統在 HandleDataBeforeEndEdit 會先做幾個自動補值（皆為實作行為）：

公司地點空白時，自動把送貨地點設成公司地點。
請款地點空白時，自動補成公司地點。
幣別空白時補成公司本位幣（Context.Env.LocalCurrency）。
客戶代號以 CR 開頭時，客戶類別自動設為 CONSUMER。

同時 AllowSave 會擋下不合規的存檔：

客戶代號未輸入（或為佔位字 +++）→ 不可儲存並提示輸入。
收付款代號空白時，自動補成客戶代號本身（自己歸戶）。

工具列擴充功能（ExtensionFunction）¶

本頁提供多個擴充功能按鈕，對應 CudataBll：

擴充1（GroupCopyToExcel）：把客戶的「購買群組」（vwseek_cudata_group）資料匯出 Excel，完成後重新整理畫面。
擴充2（GetCredit）：查目前客戶的信用概況（首次交易日 Sold Since、最近交易日 Date Last Sale、最高信用 High Credit），以訊息視窗顯示。需先有選定客戶。
擴充3（CreditHoldCopyToExcel）：信用凍結清單匯出（目前程式內容已停用，屬保留功能）。
擴充4（CreditToExcel）：把目前客戶的信用狀態（customer_creditstatus）匯出 Excel。

列印條件（IPrintCondition）¶

列印 Print Customer 報表時，系統自動以目前客戶代號組出一筆查詢條件（符號 G，套到「客戶代號」欄），因此列印的就是當前這一個客戶，不需手動輸入條件。

頁籤即時查詢與啟用控制¶

切到統計資料／應收帳款／客戶報價／訂單／出貨任一頁籤時，系統才即時去查（ITabQuery.Query），且每筆只查一次（換客戶後會重置再查）。
應收帳款頁查出明細後，自動合計原幣金額、本幣金額、未收原幣、未收本幣，以及只計超過 90 天列的超過 90 天原幣、超過 90 天金額；超過 90 天的列會特別標示。
進入編輯／新增狀態時，這些「衍生查詢」頁籤會被停用，且若當下停在其中一個頁籤，會自動切回基本資料頁，避免一邊改主檔一邊看舊查詢結果。
索引分類帳頁籤：切入時（首次，或換到另一家客戶後第一次切入）自動把索引種類設為「客戶或廠商代號」、索引範圍起訖設為目前客戶代號並觸發查詢；期間沿用索引分類帳自身的預設（當月）。同一家客戶重複切入不重帶條件，不會洗掉你手動調過的查詢條件。此頁籤僅在具備 ABOOK2 瀏覽權限時才會掛出。
信件搜尋頁籤：切入時（首次，或換到另一家客戶後第一次切入）自動把客廠部代號設為目前客戶代號並立即執行查詢；日期區間與筆數上限沿用信件搜尋自身的預設（近 3 個月、200 封）。同一家客戶重複切入不重帶條件。此頁籤僅在具備 MAILSEARCH 瀏覽權限時才會掛出。

統一編號 → 查工商登記¶

當你在統一編號欄輸入 8 碼數字並離開欄位（或按 查工商登記 按鈕），系統會先確認目前處於新增／修改狀態且統編為 8 碼純數字，才向商工登記公示資料平臺查詢；先查公司登記，查無再查商業登記（涵蓋獨資、合夥商號）。
查到後比對 客戶名稱、負責人、公司地點、登記資本額 四欄：空白欄直接填；已有值且與登記不同的欄位集中列出跳一次確認，按 是 才整批覆蓋。
登記資本額以「萬」為單位回填（平臺回傳的「元」自動除以 10000）。
查無資料時顯示提示訊息，不動任何既有欄位。

常見問題¶

新增客戶時幣別、倉儲別是空的？

幣別預設取公司本位幣（Context.Env.LocalCurrency），倉儲別預設取系統參數 5002。若帶不出來，請確認本位幣已在環境設定中、且系統參數 5002 有設值；否則這兩欄會留白需手動選。

輸入客戶簡稱後速查碼沒有自動帶？

速查碼是在離開（LostFocus）客戶簡稱欄位時才產生的。請輸入完客戶簡稱後按 Tab 或點到其他欄位；只在輸入框內打字、游標還停著時不會即時產生。

看不到「財務」「應收帳款」「客戶報價」等頁籤？

這些頁籤依權限顯示：財務需檢視價格權限；應收帳款需 RECEIVE、客戶報價需 CUPDMA、訂單需 ORMAST、出貨需 TRSAMA 的瀏覽權限。請向系統管理員確認權限設定。

客戶刪不掉？

若客戶已被訂單、出貨、發票、應收帳款等單據引用，資料庫關聯會擋下刪除。建議把停用設為「是」讓它不再被選用，而非實際刪除。

改了代理商／群組／收付款代號，旁邊的簡稱沒更新？

簡稱是經由查詢控件帶出或在切換客戶時由 DescriptionHelper 補算。請用欄位旁的查詢（放大鏡）正確選取代碼；若仍未更新，切換到別筆客戶再切回即會重新帶算。

輸入統編後沒有自動帶出公司資料？

依序確認：1）目前是否在新增／修改狀態（瀏覽狀態不會查）；2）統編是否為 8 碼純數字（格式不符時系統不查、也不提示）；3）游標是否已離開統一編號欄（用 Tab 或點別的欄位），或改按 查工商登記 按鈕手動觸發；4）電腦是否連得到外部網路（內網白名單管制請洽 IT）。若顯示「查無…的工商登記資料」，代表統編可能打錯，或該公司尚未在平臺公示，可直接手動填寫。

查工商登記把我填的公司名稱蓋掉了？

只有在你按 是 的時候才會覆蓋。系統對「已有值且與登記不同」的欄位會先把差異集中列出、跳一次確認視窗，按 否 就保留原值。若不小心按了 是，在尚未儲存前按工具列 取消 即可放棄本次所有變更。

看不到「索引分類帳」分頁？

此分頁需具備 ABOOK2（索引分類帳）的瀏覽權限，沒有權限時分頁不會出現。請向系統管理員確認權限設定。

索引分類帳查出來是空的？

分頁預設期間為當月。若這家客戶當月沒有已過帳的傳票往來，結果為空是正常的——把日期起訖往前拉寬再按 查詢 即可看到歷史分類帳。另請確認相關單據是否已完成轉帳與過帳。

看不到「信件搜尋」分頁？

此分頁需具備 MAILSEARCH（信件搜尋）的瀏覽權限，沒有權限時分頁不會出現。若整個帳套都看不到（含主選單的信件搜尋），代表該公司資料庫尚未完成信件搜尋的一次性部署，請洽系統管理者。

信件搜尋分頁查出來是空的？

依序確認：1）這家客戶的信是否已歸戶——歸戶靠客戶主檔與聯絡人的 Email 比對，Email 空白或寫錯就查不到；2）信件由排程每日同步一次，剛收到的信要等下一輪；3）預設只查近 3 個月，較早的信請把日期起日往前拉再按 查詢；4）本程式只查登記在您名下、屬於目前帳套的信箱。詳見信件搜尋。

「自定義分類」按了設定後分類內容是空的？

自定義分類的項目來自該客戶群組代號對應的群組設定（GRPM）。請先填好群組代號，再按 設定；若群組未定義分類，清單自然是空的。