程式資訊
- 程式 ID:
RTAXMA - 所屬子系統:E.營業收款
- 狀態:stable
報關沖退稅(出口報單)¶
功能簡介¶
「報關沖退稅」用來彙整一筆出口報關所需的明細,產出一張出口報單(彙總單號以 RT 開頭)。每張單以一個客戶為主體,逐列登錄出口品項的起訖箱號、品號、單箱數量、單箱淨重/毛重、箱長寬高與材積,系統自動算出每列的數量與重量、並在單據底部加總總金額、總箱數、總淨重、總毛重、總材積與總數量描述,作為報關文件與沖退稅申請的依據。
適合外銷出貨/報關承辦人員在出貨完成、準備報關時使用;在銷售流程中位於出貨之後、商業發票(CI)同階段的報關文件產出環節。
與裝箱單的關係
本單據沿用裝箱(PK)的箱號/材積概念來組裝報單明細。VFP 舊版在新增時會開啟 rtaxma_m 挑單視窗,從出貨單據(PK / CI)彙總轉入明細並回寫主檔「轉入單號」。此挑單轉入機制目前尚未提供,新版先以手動逐列輸入上線,詳見欄位連動與附加功能。
前置需求¶
- 權限:E.營業 →
E-120 報關沖退稅的瀏覽/新增/修改/刪除/列印權限。 - 基礎資料:下列主檔需先維護,否則對應欄位會帶不出值或無法存檔——
| 資料 | 影響什麼 |
|---|---|
| 客戶主檔 | 主檔客戶代號驗證與帶出客戶簡稱;查無代號會跳「查無客戶代號」 |
| 品號主檔(vw_invent) | 明細品號驗證、帶出品名、補帶單位;查無或停用的品號無法使用 |
| 公司代碼(C101) | 表頭公司代碼下拉選單來源 |
操作步驟¶
新增一張出口報單¶
- 從主選單開啟 E 營業 → 報關沖退稅。
-
點選工具列
新增。- 彙總日期自動帶今天(單號
RT編號取此日期的年月)。
- 彙總日期自動帶今天(單號
-
在表頭填寫(參見欄位說明):
- 客戶代號(必填):輸入後自動帶出右側客戶簡稱。
- 彙總日期(必填):報單的彙總基準日。
- 視需要填報單號碼、公司代碼、頁首 CINO、商品名稱、頁首備註/頁尾備註/正嘜等文件用文字。
- 在明細表逐列輸入出口品項:
- 填起始箱號與截止箱號,系統自動算出 箱數=截止箱號 − 起始箱號 + 1。
- 填品號,系統驗證並帶出品名、補帶單位。
- 填單箱數量,系統自動算出該列數量。
- 填單箱淨重/單箱毛重,系統自動算出該列淨重/毛重。
- 填箱長/箱寬/箱高後,按該列的
計算材積鈕算出單箱材積。
- 底部合計列即時更新總金額、總箱數、總淨重、總毛重、總材積、總數量。
-
點選
儲存。小技巧
可用 Ctrl+S 快速儲存。
-
存檔通過驗證後,彙總單號由系統自動產生(
RT+ 年月 + 流水號)。
修改與刪除¶
- 用工具列的瀏覽鈕(第一筆/上一筆/下一筆/最後一筆)或查詢移動到目標單據。
- 按
修改進入編輯,調整表頭或明細後儲存。 - 整列不要的明細,將該列品號清空即可——存檔時品號空白的明細列會被自動標記刪除(見欄位連動與附加功能)。
- 整張單據作廢按
刪除。
列印¶
- 移動到要列印的單據。
- 按
列印產出出口報單報表。
報表移植中
VFP 對應報表為 RTAXMA_P。此報表在新版尚未移植,列印功能目前未提供;如需報關文件請暫以畫面資料人工製表。
欄位說明¶
表頭欄位¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 彙總單號 | — | 系統產生,唯讀。格式 RT + 彙總日期年月 + 流水號 |
| 客戶代號 | ✔ | 輸入後帶出客戶簡稱;查無代號會提示 |
| 報單號碼 | — | 出口報單號,文字 |
| 彙總日期 | ✔ | yyyy/MM/dd,新增時預設今天 |
| 公司代碼 | — | 下拉選單(來源 C101) |
| 頁首 CINO | — | 報單頁首之商業發票號碼,文字 |
| 製表日期 | — | yyyy/MM/dd |
| 轉入單號 | — | 唯讀。記錄轉入來源單號(多張逗號串接,最長 220 字);目前需配合挑單轉入才會有值 |
| 備註 | — | 文字 40 字 |
| 商品名稱 | — | 文字 120 字 |
| 頁首備註/頁尾備註/正嘜 | — | 多行文字,列印報單時使用 |
明細欄位¶
| 欄位 | 必填 | 說明/格式/預設 |
|---|---|---|
| 項次 | — | 系統序號,唯讀 |
| 客戶代號 | — | 文字 |
| CI No. | — | 該列對應的商業發票號 |
| 前置文字 | — | 嘜頭前置字串 |
| 起始箱號/截止箱號 | — | 整數;輸入後自動算箱數 |
| 箱數 | — | 自動帶=截止箱號 − 起始箱號 + 1 |
| 列印箱數 | — | 報表用箱數,可手動覆寫 |
| 品號 | ✔(該列要保留時) | 驗證存在且未停用,帶出品名、補帶單位;空白的列存檔時視為刪除 |
| 客戶品號/客戶訂單號/客戶貨名 | — | 文字 |
| 單價 | — | 6 位小數;金額計算用,需有檢視金額權限才顯示 |
| 單箱數量 | — | 2 位小數;輸入後自動算該列數量 |
| 數量 | — | 自動帶=ROUND(單箱數量 × 虛擬箱數, 0),唯讀 |
| 單箱淨重/單箱毛重 | — | 2 位小數;輸入後自動算該列淨重/毛重 |
| 淨重/毛重 | — | 自動帶=ROUND(單箱淨重/單箱毛重 × 箱數, 2),可手動覆寫,但下次重算時會被蓋回 |
| 箱長/箱寬/箱高 | — | 1 位小數;供按 計算材積 算單箱材積 |
| 單箱材積 | — | 由 計算材積 鈕算出,亦可手動輸入 |
| 產品描述/單位 | — | 文字 |
底部合計(唯讀,系統加總)¶
| 欄位 | 說明 |
|---|---|
| 總金額 | Σ ROUND(單箱數量 × 單價 × 虛擬箱數, 2) |
| 總箱數 | Σ 箱數 |
| 總淨重 | Σ ROUND(單箱淨重 × 箱數, 2) |
| 總毛重 | Σ ROUND(單箱毛重 × 箱數, 2) |
| 總材積 | Σ ROUND(單箱材積 × 箱數, 2) |
| 總數量 | 依單位分組加總數量,串成「123 PCS,45 SET」格式 |
欄位連動與附加功能¶
這一節列出本表單所有「輸入某欄位/按某鈕後系統會做什麼」,皆對應實際程式行為。
表頭連動¶
- 輸入客戶代號 → 系統以客戶代號查客戶主檔帶出客戶簡稱;若代號有填但查不到簡稱,會跳出「查無客戶代號 !!!」。移動單據時也會重新帶簡稱。
- 新增單據 → 彙總日期自動帶今天(若原本為空);單號編號取此日期的年月。
明細列即時計算¶
- 輸入起始箱號或截止箱號(離開欄位時) → 自動重算 箱數 = 截止箱號 − 起始箱號 + 1,並連帶重算該列的數量/淨重/毛重。
- 輸入單箱數量(離開欄位時) → 自動重算 數量 = ROUND(單箱數量 × 虛擬箱數, 0)。其中虛擬箱數=「截止箱號為 0 時取 1,否則取箱數」(單箱品項不靠箱號的情形以 1 計)。
- 輸入單箱淨重(離開欄位時) → 自動重算 淨重 = ROUND(單箱淨重 × 箱數, 2)。
- 輸入單箱毛重(離開欄位時) → 自動重算 毛重 = ROUND(單箱毛重 × 箱數, 2)。
- 輸入品號(離開欄位時) → 以品號查
vw_invent驗證:- 查無品號 → 跳「查無品號 !!!」,清空品名。
- 品號為停用狀態 → 跳「品號停用 !!!」。
- 驗證通過 → 帶出品名;若該列單位為空,補帶品號主檔的單位。
- 此處只做標準驗證與帶品名/單位,不帶單價、不覆寫產品描述。
計算材積 鈕(明細列)¶
- 在編輯/新增模式下按該列的
計算材積鈕 → 以箱長×箱寬×箱高換算:單箱材積 = ROUND(箱長 × 箱寬 × 箱高 ÷ 1,000,000 × 35.3147, 2)(公分立方 → 立方呎),算完後一併重算底部合計。非編輯模式下按鈕無作用。
底部合計連動¶
- 只要任一明細列的品號、箱數、截止箱號、單箱數量、單價、單箱淨重、單箱毛重、單箱材積、數量、單位有變動,系統就會重算整張單的合計。
- 加總只計入品號非空白、且未被標記刪除的明細列。總數量會把各列數量依單位分組加總,輸出成「
123 PCS,45 SET」這種逗號串列。
存檔驗證¶
按 儲存 時系統會檢查:
- 彙總日期未填 → 擋下並提示輸入。
- 客戶代號未填 → 擋下並提示輸入。
- 明細中品號空白的列會自動標記為刪除(不會存進資料庫)。
轉入挑單(規劃中/尚未提供)
VFP 舊版按 新增 進入新增模式後會開啟 rtaxma_m 視窗,讓使用者從出貨單據(依 PK/CI)勾選並彙總轉入明細,再把來源單號回寫到主檔轉入單號欄(可放多張、最長 220 字)。新版目前未移植此挑單轉入,明細需手動逐列輸入;轉入單號欄因此通常為空。此功能列為後續待辦。
常見問題¶
存檔時一直被擋,提示要輸入欄位?
本單的兩個必填是彙總日期與客戶代號。彙總日期在新增時會自動帶今天,若被清空就要補回;客戶代號需填一個有效的客戶。兩者任一空白都會擋存。
明細填了品號卻跳「查無品號」或「品號停用」?
品號是對 vw_invent 驗證的。「查無品號」表示該品號在品號主檔不存在;「品號停用」表示該品號已被設為停用狀態。請確認品號正確且為啟用狀態。停用品號不可帶入。
箱數/數量/淨重/毛重欄位都是 0,沒有自動算?
這些是連動欄,要先填來源欄並離開(跳出)該格才會觸發計算:箱數要先填起/止箱號;數量要填單箱數量;淨重/毛重要填單箱淨重/單箱毛重。直接改唯讀的結果欄沒有意義,會在下次重算時被蓋掉。
按了箱長寬高,單箱材積還是 0?
材積不是輸入箱長寬高就自動算,要按該列的 計算材積 鈕才會以「箱長×箱寬×箱高 ÷ 1,000,000 × 35.3147」換算成立方呎。另外此計算只在新增/修改模式下有效。
想刪掉一列明細怎麼做?
把該列的品號清空即可——存檔時品號空白的列會自動被視為刪除,不會寫入資料庫。
主檔「轉入單號」一直是空的,怎麼從出貨單帶明細進來?
從出貨單(PK/CI)挑單彙總轉入的功能(VFP 的 rtaxma_m)目前尚未移植,所以「轉入單號」通常為空、明細需手動輸入。請見欄位連動與附加功能的「轉入挑單」說明。
相關功能¶
需補截圖清單
以下截圖待功能 runtime 驗收後補拍(放 docs/E-SalesOrder/images/):
rtaxma-step1.png— 表頭區(客戶代號、彙總日期、報單號碼等)rtaxma-step2.png— 明細表(含起訖箱號、品號、單箱數量與計算材積鈕)rtaxma-step3.png— 底部合計列(總金額/總箱數/總淨重/總毛重/總材積/總數量)