智慧零售與小額支付：如何透過 e首發票 API 開立悠遊卡與一卡通電子發票
販賣機及停車繳費設備適用 / 常見電子發票載具類型代號完整指南
隨著法規對自動販賣機、停車繳款設備等無人營運設備全面要求開立電子發票，小額支付工具與電子發票的系統整合顯得至關重要。本文將詳細說明財政部常見的載具類型代號，並指導如何利用 e首發票 API 輕鬆完成發票開立串接。
一、財政部常見載具類型與參數定義
在財政部電子發票架構中，不論是「共通性載具」或「非共通性載具」，都有相對應的官方核發類型代號。以下彙整目前市場上最常見的載具類型對照表：
| 載具名稱 | 財政部載具代號 (CarryType) | 實務說明 |
|---|---|---|
| 手機條碼 （共通性載具） |
3J0002 | 民眾最常使用的官方共通載具，格式固定大寫且不含空白。 |
| 自然人憑證條碼 | CQ0001 | 非共通性載具，透過實體國民身分IC卡或綁定條碼使用。 |
| 悠遊卡 | 1K0001 | 非共通性載具，串接時通常以外部讀卡設備讀取。 |
| 一卡通 | 1H0001 | 非共通性載具，小額支付與無人設備常見的票證扣款工具。 |
| 跨境電商電子郵件載具 | 5G0001 | 境外電商（如 Google、Apple 等）開立雲端發票給消費者時專用。 |
| 會員載具 （如各大通路、電商會員） |
依各機構申請而定 | 代碼通常由各發行機構（如量販店、自營電商）向財政部申請後配賦。 |
首先可以從上述與下圖表看到一些常用的共通載具服務。以一卡通為例，財政部標準規範針對電子票證通常要求傳入三個值：Carry Type、Carry ID1 與 Carry ID2，其分別定義如下：
- Carry Type：依照財政部核發的載具類別編碼，一卡通則是 1H0001。
- Carry ID1：依其官方說明是要取得卡片表面印刷之卡號。［但目前實務讀卡並無法直接取得］。
- Carry ID2：可透過讀卡機直接讀取取得的晶片卡號［隱碼］。
實務串接核心技巧
經多次與財稅平台及一卡通窗口詢問確認，目前實務操作上，Carry ID1 與 Carry ID2 都統一填入相同的值（即從讀卡機取得之晶片卡號隱碼）即可，完全不影響發票開立與合規性上傳。
二、e首發票 API 參數簡化傳遞規則
為了簡化開發者的串接流程，當您調用 e首發票 API 開立發票時，系統已完成底層格式優化。您不需要同時在程式中傳送 ID1 與 ID2，只需要傳入 CarryType 與 CarryID 兩個核心欄位（皆填入晶片隱碼值），e首發票系統將會自動協助產生財政部合規 XML 所需的 Carry ID1 與 Carry ID2。惟信用卡則可視特殊情境再額外傳入 CarryID2。
三、一卡通載具發票開立 JSON 請求範例
以下為開立一卡通載具發票時的標準 JSON 結構，請注意紅字標示之載具關鍵參數配置：
{
"CompanyID": "89430377",
"InvoiceID": "AA12345678",
"InvoiceDateTime": "2026-06-24T16:27:34",
"InvoiceFor": "C",
"BuyerID": "0000000000",
"BuyerName": "Nestor Huang",
"BuyerAddress": "高雄市鳳山區光遠路226號B1",
"BuyerTelNo": "0912345678",
"BuyerEmail": "nestor@systemlead.com",
"CarryType": "1H0001",
"CarryID": "T2032802",
"RelateNumber": "OD2017032802",
"PrintMark": "N",
"RandomNumber": "3716",
"SalesAmount": 5500,
"TaxType": "1",
"TaxAmount": 0,
"TotalAmount": 5500,
"Details": [
{
"DetailID": "001",
"ProductID": "P1234",
"ProductName": "產品名稱",
"Quantity": 5.0,
"UnitPrice": 100.0,
"SubTotal": 500.0
},
{
"DetailID": "002",
"ProductID": "P2345",
"ProductName": "長度256個字",
"Quantity": 2.0,
"UnitPrice": 500.0,
"SubTotal": 1000.0
},
{
"DetailID": "003",
"ProductID": "P3456",
"ProductName": "明細編號3碼",
"Quantity": 4.0,
"UnitPrice": 1000.0,
"SubTotal": 4000.0,
"Remark": "貨品缺1件候補"
}
]
}透過 e首發票高度封裝與智慧化的 API 架構，不論是悠遊卡、一卡通還是傳統會員載具，皆能以最簡潔的代码邏輯完成高難度的法規載具對接，保障營運數據與財政部端點的即時、精準連線。