觀念說明：科目編號與報表 DSL

本頁適合負責科目表與報表範本的人員。上傳科目表時，code 是辨識科目的編號；編寫報表 DSL 時，大括號內也是這個編號。選取依編號與前綴判斷，科目名稱不參與比對。

科目編號、科目名稱與報表列名

以上傳教學中的銀行存款為例：

項目	本例	用途
科目編號 `code`	`1111`	傳票分錄與 DSL 以此辨識科目
科目名稱 `name`	`銀行存款`	方便在科目清單辨認；改名稱不會改編號
報表列名	`可用銀行資金`	報表自行命名的列，可以與科目名稱不同
科目選取	`{1111}`	取得該編號或其更長同前綴科目的金額
報表列參照	`$可用銀行資金`	引用前面已計算的報表列，不是查科目名稱

銀行檢查
    可用銀行資金: {1111}
    _資金合計: $可用銀行資金

{銀行存款} 不會按名稱找到 1111，可能得到零。名稱改成「主要銀行帳戶」後，原本的 {1111} 仍以編號選取。

科目編號是文字

科目編號可使用 1–64 個英數字元，上傳時字母轉成大寫，前置零保留。DSL 請填與實際科目一致的完整編號，英文字母也使用大寫。

科目編號	DSL 寫法	注意事項
`1111`	`{1111}`	不加千分位符號
`0011`	`{0011}`	與 `11` 是不同編號；前置零不能省略
`BANK01`	`{BANK01}`	支援英數編號，不必改成純數字

CSV 用逗號分隔欄位，DSL 大括號內的逗號則分隔多個科目。不要把科目名稱的逗號帶入選取式；CSV 名稱的處理見上傳教學。

選一個、選多個或選範圍

以下例子沿用服務業科目表的七個明細編號，假設沒有更長的同前綴科目：

想選取的項目	DSL 選取式	本例涵蓋的科目
銀行存款	`{1111}`	`1111`
銀行存款與電腦設備	`{1111,1511}`	`1111`、`1511`
租金與折舊費用	`{6111,6121}`	`6111`、`6121`
設備編號區間	`{1511..1519}`	展開 `1511` 到 `1519`，兩端都包括；本例有值的科目是 `1511`、`1519`
資產編號前綴	`{1}`	`1111`、`1511`、`1519`

數字範圍使用兩個半形句點 ..，不是省略號；清單可混用範圍，例如 {1111,1511..1519}。範圍會選入區間中的每個編號，日後新增 1512 也會納入；{0011..0013} 則會保留四位數寬度。範圍起訖各不得超過 64 位，且同一份報表在去重前最多展開 10,000 個科目編號；超過時須縮小範圍或改用已確認的科目代號。

英數編號請明確列出，例如 {BANK01,BANK02}，不要用數字範圍寫法推算英數序列。此外，系統不支援 {11*}、{11?} 這類萬用字元寫法；選取同前綴科目時請直接用 {11}，並先核對實際會涵蓋的編號。

有更長同前綴編號時，選取會展開

系統先找出比選取代號更長、且以它開頭的科目。若找得到，便選這些科目並省略代號本身；找不到時才直接取該代號。

已知科目編號	選取式	實際選取
`1111`	`{1111}`	`1111`
`1111`、`111101`、`111102`	`{1111}`	`111101`、`111102`；不再加 `1111`
`1511`、`1519`	`{15}`	`1511`、`1519`；即使沒有建立 `15` 群組也會展開
`1111`、`BANK01`	`{1}`	`1111`；名稱同樣叫銀行存款的 `BANK01` 不在此範圍

這項規則不以 is_group 旗標判斷。is_group 控制科目是否只能分類與彙總；DSL 則看編號前綴。已知編號包含目前科目表與傳票明細引用的編號，因此切換範本後，歷史分錄中的代號仍可能影響前綴展開。

若 1111 已有交易，後來增加 111101，原來的 {1111} 可能不再計入 1111 本身的交易。規劃編號時，先決定哪些前綴供分類、哪些編號供實際登錄；在已使用的明細編號後增加子編號前，重新核對所有相關報表。

同次選取去重，不同列仍會各自計算

{1,1111} 展開後，重複的 1111 在這一次選取只計一次。但下面兩列各自計算，合計時便可能重複：

重疊選取示範
    資產前綴: {1}
    銀行存款: {1111}
    _重複合計: $資產前綴 + $銀行存款

本例 {1} 已包含銀行存款，因此不要再把銀行那列加一次。要分項再合計，可選不重疊的明細：

資產項目檢查
    銀行存款: {1111}
    電腦設備: {1511}
    累計折舊: {1519}
    _所列項目合計: $銀行存款 + $電腦設備 - $累計折舊

本例 1519 設為抵銷科目，貸方淨額會反轉成正數，因此這裡扣除該列。這只檢查列出的三個科目，不是完整資產負債表；其他科目設計須重新核對符號，不能直接套用。

科目編號決定選取，期間與交易決定金額

一般科目的報表值為期間內已同意傳票的「借方 − 貸方」，抵銷科目會反轉符號。科目正常餘額設定不會讓一般收入自動顯示為正數。

服務收入與租金
    收入正數: -{4111}
    租金費用: {6111}
    _收入減租金: $收入正數 - $租金費用

完成初本範例公司的一月交易、查詢期間為 2026-01-01 至 2026-01-31 時，這三列應為 30,000、12,000、18,000 元。只上傳科目表但尚無已同意傳票時，不會自動得到這些金額。

零也可能代表編號拼錯、期間不符或傳票尚未同意，不能只因顯示零就認定科目沒有交易。計算與期間的完整說明見報表如何計算。

預設範本使用系統科目表

系統提供的預設報表範本，以及預設範本中引用的會計科目，均以「2014 年商業會計項目表」系統範本為基礎。預設報表包含資產負債表、損益表、現金流量表、期末結帳與期初開帳；其 DSL 中的編號、前綴與範圍依這份科目表設計。

要檢查的範本	更新與驗收重點
所有報表範本，含預設與自行建立的報表	核對每列 DSL 的科目編號、前綴及範圍，更新合計與正負號公式；用相同期間重新預覽並對照帳冊
傳票範本，含期初、結帳與結轉用途	將明細的科目改為適用的啟用中明細科目，核對借貸方向與平衡
原始憑證範本中預填的會計科目	更新預填明細中的科目，試建立草稿並確認可選用
跨期結算與折舊等作業引用的範本	核對設定仍指向已更新且適用的報表或傳票範本，再預覽作業結果

例如自訂科目表把銀行存款改為 BANK01，原報表的 {1111} 或 {11} 不會按名稱自動轉成 {BANK01}。除了修改報表，傳票與憑證範本中預填的 1111 也須改成適用編號。同樣地，新增 111101 可能改變 {1111} 的前綴展開；改動抵銷性質可能改變計算正負號，即使編號沒有變也須核對公式。

只修改科目名稱不會改變編號選取，但仍需檢查報表列名與範本說明是否符合新用途。更新範本不會改寫歷史傳票，跨期報表仍須兼顧舊編號的交易。

切換科目表後的核對清單

在「科目」確認 DSL 中每個編號與對應用途，保留前置零與英文字母大小寫。
檢查新增編號是否延伸既有明細前綴，或落入原本的數字範圍。
使用相同報表期間重新預覽，逐列對照已同意傳票與帳冊。
檢查合計列是否重疊選取、抵銷科目的正負號是否正確，再保存報表範本。

編號一旦建立便不能在科目詳情修改。切換範本也不會改寫歷史傳票的科目編號；重新規劃科目表時，須連同既有交易與報表引用一起核對。