發票查詢／查詢發票明細

應用場景

特店可使用此API查詢已開立發票資訊，綠界會以回傳參數方式回覆該張發票資料。此方式可協助營業人將查詢發票機制整合至營業人網站，提供買受人可於營業人網站快速查詢。
如有多筆大量查詢需求，建議使用查詢特定多筆發票。

API介接網址

測試環境：https://einvoice-stage.ecpay.com.tw/B2CInvoice/GetIssue
正式環境：https://einvoice.ecpay.com.tw/B2CInvoice/GetIssue

HTTPS傳輸協定

Content Type ：application/json
HTTP Method ：POST

特店傳入參數(Json格式)

PlatformID String(10)
特約合作平台商代號

這個參數是專為與綠界簽約的指定平台商所設計，只有在申請開通後才能使用。
如果您是一般廠商，請在介接時將此參數欄位保留為空。
對於平台商，在使用時需要在MerchantID(特店編號)欄位中填入與您已經完成綁定子廠商的MerchantID(特定編號)。
請注意，只能使用已綁定的子廠商編號，以避免操作失敗。綁定作業請洽所屬業務。

MerchantID String(10)
特店編號 必填

RqHeader Object
傳入資料 必填

Timestamp Number
傳入時間 必填

請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。

注意事項：

驗證時間區間暫訂為 10 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，參考資料：http://www.epochconverter.com/。
合作特店須進行主機「時間校正」，避免主機產生時差，導致API無法正常運作。

Data String
加密資料 必填

此為加密過JSON格式的資料。加密方法說明

特店傳入參數範例(Json格式)

				
					{
    "MerchantID": "2000132",
    "RqHeader": {
        "Timestamp": 1525168923
    },
    "Data": "加密資料"
}

情境一：以特店自訂編號[RelateNumber]做查詢

Data參數說明(Json格式) : 請先將Json字串進行urlencode後再進行AES加密

MerchantID String(10)
特店編號 必填

RelateNumber String(30)
特店自訂編號 必填

需為唯一值不可重複使用。

注意事項：

請勿使用特殊符號

Data參數範例(Json格式)

				
					{
   "MerchantID": 2000132,
   "RelateNumber": "20181028000000020"
}

情境二：以發票號碼[InvoiceNo]與發票開立日期[InvoiceDate]做查詢

Data參數說明(Json格式) : 請先將Json字串進行urlencode後再進行AES加密

MerchantID String(10)
特店編號 必填

InvoiceNo String(10)
發票號碼 必填

InvoiceDate String(10)
發票開立日期 必填

格式為「yyyy-MM-dd」or「yyyy/MM/dd」

Data參數範例(Json格式)

				
					{
   "MerchantID": "2000132",
   "InvoiceNo": "AA123456",
   "InvoiceDate": "2018-10-28"
}

綠界回傳參數格式

Content Type ：application/json
HTTP Method ：POST

綠界回傳參數(Json格式)

PlatformID String(10)
特約合作平台商代號

MerchantID String(10)
特店編號

RpHeader Object
回傳資料

Timestamp Number
回傳時間

Unix timestamp(GMT+8)

TransCode Int
回傳代碼

1 代表 API 傳輸資料(MerchantID, RqHeader, Data)接收成功，實際的 API 執行結果狀態請參考 RtnCode。

TransMsg String(200)
回傳訊息

Data String
加密資料

回傳相關資料，此為加密過JSON格式的資料。加密方法說明

綠界回傳參數範例

				
					{
    "MerchantID": "2000132",
    "RpHeader": {
        "Timestamp": 1525169058
    },
    "TransCode": 1,
    "TransMsg": "",
    "Data": "加密資料"
}

Data參數說明(Json格式) : 請先將Data進行AES解密後再做urldecode

RtnCode Int
回應代碼

1 代表 API 執行成功，其餘代碼均為失敗。

RtnMsg String(200)
回應訊息

IIS_Mer_ID String(10)
特店編號

ChannelPartner String(1)
通路商編號

1:蝦皮

IIS_Number String(10)
發票號碼

IIS_Relate_Number String(30)
特店自訂編號

IIS_Customer_ID String(20)
客戶編號

IIS_Identifier String(10)
買方統編

0000000000代表沒有統編

IIS_Customer_Name String(60)
客戶名稱

IIS_Customer_Addr String(100)
客戶地址

IIS_Customer_Phone String(20)
客戶電話

IIS_Customer_Email String(80)
客戶電子信箱

IIS_Clearance_Mark String(1)
通關方式

注意事項：

只有零稅率才會回傳以下資料
1：非經海關出口
2：經海關出口

IIS_Type String(2)
發票種類

07：一般稅額計算
08：特種稅額

IIS_Category String(10)
發票類別

B2B：表示開立發票時有含統編
B2C：表示開立發票時沒有含統編

