[docs] 外銷勞務收款：單據上傳與進度管理設計提案 - #61
Merged
Merged
Conversation
把 2026-08 Zonic (HNT Marketing LLC) 手動走過的外銷勞務收尾流程 （收款 → 水單 → 算台幣銷售額 → 開零稅率發票 → 報單據）收斂成一個 internal 模組的設計：單據上傳 + 進度管理，不把 Simpany 做進流程。 沿用既有 invoices / documents / billing_items / transactions，只補最小欄位 （tax_treatment / exchange_rate / twd_sales_amount / filed_to_authority_on、 documents 的 remittance_cert doc_type、billing_items.zero_rated）。 僅設計文件，無 schema / code 變更。
YJack0000
enabled auto-merge (squash)
September 1, 2026 19:40
Contributor
Author
|
@yui 這份是把這次 Zonic 外銷勞務收尾流程收斂成 internal 模組的設計提案，純設計文件、無 code/schema 變更。範圍已收斂成「單據上傳 + 進度管理，不接 Simpany」。有空幫忙 review 方向，OK 就 approve/merge，謝謝！ |
✅ SonarQube Quality Gate passed — pathorsAI_internal0 open issues on this PR. |
yui0303
approved these changes
Sep 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
這個 PR 是什麼
把 2026-08 Zonic（HNT Marketing LLC）七月期收款手動走過一次的外銷勞務收尾流程，收斂成一個 internal 模組的設計提案。純設計文件，
docs/export-vat-tracking-design.md，無 schema / code 變更。為什麼
外銷勞務收款有一條固定但容易漏的收尾：收款 → 拿水單 → 算台幣銷售額 → 開零稅率發票 → 報單據。這次全程手動——收款要翻銀行明細、水單要翻 contact@ 信箱、台幣銷售額手算、進度靠記憶。這模組要消掉這些痛點。
範圍（刻意收斂）
只做兩件事：單據有地方上傳、進度看得到追得動。不把 Simpany 做進流程——開發票、申報上傳仍由人在 Simpany 手動，internal 只記結果。
設計要點
invoices/documents/billing_items/transactions本來就為這件事鋪過路（external_status/external_ref註解已寫明「Simpany 才是發票真相來源」）。invoices：tax_treatment/zero_rate_reason/exchange_rate/twd_sales_amount/filed_to_authority_ondocuments：doc_type增加remittance_cert（水單）billing_items：zero_rated旗標attach_remittance_cert/compute_zero_rated_invoice/mark_einvoice_issued/mark_filed_to_authority。Schema 影響
本 PR：無。 這是設計文件。schema 變更會在設計 approve 後的實作 PR 才動，屆時走
/prod-migrate。驗收
Review 設計方向。實作分階段（見文件 §8），第一筆真實驗收資料就是本次 Zonic 七月期（台幣銷售額 418,737）。