財政部

在我寫這篇文章的當下，財政部剛好在上個月底推出了最新的「電子發票應用 API 規格」版本 v1.9，可以參考這個連結。

實在是熱騰騰的規格書XD 因此這系列的文章會以這一版的規格為主。這次主題是電子發票，因此我們來看看「電子發票應用 API 規格 v1.9」。

電子發票應用 API

基本上看這這份文件就可以進行開發發票 API

呼叫 API 基本上要準備 3 項要素：

1. API 參數
2. AppID
3. APIKey

而這時候思考 AppID 和 APIKey 從哪裡來，先不要急，我們繼續看下去

原來是這樣，我們必須先向財政部申請帳號，才可以去取得 API 權限 (滿合理的)

API 服務

財政部的 API 以 https 協定對 https://api.einvoice.nat.gov.tw/[API Method] 送出請求，請求方法皆以 POST，回傳以 JSON 方式。

從這張圖可以得知，財政部 API 提供很多發票方法，而這次我主要會應用到的有

1. 紙本電子發票查詢 → 查詢發票明細
2. 確認載具有效 → 手機條碼歸戶載具查詢
3. 抓載具的發票 → 載具發票表頭查詢、載具發票明細查詢

大家發現了嗎？昨天埋的伏筆這邊偷偷回收了，抓載具發票是分成兩段式，也因此發票 APP 會先拿到所有載具存入的發票，僅接著才可以再拿載具條碼、發票日期、發票號碼等等資訊再去拿到發票購買明細。