應用場景
注意事項：
- 電子發票號碼為 50 個一組
若您並非將所有配得的字軌號碼都新增到綠界科技系統，請務必特別留意，電子發票號碼為 50 個一組，
分配時請以 50 個號碼為一個單位，且起始號碼尾數一定為 00 或 50，結尾號碼尾數一定為 49 或 99。
範例：
甲公司本次配得共 1000 個號碼(AB10000050~AB10001049)，要分配給 A、B 兩間發票加值中心，因為在 B
加值中心開立的發票不多，故甲公司只想設定最低數量在 B 加值中心，其餘都分給 A 加值中心。
甲公司可分配如下：
A 加值中心：950 號 (AB10000050~AB10000999)
B 加值中心：50 號 (AB10001000~AB10001049)
※ 因一組為 50 號，B 加值中心至少必須設定 50 個號碼。 - 請勿於多個發票系統設定相同字軌號碼
若您同時有使用其他 POS 系統、加值中心或發票平台服務，請特別注意不可於多個發票系統設定到相同區間的字軌！以免發票號碼重覆開立。 - 若有授權綠界取得字軌配號申請結果時，可設定的發票字軌配號可透過查詢財政部配號結果查詢，已設定過的字軌配號結果，可透過呼叫查詢字軌API查詢。
API介接網址
- 測試環境：https://einvoice-stage.ecpay.com.tw/B2CInvoice/AddInvoiceWordSetting
- 正式環境：https://einvoice.ecpay.com.tw/B2CInvoice/AddInvoiceWordSetting
HTTPS 傳輸協定
- Content Type ：application/json
- HTTP Method ：POST
特店傳入參數(Json格式)
PlatformID String(10)
特約合作平台商代號
- PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
- 若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。
RqHeader Object
傳入資料 必填
Timestamp String(10)
傳入時間
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 10 分鐘內有效，若超過此驗證時間則此次API request將無法建立，參考資料：http://www.epochconverter.com/。
- 特店需進行主機「時間校正」，避免主機產生時差，造成API request失敗。
Data String
加密資料 必填
特店傳入參數範例(Json格式)
{
"MerchantID": "2000132",
"RqHeader": {
"Timestamp": "1525168923",
"Revision": "1.0.0"
},
"Data": "加密資料"
}
Data參數說明(Json格式)
MerchantID String(10)
特店編號 必填
InvoiceTerm Int
發票期別 必填
注意事項：不可帶入小於當年的期別 InvoiceYear String(3)
發票年度 必填
InvType String(2)
字軌類別 必填
InvoiceCategory String(1)
發票種類 必填
InvoiceHeader String(2)
發票字軌 必填
InvoiceStart String(8)
起始發票編號 必填
InvoiceEnd String(8)
結束發票編號 必填
MachineID String(10)
發票機台ID 必填
Data參數範例(Json格式)
{
"MerchantID": "2000132",
"InvoiceTerm": "1",
"InvoiceYear": "109",
"InvType": "07",
"InvoiceCategory": "4",
"InvoiceHeader": "TW",
"InvoiceStart": "10000000",
"InvoiceEnd": "10000049"
"MachineID": "A123345",
}
綠界回傳參數(Json格式)
PlatformID String(10)
特約合作平台商代號
MerchantID String(10)
特店編號
RpHeader Object
傳入資料
Timestamp String(10)
傳入時間
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
TransCode Int
回傳代碼
1 代表 API 傳輸資料(MerchantID, RqHeader, Data)接收成功，實際的 API 執行結果狀態請參考 RtnCode。
TransMsg String(200)
回傳訊息
Data String
加密資料
綠界回傳參數範例
{
"MerchantID": "2000132",
"RpHeader": {
"Timestamp": "1525169058"
},
"TransCode": 1,
"TransMsg": "",
"Data": "加密資料"
}
Data參數(Json格式)
RtnCode Int
回應代碼
1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。
RtnMsg String(200)
回應訊息
TrackID String(10)
字軌號碼ID
注意事項：新增字軌後，字軌狀態預設為已審核通過且會自動啟用一組字軌。
回傳Data參數範例
{
"RtnCode": 1,
"RtnMsg": "成功",
"TrackID": "1234567890"
}