離線電子發票API技術文件 / 使用流程圖說明

以下內容為「離線電子發票」的詳細使用流程與指南，並提供各步驟的重點與注意事項。
請依照以下流程進行設定與開立離線發票。

一、查詢財政部配號結果

1. 呼叫 <查詢財政部配號結果API>
   • 透過此 API 取得財政部配號結果，用於後續字軌與配號的設定。

二、管理發票機台

1. 呼叫 <管理發票機台 API>
   • 設定所有需要使用的機台 ID。
   • 每一台機台對應到實體開立發票的裝置。

三、設定字軌與配號

1. 呼叫 <字軌與配號設定API>
   1.1 設定每個機台上欲使用的字軌號碼區間。
   1.2 請記住回傳的 TrackID，以便後續設定字軌狀態時使用。
   1.3 可設定多組字軌號碼區間：
   – 最早設定的字軌區間會自動被啟用。
   – 其餘設定的字軌號碼區間則會進入審核通過的備用狀態。

四、開始開立發票

正式開始開立離線電子發票時，需依序進行以下步驟：

4.1 取得目前啟用中的字軌號碼區間

1. 呼叫 <取得發票字軌號碼區間API>
   • 查詢特定機台目前「啟用中 (InvoiceStatus=1)」的字軌號碼區間。
2. 判斷回傳參數 Times（已取次數）
   • Times 可幫助判斷該組字軌號碼區間是否曾經被取用過。 

    3. 開始開立發票

    4. 上傳已開立發票

4.2 若目前已啟用的字軌用完，則需啟用下一組字軌

• 當啟用中的字軌號碼區間已開立用完但尚未上傳，需呼叫 <設定字軌號碼狀態API> 帶入 TrackID，以啟用下一組字軌。
• 若已上傳完該組字軌號碼區間的最後一張發票，系統會自動啟用下一組備用字軌，可免再呼叫狀態設定 API。

4.3 重複4.1~4.2

4.4 字軌狀態變更注意事項

1. 單一機台同時間只會有一組字軌號碼區間處於「啟用」狀態。
2. 若已啟用的字軌號碼區間尚未上傳任何發票 ：
   • 執行啟用備用字軌，原本已啟用的字軌會轉為備用(審核通過)。
3. 若已啟用的字軌號碼區間上傳了部分發票：
   • 執行啟用備用字軌，原本已啟用的字軌會轉為暫停。
4. 若已啟用的字軌號碼區間上傳了全部發票：
   • 原已啟用的字軌會直接被停用，並自動啟用下一組備用字軌。
5. 可呼叫 <查詢字軌API> 來查看所有字軌的狀態（啟用、備用、暫停、停用等）。