IIS_Tax_Type String(1)
課稅別

1：應稅
2：零稅率
3：免稅
4：應稅(特種稅率)
9：若為混合應稅與免稅或零稅率

SpecialTaxType Int
特種稅額類別

當課稅類別[TaxType]為1/2/9時，系統將會自動帶入數字【0】
當課稅類別[TaxType]為3時，則該參數必填，請填入數字【8】
當課稅類別[TaxType]為4時，則該參數必填，可填入數字【1-8】，
數字【1-8】並分別代表以下類別與稅率
1：
代表酒家及有陪侍服務之茶室、咖啡廳、酒吧之營業稅稅率，稅率為25%
2：
代表夜總會、有娛樂節目之餐飲店之營業稅稅率，稅率為15%
3：
代表銀行業、保險業、信託投資業、證券業、期貨業、票券業及典當業之專屬本業收入(不含銀行業、保險業經營銀行、保險本業收入)之營業稅稅率，稅率為2%
4：
代表保險業之再保費收入之營業稅稅率，稅率為1%
5：
代表銀行業、保險業、信託投資業、證券業、期貨業、票券業及典當業之非專屬本業收入之營業稅稅率，稅率為5%
6：
代表銀行業、保險業經營銀行、保險本業收入之營業稅稅率(適用於民國103年07月以後銷售額) ，稅率為5%
7：
代表銀行業、保險業經營銀行、保險本業收入之營業稅稅率(適用於民國103年06月以前銷售額) ，稅率為5%
8：
代表空白為免稅或非銷項特種稅額之資料

IIS_Tax_Rate Number
稅率

小數點2位

IIS_Tax_Amount Number
稅金

當發票有統編時，才會回傳稅金
當發票沒有統編時，稅金包含在發票金額內，不拆算稅金，故回傳值為0
支援整數11位

IIS_Sales_Amount Number
發票金額

支援整數12位

IIS_Check_Number String(4)
發票檢查碼

注意事項：此參數已停用，請忽略此參數的回傳值

IIS_Carrier_Type String(1)
載具類別

無載具：為空值
1：為綠界電子發票載具
2：為消費者自然人憑證
3：為消費者手機條碼

IIS_Carrier_Num String(64)
載具編號

若無載具為空值
綠界電子發票載具時，為客戶電子信箱或客戶手機號碼擇一(以客戶電子信箱優先)，請注意，綠界會重新編碼後產出綠界載具編號。
消費者使用載具為自然人憑證，格式應為2碼大寫英文字母加上14碼數字(長度共16碼)
消費者使用載具為手機條碼時，目前總長度共為8碼，格式應為第1碼「/」加上由7碼數字及大寫英文字母及+-符號所組成。

IIS_Love_Code String(7)
捐款單位捐贈碼

財政部 – 查詢受捐贈機關或團體捐贈碼
https://www.einvoice.nat.gov.tw/APMEMBERVAN/XcaOrgPreserveCodeQuery/XcaOrgPreserveCodeQuery

IIS_IP String(20)
發票開立IP

IIS_Create_Date String(20)
發票開立時間

格式為「yyyy-MM-dd HH:mm:ss」

IIS_Issue_Status String(1)
發票開立狀態

1：發票開立
0：發票註銷

IIS_Invalid_Status String(1)
發票作廢狀態

1：已作廢時
0：未作廢

IIS_Upload_Status String(1)
發票上傳狀態

1：已上傳
0：未上傳

IIS_Upload_Date String(20)
發票上傳時間

格式為「yyyy-MM-dd HH:mm:ss」

IIS_Turnkey_Status String(1)
發票上傳後接收狀態

C：成功
E：失敗
G：處理中(待財政部回覆狀態)
P：處理中(上傳財政部中)

IIS_Remain_Allowance_Amt Number
折讓剩餘金額

支援整數12位

IIS_Print_Flag String(1)
列印旗標

1：列印
0：不列印

IIS_Award_Flag String(1)
中獎旗標

空值：未對獎、不可對獎（如：捐贈之發票）
0：未中獎
1：已中獎
X：有統編之發票

IIS_Award_Type String(2)
中獎種類

12：雲端發票獎800元
11：雲端發票獎500元
10：雲端發票獎100萬元
9：雲端發票獎2000元
8：特別獎一千萬　
7：特獎二百萬元
1：頭獎二十萬元
2：二獎四萬元
3：三獎一萬元
4：四獎四千元
5：五獎一千元
6：六獎二百元
0：未中獎

Items Array[Object]
商品

ItemSeq Int
商品序號

ItemName String(100)
商品名稱

ItemCount Number
商品數量

支援整數8位，小數2位

ItemWord String(6)
商品單位

ItemPrice Number
商品單價

此為含稅單價金額
支援整數10位，小數7位

