機台與繳款設備流程
本頁摘要
機台、繳款機、無人設備交易來源；機台號追蹤、冪等重送、訂單版＋機台號規範。
本頁說明以機台、繳款機、無人設備為交易來源的開立情境，以及機台號追蹤、冪等重送等設計要點。
情境特徵
- 交易來源：機台、繳款機、無人設備等。
- 需求：機台號（或設備代碼）納入交易追蹤，類似食品販賣機管理脈絡。
- 常見：離線補送、重送不重開、批次補上傳。
取號與 API 方向
- 以「訂單／交易為主體」設計，搭配 機台號欄位規範。
- 取號責任：由 e首發票協助取號（訂單版模式），來源送「交易資料 ＋ 機台號」。
- API 設計重點：冪等鍵（同一筆交易重送不產生新發票）、補送／重試策略、錯誤回報可被設備或後台排程吸收。
流程圖
flowchart TB
subgraph 設備["機台／繳款設備"]
A[交易發生]
B[產生 交易資料 ＋ 機台號]
C[離線可暫存，連線後補送]
end
subgraph 送交["送交 e首發票"]
D[API：交易資料 ＋ 機台號 ＋ 冪等鍵]
end
subgraph e首發票["e首發票"]
E{同一冪等鍵 已開立?}
F[重送不重開，回傳原結果]
G[取號並開立電子發票]
H[回寫：發票號、狀態、機台號追蹤]
end
subgraph 上傳與追蹤["上傳與稽核"]
I[規定時限內 上傳財政部]
J[機台號 納入交易／稽核追蹤]
end
A --> B
B --> C
C --> D
D --> E
E -->|是| F
E -->|否| G
G --> H
G --> I
H --> J
I --> J
步驟說明
| 步驟 |
說明 |
| 1. 交易與機台號 |
機台／繳款設備產生交易時，一併產出交易資料與機台號（建議固定格式與唯一性規則）。 |
| 2. 送交 e首發票 |
透過 API 送交「交易資料 ＋ 機台號 ＋ 冪等鍵」。離線時可暫存，連線後補送。 |
| 3. 冪等與開立 |
e首發票依冪等鍵判斷：同一筆交易重送不產生新發票，僅回傳原開立結果；新交易則依發票成立條件稽核後取號開立。稽核不通過則拒絕開立並回覆錯誤原因。 |
| 4. 回寫與追蹤 |
回寫發票號、狀態、錯誤原因（開立失敗時）；機台號納入交易與稽核追蹤。 |
| 5. 補送／重試 |
設備或後台排程須依開立失敗訊息進行補送、重試，避免漏開發票。 |
| 6. 上傳財政部 |
於規定時限內上傳財政部；機台號可作為後續對帳與稽核依據。 |
營業人請注意：開立失敗與漏開發票
- 開立時稽核若有發票錯誤，系統會拒絕開立並回覆錯誤原因，避免違規開立。
- 請務必注意開立失敗訊息（API 回傳或回寫狀態）：設備或後台排程須依錯誤原因修正後補送／重試，避免漏開發票。
設計要點
| 項目 |
建議 |
| 機台號 |
固定格式、唯一性規則，利於追蹤與稽核。 |
| 冪等鍵 |
同一筆交易（同一冪等鍵）重送不產生新發票。 |
| 補送／重試 |
離線暫存、連線後批次補送；開立失敗時須依錯誤原因重試，避免漏開。 |
本情境對應 API 使用
對應文件