程式資訊
- 程式 ID:
RTAXDOC - 所屬子系統:B.基本資料
- 狀態:stable
退稅文件¶
功能簡介¶
「退稅文件」維護外銷沖退原料稅所依據的海關核准文件清單。每一份核准文件登記了:核准文號、對應的成品規格、效期區間,以及該文件可用於沖退稅的應用原料/退稅原料與其數量、重量。
報關人員或負責沖退稅的會計人員會先在這支表單把海關核發的退稅核准文件建檔,之後在報關沖退稅 (RTAXMA) 製作出口報單、計算沖退稅時,即以這裡登記的核准文號與退稅原料為依據。它屬於基礎主檔,位在「先建文件、後製報單」流程的最前段。
與報關沖退稅的分工
本表單 (退稅文件, B-110) 只負責登記核准文件本身;實際把出口報單金額換算成沖退稅、產生報關明細的是報關沖退稅 (RTAXMA, E-120)。兩者程式不同、英文代碼相近(RTAXDOC/RTAXMA),維護時請勿混淆。
前置需求¶
- 權限:B.基本資料 →
B-110 退稅文件的相應權限(瀏覽/新增/修改/刪除)。
| 資料 | 影響什麼 |
|---|---|
| 海關核發之退稅核准文件 | 核准文號、起始效期/截止效期 等欄位的填寫依據(來自實體公文,非系統其他主檔) |
| 報關沖退稅 (RTAXMA) | 本表單登記的核准文號與退稅原料,是製作出口報單沖退稅時的引用來源 |
原料欄位為自由輸入
應用原料、退稅原料 在程式中是純文字欄位,不會自動連動到料件主檔做驗證,請依核准文件上記載的料號/品名照實填入。
操作步驟¶
退稅文件採「上方主檔資料卡 + 清單」的單層主檔結構,主鍵為單號+項次,所有操作走系統共用工具列。
查詢既有資料¶
- 進入「退稅文件」。
- 按工具列
查詢,輸入條件(如單號)後帶出符合的文件清單。 - 在清單中點選某一筆,上方資料卡會顯示該筆的完整內容。
新增一份退稅文件¶
- 按工具列
新增。 - 在 單號 輸入此份文件的主鍵單號。
- 在 項次 輸入項次(同一單號下用項次區分多筆明細)。
- 填入 核准文號、成品規格。
- 填入 起始效期、截止效期(效期日期)。
- 填入 應用原料、原料數量、退稅原料、申請重量、申請數量。
- 按工具列
存檔。
修改 / 刪除¶
- 先
查詢帶出資料並點選要處理的那一筆。 - 修改:直接在資料卡上改欄位後按
存檔。 - 刪除:按
刪除後再存檔。
單號+項次為主鍵
單號 與 項次 兩欄共同構成主鍵。存檔後若要更換主鍵值,請刪除原筆後重新新增;同一組「單號+項次」不可重複。
審核¶
本表單帶有審核欄位(已審核/審核人員/審核日期)。若該程式在貴公司啟用了審核或工作流程,新增後需經 審核 才算正式生效;審核狀態由系統依登入者與時間自動記錄。詳見欄位連動與附加功能。
欄位說明¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 單號 | ✔ | 文件單號,主鍵之一,最長 20 字;預設空字串 |
| 項次 | ✔ | 同一單號下的項次,主鍵之一,最長 6 字;預設空字串 |
| 核准文號 | — | 海關核發的退稅核准文號,最長 20 字;預設空字串 |
| 成品規格 | — | 對應的成品規格描述,最長 20 字;預設空字串 |
| 起始效期 | — | 核准文件生效日,日期欄;預設空字串 |
| 截止效期 | — | 核准文件失效日,日期欄;預設空字串 |
| 應用原料 | — | 可動用的原料(自由輸入文字),最長 10 字;預設空字串 |
| 原料數量 | — | 應用原料數量,數值(總長 13 位、其中小數 6 位 → 整數 7 位);預設 0 |
| 退稅原料 | — | 可沖退稅的原料(自由輸入文字),最長 19 字;預設空字串 |
| 申請重量 | — | 申請退稅重量,數值(總長 5 位、無小數 → 整數 5 位);預設 0。對應 DB 欄位 退稅重量 |
| 申請數量 | — | 申請退稅數量,數值(總長 5 位、無小數 → 整數 5 位);預設 0。對應 DB 欄位 退稅數量 |
畫面名稱與資料庫欄名的差異
畫面上的 申請重量/申請數量,在資料庫對應的欄位名分別是 退稅重量/退稅數量(程式以屬性名顯示、以欄名存取)。比對資料庫或匯出資料時請對照這組名稱,欄位空白通常是名稱對不上而非沒資料。
欄位連動與附加功能¶
退稅文件是單純的設定主檔,沒有客製化的計算、帶值或外開視窗邏輯;可運作的行為來自系統共用框架:
-
新增時的預設值:按
新增時系統建立一筆空白資料卡,所有文字欄位預設為空字串、數值欄位(原料數量/申請重量/申請數量)預設為 0,增刪修狀態標記為「新增 (A)」。沒有任何欄位會自動帶入今天日期或流水號,需逐欄輸入。 -
主鍵唯一性檢核:存檔時由框架檢核單號+項次這組主鍵,重複時擋下存檔。
-
效期欄位:起始效期/截止效期 使用日期輸入控件,輸入後依系統日期格式格式化;程式本身不會自動以「截止效期 ≥ 起始效期」互相比對或自動回填,請自行確認區間正確。
-
原料欄位無主檔連動:輸入 應用原料/退稅原料 後,系統不會去料件主檔查名稱、也不會自動帶出單位或數量,這兩欄是依核准文件照實登錄的文字。
-
審核 / 工作流程:Source 含 已審核/審核人員/審核日期/工作流程 欄位,代表本表單接入系統共用的審核機制。當該程式啟用審核時:
- 按
審核由系統把目前登入者寫入 審核人員、當下日期寫入 審核日期、已審核 標記為已審核。 - 若進一步設定了工作流程,則依 工作流程 欄位走簽核關卡。 這些值由系統自動記錄,畫面上沒有對應的可輸入欄位。
- 按
-
聯絡單關聯:Source 另含 聯絡單id,供與聯絡單(L 通訊聯絡)模組串接時記錄關聯,一般使用者不需手動維護。
尚未提供的延伸功能
本表單目前沒有列印報表、Excel 匯入匯出、轉傳票或附件等延伸功能;上方工具列以外的按鈕若未出現,即表示該功能在本程式未啟用。
常見問題¶
為什麼一份核准文件要用「單號+項次」兩個主鍵?
同一份核准文件可能涵蓋多種退稅原料或多筆規格,系統以單號代表該份文件、以項次區分文件下的每一筆明細,兩者合起來才是唯一鍵。實務上是「一文件、多項次」的拆列方式,而非每一筆都各自獨立一個單號。
「應用原料」「退稅原料」要填料號還是品名?
這兩欄是自由文字,程式不會對到料件主檔做驗證,請直接依海關核准文件上記載的內容(料號或品名)照實填入。若要與後續報關沖退稅一致,建議全公司統一填法。
申請重量/申請數量存了卻在資料庫查不到對應欄位?
畫面上的 申請重量/申請數量 在資料庫的實際欄名是 退稅重量/退稅數量。查資料庫或匯出時請改用後者比對,詳見欄位說明的備註。
數值欄位顯示 0、存檔後沒有變?
原料數量/申請重量/申請數量 預設值即為 0,未輸入就會維持 0。其中申請重量與申請數量為整數欄位(無小數位),輸入小數會被截掉,請確認輸入的是整數。
新增後找不到剛建好的資料?
新增存檔後需再按 查詢 重新帶出清單才會看到該筆;若仍找不到,請確認單號+項次未與既有資料重複而被擋下存檔。
相關功能¶
- 報關沖退稅 (RTAXMA):使用本表單登記的核准文號與退稅原料製作出口報單沖退稅。
- 稅別表:維護系統各類稅別設定。
- 基本資料模組首頁
需補截圖清單
以下截圖待 runtime 驗收後補拍(放 docs/B-BasicData/images/):
rtaxdoc-step1.png— 退稅文件主畫面(資料卡 + 清單)rtaxdoc-step2.png— 新增一筆退稅文件、輸入單號/項次/核准文號的資料卡rtaxdoc-step3.png— 查詢條件面板與帶出的文件清單