ItemTaxType String(1)
商品課稅別

1：應稅
2：零稅率
3：免稅

注意事項：

預設為空字串，當課稅類別[TaxType] = 9時，此欄位不可為空。
課稅類別為混合稅率時，需含二筆或以上的商品課稅別[ItemTaxType]，且至少需有一筆商品課稅別為應稅及至少需有一筆商品課稅別為免稅或零稅率，即混稅發票只能
1.應稅+免稅
2.應稅+零稅率，
免稅和零稅率發票不能同時開立。

ItemAmount Number
商品合計

此為含稅小計金額
支援整數12位，小數7位

ItemRemark String(40)
商品備註說明

若未帶此參數或此參數無值時，預設為空白

IIS_Random_Number String(4)
隨機碼

四碼的隨機數字 (2014-01-01起)

InvoiceRemark String(200)
發票備註

PosBarCode String(Max)
顯示電子發票BARCODE用

用於顯示電子發票BARCODE用。(此回傳參數僅供POS廠商專用)。
POS廠商要自行開發發票版型，請與綠界提出申請方可使用。

QRCode_Left String(Max)
顯示電子發票BARCODE左邊用

用於顯示電子發票QRCODE左邊用的，必須先在綠界設定密碼種子才會協助壓碼回傳。(此回傳參數僅供POS廠商專用)。
若POS廠商要自行開發發票版型，請與綠界提出申請方可使用。

QRCode_Right String(Max)
顯示電子發票BARCODE右邊用

用於顯示電子發票QRCODE右邊用的，必須先在綠界設定密碼種子才會協助壓碼回傳。(此回傳參數僅供POS廠商專用)。
若POS廠商要自行開發發票版型，請與綠界提出申請方可使用。

注意事項：

為避免QR Code過於複雜無法辨識，QR Code僅顯示前2個商品品項，完整商品品項請以上傳財政部內容為主

Data參數範例

				
					{
    "IIS_Mer_ID": "2000132",
    "ChannelPartner": "",
    "IIS_Number": "UV11100012",
    "IIS_Relate_Number": "20181028000000020",
    "IIS_Customer_ID": "",
    "IIS_Identifier": "0000000000",
    "IIS_Customer_Name": "綠界科技股份有限公司",
    "IIS_Customer_Addr": "106台北市南港區發票街1號1樓",
    "IIS_Customer_Phone": "",
    "IIS_Customer_Email": "test@ecpay.com.tw",
    "IIS_Clearance_Mark": "",
    "IIS_Type": "07",
    "IIS_Category": "B2C",
    "IIS_Tax_Type": "1",
    "IIS_Tax_Rate":0.050,
    "IIS_Tax_Amount": 0,
    "IIS_Sales_Amount": 100,
    "IIS_Check_Number": "P",
    "IIS_Carrier_Type": "",
    "IIS_Carrier_Num": "",
    "IIS_Love_Code": "0",
    "IIS_IP": "0",
    "IIS_Create_Date": "2019-09-17 17:17:31",
    "IIS_Issue_Status": "1",
    "IIS_Invalid_Status": "0",
    "IIS_Upload_Status": "0",
    "IIS_Upload_Date": "",
    "IIS_Turnkey_Status": "",
    "IIS_Remain_Allowance_Amt": 0,
    "IIS_Print_Flag": "1",
    "IIS_Award_Flag": "",
    "IIS_Award_Type": "",
    "IIS_Random_Number": "6866",
    "IIS_Comment": "發票備註",
    "QRCode_Left": "UV111000121080917686600000000000000640000000011456006Sxys2hDhHuVVGnbc7XhCOg==:**********:2:3:1:item01:1:50:",
    "QRCode_Right": "**item02:1:20",
    "PosBarCode": "10810UV111000126866",
    "Items": [
        {
            "ItemSeq": 1,
            "ItemName": "item01",
            "ItemCount": 1,
            "ItemWord": "件",
            "ItemPrice": 50,
            "ItemTaxType": "1",
            "ItemAmount": 50,
            "ItemRemark": "item01_desc"
        },
        {
            "ItemSeq": 2,
            "ItemName": "item02",
            "ItemCount": 1,
            "ItemWord": "個",
            "ItemPrice": 20,
            "ItemTaxType": "1",
            "ItemAmount": 20,
            "ItemRemark": "item02_desc"
        },
        {
            "ItemSeq": 3,
            "ItemName": "item03",
            "ItemCount": 3,
            "ItemWord": "粒",
            "ItemPrice": 10,
            "ItemTaxType": "1",
            "ItemAmount": 30,
            "ItemRemark": "item03_desc"
        }
    ],
    "RtnCode": 1,
    "RtnMsg": "查詢成功"
}

電子發票QRCODE示意圖說明

綠界官方網站