上傳教學：建立服務業科目表

本頁適合導入顧問、系統管理員或負責維護科目表的人員。這次練習把公司的科目清單整理成檔案，建立「初本範例公司－服務業練習科目」範本，確認內容後啟用，供後續交易練習使用。

只需查閱或切換既有範本時，請看科目範本操作參考。

開始前準備

切換到練習工作空間，確認具備範本檢視、上傳及啟用權限。先記下目前啟用的範本名稱，完成練習後可切換回原範本。本例沿用初本範例公司的七個科目，供服務收款、租金、設備與折舊練習；不是完整的正式公司科目表。

一、準備科目資料

自訂範本檔案欄位

CSV 第一列使用下列英文欄位名稱，JSONL 則以相同名稱作為每行物件的鍵。code、name、normal_balance 必填；其餘欄位可省略。

欄位	意義	必填／預設	格式與限制	本例填法
`code`	科目編號，用於分錄與查帳	必填	1–64 個英數字元；字母轉大寫，保留前置零；同一檔案不得重複	`1111`
`name`	科目名稱	必填	去除前後空白後，1–120 字；CSV 名稱含逗號時以雙引號包住	`銀行存款`
`desc`	科目的適用交易或說明	選填；可留空	最多 4,000 字；CSV 內容含逗號時以雙引號包住	`收取設計服務款與支付費用`
`normal_balance`	一般正常餘額方向；抵銷科目會反轉此方向	必填	`debit` 為借方，`credit` 為貸方	銀行存款填 `debit`；服務收入填 `credit`
`status`	是否可供新增分錄選用	選填；預設 `active`	`active` 啟用、`inactive` 停用；群組科目仍不可直接用於分錄	`active`
`is_group`	是否為分類與彙總用的群組	選填；預設 `false`	CSV 使用 `true/false` 或 `1/0`；JSONL 使用布林值 `true/false`	七個明細科目均填 `false`
`is_asset`	是否提示建立資產	選填；預設 `false`	格式同 `is_group`；借方使用且未連結資產時，陳核前提示建立資產	電腦設備填 `true`
`is_contra`	是否為抵銷科目	選填；預設 `false`	格式同 `is_group`；設定為 `true` 會反轉一般借貸方向	累計折舊填 `true`，其餘填 `false`

下載或建立 CSV

下載初本範例公司科目表 CSV，或將以下內容存成 UTF-8 的 service-company.csv。下載檔採用 UTF-8 BOM，方便試算表辨認中文字元；第一列是欄位名稱，其餘七列各是一個科目。

code,name,desc,normal_balance,status,is_group,is_contra,is_asset
1111,銀行存款,收取設計服務款與支付費用,debit,active,false,false,false
1511,電腦設備,記錄教學用電腦成本,debit,active,false,false,true
1519,累計折舊－電腦設備,電腦設備的累計折舊,debit,active,false,true,false
3111,資本,範例期初資金投入,credit,active,false,false,false
4111,設計服務收入,設計服務收款,credit,active,false,false,false
6111,租金費用,支付辦公室租金,debit,active,false,false,false
6121,折舊費用,認列電腦設備折舊,debit,active,false,false,false

normal_balance 使用 debit（借方）或 credit（貸方），active 表示啟用，is_group=false 表示可用於分錄的明細科目。本系統的抵銷旗標會反轉一般借貸方向，因此 1519 沿用資產的 debit 並設定 is_contra=true；其有效正常餘額方向為貸方。

使用試算表整理時，將科目編號欄設為文字，以保留前置零；另存成 CSV UTF-8（可帶 BOM），不要上傳 .xlsx。正式使用前，請由負責科目表的人員核對編號及性質。

二、上傳並命名

進入「設定」→「科目範本」，按次側欄「新增科目範本」，開啟 /workspace/settings/account-templates/new。
在「範本檔案」選取 service-company.csv。頁面也提供「下載 CSV 範例」與「下載 JSONL 範例」按鈕，可取得最小格式範例。
將「範本名稱」由預設的 service-company 改成「初本範例公司－服務業練習科目」。
按「建立範本」。成功後會開啟新範本預覽，次側欄出現剛才的名稱與「7 個科目」；目前啟用的範本尚未改變。

三、預覽、啟用並核對

在「範本科目預覽」確認七個編號與名稱，尤其是 1111 銀行存款、4111 設計服務收入，以及 1519 的抵銷性質。
確定要在練習工作空間使用後，按「啟用範本」。次側欄應顯示「已啟用」，摘要的「目前啟用」應為「初本範例公司－服務業練習科目」。
回「科目」搜尋 1111、4111 及 6111，核對名稱與借貸別。再到傳票草稿試選銀行存款與設計服務收入，確認可選用；不必保存測試傳票。

完成結果： 自訂範本已保存並啟用，可接續初本範例公司的交易練習。啟用會替換原本的基礎科目；個別科目調整與自訂科目仍保留，因此實際科目清單不一定只有七筆。上傳與啟用本身都不會產生傳票或入帳。

啟用後更新其他範本

本教學的七個科目不等於完整的「2014 年商業會計項目表」。系統預設報表與其他引用科目的範本使用原系統科目表的編號，不能只因新科目名稱相似就繼續套用。

啟用後，逐份檢查並更新所有報表，以及傳票、憑證與跨期作業引用的範本；修改科目編號、前綴與公式後重新預覽並核對。系統不會自動調整既有範本。完整清單見科目表變更後的範本核對。

改用 JSONL

若資料由其他系統匯出，可下載相同七個科目的 JSONL。每行是一個 JSON 物件，不要加外層陣列或行尾逗號。以下兩行示範一般科目與抵銷科目：

{"code":"1111","name":"銀行存款","desc":"收取設計服務款與支付費用","normal_balance":"debit","status":"active","is_group":false,"is_contra":false,"is_asset":false}
{"code":"1519","name":"累計折舊－電腦設備","desc":"電腦設備的累計折舊","normal_balance":"debit","status":"active","is_group":false,"is_contra":true,"is_asset":false}

選取 service-company.jsonl 後，依相同流程命名、建立及預覽即可；CSV 與 JSONL 選一份上傳，不需要重複建立。

排除上傳錯誤

科目編號保留前置零，字母轉為大寫。重複編號、空科目表或無效資料列會拒絕整份上傳。例如把第二個科目編號誤填為 1111，會顯示科目編號重複；將檔案內電腦設備的編號改回 1511，重新選取修正後的檔案，再按「建立範本」。

驗證失敗時保留目前選取的檔案與名稱供核對。按「取消」返回摘要頁；上傳期間「取消」與「建立範本」暫時停用，避免重複送出。此頁不提供已上傳範本的編輯；未啟用的自訂範本可在詳情頁刪除。

下一步

建立新科目編號前，閱讀科目編號與報表 DSL，確認編號前綴如何影響報表選取。

完成後可接續初本範例公司的交易練習。需要切換或刪除未啟用的自訂範本，閱讀科目範本操作參考；需要修改個別科目，閱讀科目查詢與維護。