程式資訊
- 程式 ID:
TICK3PRINT - 所屬子系統:P.發票管理
- 狀態:stable
零稅率清單列印¶
功能簡介¶
「零稅率清單列印」是零稅率主檔(TICK3)的列印伴隨頁,用來把某一所屬年月的零稅率(外銷/出口)銷售清單輸出成可報送國稅局的報表。它不是獨立的單據程式,而是由零稅率主檔工具列的 列印 開啟的列印面板(Tick3PrintViewModel,繼承 PrintPageViewModel)。
使用者主要是會計/稅務人員:在零稅率主檔維護完當期資料後,由此頁帶入所屬年月與報表抬頭的受文者,預覽並列印零稅率銷售額清單。
本頁與「零稅率主檔」是同一條操作流程
本列印頁沒有自己的選單入口,只能從零稅率主檔按 列印 進入;其 ViewModel 的主程式(MainProgramClass)即為 TICK3。完整的建檔、轉入與欄位連動請見零稅率主檔,本頁只說明列印面板本身的兩個輸入欄位與報表行為。
本表單名稱更正
舊 stub 標題為「三聯式發票列印」,與程式真實用途不符。本列印頁服務的母表單為零稅率主檔(TICK3,VFP 原版 報表程式 = "?= TICK3_P,SCX_TICKP"),輸出的是零稅率銷售清單,並非一般三聯式發票。本頁名稱以程式碼為準改為「零稅率清單列印」。
前置需求¶
- 權限:P.發票 →
P-010 零稅率主檔的列印權限(本列印頁掛在零稅率主檔之下,沒有獨立的選單權限)。 - 基礎資料:列印內容取自當期零稅率主檔資料,故下列前置作業會影響列印結果——
| 資料 | 影響什麼 |
|---|---|
| 零稅率主檔(當期資料) | 報表明細的來源;當期沒有資料則無內容可印(請先在零稅率主檔建檔或轉入) |
| 所屬年月 | 決定要印哪一個月的零稅率清單 |
| 公司基本資料(統一編號、稅籍號碼、負責人、發票地點等) | 報表表頭的公司資訊 |
操作步驟¶
- 在零稅率主檔定位到要列印的當期資料,按工具列
列印,開啟本列印頁。 - 確認所屬年月:由母表單帶入目前主檔的所屬年月,必要時可修改成其他月份。
- 確認或修改受文者:預設為「財政部臺灣省北區國稅局中壢分局(稽徵所)」,可改成實際報送的稽徵機關。
- 執行預覽/列印。系統先以
HaveReportData檢查所屬年月是否有值,再產生報表預覽。
列印明細取數尚在整備(規劃中)
新版 C# 目前的取數(TWORK_RPT_TICK3)與報表版型(VFP 對應 TICK3_P/SCX_TICKP)仍以註解保留、尚未啟用:HaveReportData() 目前只檢查所屬年月是否有值,尚未實際抓明細或掛報表來源(GetData、GetCrystalPrintSettings 皆為註解狀態)。完整的零稅率清單列印請以實機驗收為準。
欄位說明¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 所屬年月 | ✔ | 要列印的零稅率清單所屬年月;由母表單按 列印 時帶入目前主檔的所屬年月,可改。HaveReportData 會檢查其不可空白 |
| 受文者 | — | 報表抬頭的受文機關;預設「財政部臺灣省北區國稅局中壢分局(稽徵所)」(程式碼 _受文者 初值),可改 |
公司代碼為內部固定值
ViewModel 另有 公司代碼 屬性,預設 1,作為取數條件之一,不在列印面板上開放輸入。
欄位連動與附加功能¶
本節整理本列印頁「輸入欄位後系統會做什麼」「按列印會發生什麼」,皆取自實際程式碼(Tick3PrintViewModel、PrintPageViewModel)與 VFP 原版 tick3.prg。
由母表單帶入所屬年月¶
當你在零稅率主檔按 列印 進入本頁,母表單會把目前主檔的所屬年月帶入本頁的 所屬年月 欄位,作為要列印月份的預設。你可在本頁直接改成其他月份再列印。
受文者預設值¶
受文者 欄位初值為程式碼內建的「財政部臺灣省北區國稅局中壢分局(稽徵所)」(_受文者)。此值會印在報表抬頭;若報送對象不同,請在列印前手動改為實際的稽徵機關名稱。
列印前檢核(HaveReportData)¶
按預覽/列印時,系統呼叫 HaveReportData():
- 若所屬年月為空白,回傳
false,不會產生報表。 - 所屬年月有值即放行(目前僅做此項檢查)。
明細取數與報表版型尚未啟用(規劃中)
程式碼中負責「以 TWORK_RPT_TICK3 抓當期零稅率明細與公司表頭、組成報表資料列(每 10 筆一頁、發票日期格式化為 MM/DD、輸出日期民國年換算、依經海關 Y/N 分別填海關/非海關金額)」以及「掛 Tick3a 報表版型(GetCrystalPrintSettings)」的邏輯,目前都以註解保留未啟用。因此本頁現階段可帶入所屬年月/受文者並通過檢核,但實際明細列印仍待整備。VFP 原版對應報表為 TICK3_P/SCX_TICKP。
常見問題¶
按了列印卻沒有反應/印不出明細?
本列印頁的明細取數(TWORK_RPT_TICK3)與報表版型在新版 C# 仍以註解保留、尚未啟用,HaveReportData() 目前只檢查所屬年月是否有值。完整的零稅率清單列印請以實機驗收為準(見操作步驟的整備說明)。
所屬年月空白時無法列印?
HaveReportData() 會檢查所屬年月不可空白;空白即不產生報表。請先確認母表單已定位到當期資料、所屬年月已帶入,或在本頁手動補上要列印的月份。
受文者要去哪裡改?是固定的嗎?
受文者 預設「財政部臺灣省北區國稅局中壢分局(稽徵所)」,但不是固定值——可在本列印頁直接修改成實際報送的稽徵機關後再列印。
找不到這支「列印」的選單入口?
本頁沒有獨立選單,只能從零稅率主檔(TICK3)的工具列 列印 進入。它是零稅率主檔的列印伴隨頁,共用同一支主程式(MainProgramClass = TICK3)與列印權限。
相關功能¶
需補截圖清單
以下截圖待列印明細整備並 runtime 驗收後補拍(放 docs/P-Invoice/images/):
tick3print-step1.png— 由零稅率主檔按「列印」進入本頁(所屬年月/受文者輸入面板)tick3print-step2.png— 零稅率清單報表預覽(明細取數啟用後補拍)