版本異動 異動序號文件版本號修改內容日期 1 P2G_INVI_1.0.0 初版 2014/10/08 2 P2G_INVI_1.0.1 新增第四章節銷售額與稅額參數 2015/01/07 3 P2G_INVI_1.0.2 修改第四章節載具類別 載具編號參數 2015/04/02 4 P2G_INV

Transcription

1 智付寶股份有限公司 電子發票 技術串接手冊 適用範圍 : 開立 作廢 折讓 查詢發票 標準版 文件版本號 :P2G_INVI_1.1.8 ( 文件為智付寶股份有限公司版權所有 ) 電子發票加值服務平台 輕鬆開立. 批量申報. 省時環保. 成本低廉

2 版本異動 異動序號文件版本號修改內容日期 1 P2G_INVI_1.0.0 初版 2014/10/08 2 P2G_INVI_1.0.1 新增第四章節銷售額與稅額參數 2015/01/07 3 P2G_INVI_1.0.2 修改第四章節載具類別 載具編號參數 2015/04/02 4 P2G_INVI_1.0.3 修改附件一範例程式 2015/04/22 5 P2G_INVI_ 修改第四章節買受人名稱參數 2015/05/08 2. 刪除第四章 Notify 參數 6 P2G_INVI_ 新增第一 二章節作廢發票 查詢發票說明 2015/07/24 2. 新增第三章節其他說明 3. 新增第八 九章節作廢發票串接參數 4. 新增第十 十一章節查詢發票串接參數 7 P2G_INVI_1.0.6 新增第四章節混合應稅與免稅或零稅率相關參數 2015/09/01 8 P2G_INVI_ 章節順序調整 2015/10/16 2. 新增第六章節折讓作業串接參數 9 P2G_INVI_ 新增開立發票的條碼與 QRCode 回傳參數資料 2015/11/06 2. 第四章第 ( 二 ) 項回傳 String 格式結尾新增參數 3. 校正 CarrierType 與 CarrierNum 參數名稱 4. 修改附件一參考範例參數 5. 買受人信箱修改為非必填選項 6. 第七章第 ( 二 ) 參數修正 10 P2G_INVI_1.0.9 第七章第一項, 新增查詢方式 訂單編號 發票金 2015/11/26 額參數 11 P2G_INVI_ 修改電子發票測試串接網址 2015/12/02 2. 第四章節新增其它載具代碼說明 12 P2G_INVI_1.1.1 修改電子發票作廢 折讓 查詢, 測試串接網址 2015/12/09 13 P2G_INVI_1.1.2 新增開立零稅率發票需帶 報關標記 參數 2015/12/23 14 P2G_INVI_1.1.3 第四章第 ( 一 ) 項第 3 點,[Comment] 參數新增說 2016/01/30 明 15 P2G_INVI_ 第八章新增 [INV90005] [INV90006] 錯誤 2016/05/25 代碼 2. 附件一新增 [.net c# 版本程式語言編寫 AES 加密語法參考 ] 16 P2G_INVI_1.1.5 第四章節第 ( 一 ) 第 3 點, 修改 [Comment] 參數及說明 2016/06/13 電子發票加值服務平台 1 輕鬆開立. 批量申報. 省時環保. 成本低廉

3 17 P2G_INVI_ 第四章節第 ( 一 ) 第 3 點,[Version] [ 2016/11/21 Comment] [ TaxType] [ TaxRate] [ CustomsClearance] [AmtSales] [ AmtZero] [AmtFree] [ItemTaxType] 校 正參數中文名稱及修改說明 2. 第六章節第 ( 一 ) 第 3 點,[Version] [ ItemPrice] [ItemAmt] 修改參數及說明, 新增 [TaxTypeForMixed] 參數 3. 第七章節第 ( 二 ) 第 3 點,[TaxType] [ AmtSales] [AmtZero] [AmtFree] 校正 參數中文名稱及修改說明 4. 第八章新增 [INV10017] 錯誤代碼,[ INV10012] [LIB10003] 變更說明 18 P2G_INVI_1.1.7 第四章節第 ( 一 ) 第 3 點,[Buyer ] [ 2017/02/13 LoveCode] [TaxType] 修改參數及說明 19 P2G_INVI_ 第四章節第 ( 一 ) 第 2 點 第 ( 三 ) 第 3 點, 第五章 2017/10/18 節第 ( 一 ) 第 2 點, 第六章節第 ( 一 ) 第 2 點 第 ( 三 ) 第 3 點, 第七章節第 ( 一 ) 第 2 點,[ MerchantID_] 修改說明 2. 第四章節第 ( 二 ) 第 3 4 點 第 ( 四 ) 第 3 4 點, 第五章節第 ( 二 ) 第 3 4 點, 第六章節第 ( 二 ) 第 3 4 點 第 ( 四 ) 第 3 4 點, 第七章節 第 ( 二 ) 第 3 4 點,[MerchantID] 修改說明 3. 第四章節第 ( 一 ) 第 3 點,[CarrierNum] [ LoveCode] 修改參數及說明 4. 第六章節第 ( 一 ) 第 3 點,[ItemPrice] [ ItemTaxAmt] 修改參數及說明 5. 附件一修改 PHP 版本程式語言範例 電子發票加值服務平台 2 輕鬆開立. 批量申報. 省時環保. 成本低廉

4 目錄 一 串接目的... 5 二 發票流程說明... 7 三 串接環境與作業流程 四 開立發票 ( 一 ) 開立發票參數設定 ( 二 ) 開立發票系統回應訊息 ( 三 ) 觸發開立發票參數設定 ( 四 ) 觸發開立發票系統回應訊息 五 作廢發票 ( 一 ) 作廢發票參數設定 ( 二 ) 作廢發票系統回應訊息 六 折讓作業 ( 一 ) 開立折讓參數設定 ( 二 ) 開立折讓系統回應訊息 ( 三 ) 觸發確認折讓或取消折讓參數設定 ( 四 ) 觸發確認折讓或取消折讓系統回應訊息 七 查詢發票 ( 一 ) 查詢發票參數設定 電子發票加值服務平台 3 輕鬆開立. 批量申報. 省時環保. 成本低廉

5 ( 二 ) 查詢發票系統回應訊息 八 錯誤代碼 附件一 PostData_ 加密方法範例程式 附件二 CheckCode 產生規則範例程式 電子發票加值服務平台 4 輕鬆開立. 批量申報. 省時環保. 成本低廉

6 一 串接目的 提供 Pay2go 電子發票加值服務平台 以下簡稱本平台 會員透過程式串接方式, 進行開立 作廢 折讓電子發票及提供發票查詢機制 ( 一 ) 開立發票 1. 開立發票支援以下 3 種方式 : (1) 即時開立發票 : 傳送開立發票參數後, 立即開立電子發票 (2) 等待觸發開立發票 : 傳送開立發票參數後, 由本平台暫存發票資料, 待確 認要開立時, 再觸發本平台進行開立 (3) 預約自動開立發票 : 傳送開立發票參數時, 可設定預計開立日期, 本平台 會於預計開立日期進行開立 ( 二 ) 作廢發票於奇數月 14 日前, 可執行作廢前兩個月開立之發票 ( 例 :7/14 前, 可作廢 5/1-6/30 開立之發票 ) ( 三 ) 折讓作業於開立折讓時, 可選擇確認折讓方式 : 1. 開立折讓後, 不立即確認折讓 (1) 當開立折讓後, 開立的折讓資料, 僅記錄於本平台, 未上傳至財政部電子 發票整合服務平台, 營業人可於與買受人確認後再執行確認折讓, 此時本 平台才會於確認後隔日, 將折讓資料上傳至財政部電子發票整合服務平 台 電子發票加值服務平台 5 輕鬆開立. 批量申報. 省時環保. 成本低廉

7 (2) 當開立折讓後, 若因故需取消折讓, 營業人可執行取消折讓, 此時本平台 將該折讓狀態變更為取消 2. 開立折讓後, 立即確認折讓於開立折讓後, 本平台主動於隔日將折讓資料上傳至財政部電子發票整合服務平台 ( 四 ) 發票查詢電子發票開立後, 可透過查詢發票參數, 查詢單筆發票資料, 查詢結果呈現方式包含 以下兩種 : 1. 以回傳參數方式回覆該張發票資料 此方式可協助營業人將查詢發票機制, 整 合至營業人網站, 提供買受人可於營業人網站快速查詢 2. 於本平台網頁顯示發票查詢結果 電子發票加值服務平台 6 輕鬆開立. 批量申報. 省時環保. 成本低廉

8 二 發票流程說明 ( 一 ) 即時開立發票流程 營業人 (B) 1. 傳送發票開立參數 ( 請參考四 -( 一 ) 開立發票參數設定 ) 5. 登入本平台進行查詢及 其他功能執行 2. 回覆發票開立結果 ( 請參考四 -( 二 ) 開立發票系統回應訊息 ) Pay2go 電子發票加值服務平台 4. 平台發送開立發票通知 或由營業人自行通知發票資訊 3. 上傳發票資訊 買受人 (B 或 C) 財政部電子發票平台 電子發票加值服務平台 7 輕鬆開立. 批量申報. 省時環保. 成本低廉

9 ( 二 ) 等待觸發開立發票流程 當發票開立方式為等待觸發開立發票時, 發票資料僅暫存於本平台, 若確認要開立, 則 需再執行 觸發開立發票, 觸發後會立即開出發票 營業人 (B) 1. 傳送發票開立參數 ( 請參考四 -( 一 ) 開立發票參數設定 ) 3. 等待觸發開立發票確認要開立時, 執行觸發開立發票 ( 請參考四 -( 三 ) 觸發開立發票參數設定 ) 7. 登入本平台進行查詢及 其他功能執行 2. 本平台暫存發票資料並回覆訊息 ( 請參考四 -( 二 ) 開立發票系統回應訊息 ) 4. 回覆觸發開立發票結果 ( 請參考四 -( 四 ) 觸發開立發票 系統回應訊息 ) Pay2go 電子發票加值服務平台 6. 平台發送發票通知 或由營業人自行通知發票資訊 5. 上傳發票資訊 買受人 (B 或 C) 財政部電子發票平台 電子發票加值服務平台 8 輕鬆開立. 批量申報. 省時環保. 成本低廉

10 ( 三 ) 預約自動開立發票流程 1. 當發票開立方式為預約自動開立發票時, 發票資料僅暫存於本平台, 系統於設預計開立日期自動執行開立發票 2. 於預計開立日期前若想提前開立, 則可執行 觸發開立發票, 觸發後會立即開出發票 營業人 (B) 1. 傳送發票開立參數 ( 請參考四 -( 一 ) 開立發 票參數設定 ) 3. 預約自動開立發票如要提前開立時, 執行觸發開立發票 ( 請參考四 -( 三 ) 觸發開立發 7. 登入本平台進行查詢及 其他功能執行 票參數設定 ) 2. 本平台暫存發票資料, 設定於預計開立日期執行開立發票 4. 回覆觸發開立發票結果並回覆訊息 ( 請參考四 -( 四 ) 觸發開立發票 ( 請參考四 -( 二 ) 開立發票系系統回應訊息 ) 統回應訊息 ) Pay2go 電子發票加值服務平台 6. 平台發送發票通知 5. 上傳發票資訊 或由營業人自行通知發票資訊 買受人 (B 或 C) 財政部電子發票平台 註 : 預約自動開立發票如不需要提前開立時, 可略過步驟 3 4 電子發票加值服務平台 9 輕鬆開立. 批量申報. 省時環保. 成本低廉

11 ( 四 ) 作廢發票流程 營業人 (B) 1. 傳送作廢發票參數 ( 請參考五 -( 一 ) 作廢發票參數設定 ) 5. 登入本平台進行查詢及 其他功能執行 2. 回覆作廢發票結果 ( 請參考五 -( 二 ) 作廢發票系統回應訊息 ) Pay2go 電子發票加值服務平台 3. 平台發送作廢發票通知 或由營業人自行通知作廢發票資訊 4. 上傳發票資訊 買受人 (B 或 C) 財政部電子發票平台 電子發票加值服務平台 10 輕鬆開立. 批量申報. 省時環保. 成本低廉

12 ( 五 ) 開立折讓流程 - 不立即確認折讓 營業人 (B) 1. 傳送開立折讓參數 4. 觸發確認或取消折讓 7. 登入本平台進行查詢及 ( 請參考六 -( 一 ) 開立折讓 ( 請參考六 -( 三 ) 觸發確 其他功能執行 參數設定 ) 認折讓或取消折讓參數設 定 ) 5. 回覆觸發確認或取消 2. 回覆開立折讓結果 折讓結果 ( 請參考六 -( 二 ) 開立折讓系統 ( 請參考六 -( 四 ) 觸發 回應訊息 ) 確認折讓或取消折讓系 統回應訊息 ) Pay2go 電子發票加值服務平台 3. 平台發送折讓單通知 或由營業人自行通知折讓單資訊 6. 上傳折讓單資訊 買受人 (B 或 C) 財政部電子發票平台 註 : 若於步驟 4 為觸發取消折讓時, 則可略過步驟 6 電子發票加值服務平台 11 輕鬆開立. 批量申報. 省時環保. 成本低廉

13 ( 六 ) 開立折讓流程 - 立即確認折讓 營業人 (B) 1. 傳送開立折讓參數 ( 請參考六 -( 一 ) 開立折讓 參數設定 ) 2. 回覆開立折讓結果 ( 請參考六 -( 二 ) 開立折讓系統 回應訊息 ) 5. 登入本平台進行查詢及 其他功能執行 Pay2go 電子發票加值服務平台 3. 平台發送折讓單通知 或由營業人自行通知折讓單資訊 4. 上傳折讓單資訊 買受人 (B 或 C) 財政部電子發票平台 電子發票加值服務平台 12 輕鬆開立. 批量申報. 省時環保. 成本低廉

14 ( 七 ) 查詢發票流程 營業人 (B) 1. 傳送查詢發票參數 ( 請參考七 -( 一 ) 查詢發票參數設定 ) 2-1. 若傳送查詢發票參數時, 無 DisplayFlag 參數, 則以參數回傳發票查詢結果 ( 請參考七 -( 二 ) 查詢發票系統回應訊息) Pay2go 電子發票加值服務平台 2-2. 若傳送查詢發票參數時, DisplayFlag 參數為 1, 則於本平台網頁顯示發票查詢結果 買受人 (B 或 C) 電子發票加值服務平台 13 輕鬆開立. 批量申報. 省時環保. 成本低廉

15 三 串接環境與作業流程 ( 一 ) 測試環境 : 1. 申請測試環境會員並開立商店 : (1) 於 Pay2go 電子發票測試平台 申請會員並建立測試商店 (2) 取得測試商店 API 串接金鑰 Hash Key 及 Hash IV 2. 本平台審核會員資料並設定啟用電子發票測試平台 3. 於電子發票測試平台 登入測試環境會員, 進入電子發票測試平台 4. 於電子發票測試平台中點選 管理設定 / 發票字軌號碼設定, 新增測試發票字軌號碼, 即可開始進行串接測試 5. 您的測試發票資料可登入 Pay2go 電子發票測試平台, 點選 銷項發票作業 / 銷項發票查詢 進行查看 ( 二 ) 正式環境 : 1. 申請正式環境會員並開立商店 : (1) 於 Pay2go 電子發票加值服務平台 申請會員並建立商店 (2) 取得商店 API 串接金鑰 Hash Key 及 Hash IV 2. 待本平台審核會員資料並設定啟用電子發票加值服務平台 3. 於 Pay2go 電子發票加值服務平台 登入正式環境會員, 進入電子發票加值服務平台 4. 於電子發票加值服務平台中點選 管理設定 / 發票字軌號碼設定, 新增電子發票專用字軌號碼, 即可開始進行開立使用 電子發票加值服務平台 14 輕鬆開立. 批量申報. 省時環保. 成本低廉

16 5. 您的發票資料可登入 Pay2go 電子發票加值服務平台, 點選 銷項發票作業 / 銷 項發票查詢 進行查看 ( 三 ) 資料交換方式 1. 商店以 HTTP POST 方式傳送發票資料至本平台進行開立 2. 傳送方式須以標準 Form Post 進行 3. 本平台以 Web Service 方式回應 4. 編碼格式為 UTF-8 ( 四 ) 其他說明 1. 依財政部規定, 當欲開立 B2C 發票時, 營業人需自行於購物網站或以其他方 式, 提供可讓買受人選擇儲存電子發票的載具選項 ( 手機條碼載具 自然人憑 證條碼載具 會員載具 ), 或使用愛心碼捐贈發票, 或索取紙本電子發票證明 聯 範例 : 以購物網站為例, 可於網站購物車頁面或會員資料頁面, 提供以下 發票資料設定項目供買受人選擇 ( 下圖為參考範例, 營業人可自行設計 ) 電子發票加值服務平台 15 輕鬆開立. 批量申報. 省時環保. 成本低廉

17 2. 開立 B2C 電子發票時, 營業人如欲提供會員載具, 可事先向財政部申請發行 電子發票會員載具 或可直接使用智付寶會員載具, 智付寶會員載具不需事先 申請, 由營業人於載具編號參數提供可識別買受人之代號 ( 例 : 手機號 碼 會員編號 等 ), 同一營業人統編提供的相同買受人代號, 將被視為同一個 買受人, 本平台將以營業人統編加上買受人代號做為該買受人的智付寶載具編 號 ( 詳細請參考第四章節載具編號參數 ) 3. 愛心碼查詢網址 : 如需捐贈發票, 可利用財政部電子發票整合服務平台查詢受贈單位之愛心碼 OrgPreserveCodeQuery?CSRT= 發票計算方式檢核說明 : (1) 本平台系統僅檢核 商品小計 = 商品數量 X 商品單價 及 發票金額 = 銷售額 + 稅額 (2) 發票計算方式, 請串接人員務必與公司財會人員進行確認, 發票資料關係到公司稅務, 請謹慎處理 5. 發票資料上傳財政部電子發票整合服務平台流程說明 : (1) Pay2go 電子發票加值服務平台於每日 01:00 起, 上傳前日 00:00 至 23:59 間的開立 作廢 折讓發票資料 (2) 每日 06:00 起, 依財政部電子發票整合服務平台回覆之上傳結果, 更新開立 作廢 折讓發票資料於 Pay2go 電子發票加值服務平台的上傳狀態 電子發票加值服務平台 16 輕鬆開立. 批量申報. 省時環保. 成本低廉

18 四 開立發票 ( 一 ) 開立發票參數設定 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. Post 參數說明 : 參數名稱參數中文名稱必填型態備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 3. PostData_ 內含欄位 : 參數名稱參數中文名稱必填型態備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.4 TimeStamp 時間戳記 V Varchar(30) 智付寶平台 TransNum 交易序號 Varchar(20) MerchantOrderNo 自訂編號 V Varchar(20) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 商店如有同時使用智付寶金流服務者, 於此參數傳送智付寶交易序號, 可作為對應該筆金流交易進行發票開立 2. 未使用智付寶金流服務者, 則不須輸入此參數 1. 商店自訂訂單編號, 限英 數字 _ 格式 例 : 電子發票加值服務平台 17 輕鬆開立. 批量申報. 省時環保. 成本低廉

19 Status 開立發票方式 V Varchar(1) CreateStatusTime 預計開立日期 Date Category 發票種類 V Varchar(5) 電子發票技術串接手冊 2. 可用於與營業人內部系統對應使用, 可填入訂單編號 帳務編號等等, 同一商店中此編號不可重覆 1= 即時開立發票 0= 等待觸發開立發票 ( 須於確認要開立時, 再發動觸發, 觸發請參考 四 - ( 三 ) 觸發開立發票參數設定 ) 3= 預約自動開立發票 ( 須指定預計開立日期 ) 1. 當開立發票方式為預約自動開立發票時 (Status=3), 才需要帶此參數 2. 格式為 YYYY-MM-DD 例 : B2B= 買受人為營業人 ( 有統編 ) B2C= 買受人為個人 BuyerName 買受人名稱 V Varchar(50) 買受人名稱, 個人姓名或營業人名稱 BuyerUBN 買受人統一編號 Varchar(8) 1. 買受人統一編號, 純數字 2. 買受人為個人時, 則不須填寫 BuyerAddress 買受人地址 Varchar(100) 買受人的聯絡地址 Buyer 買受人電子信箱 Varchar(50) CarrierType 載具類別 Varchar(2) CarrierNum 載具編號 Varchar(50) 1. 買受人的電子信箱 當發票開立時, 寄送發票相關查詢資訊 2. 當 CarrierType=2 時, 為智付寶載具, 則此參數為必填 1. 當 Category=B2C 時, 才適用此參數 2. 若買受人選擇將發票儲存至載具, 則填入載具類別 0= 手機條碼載具 1= 自然人憑證條碼載具 2= 智付寶載具 3. 若買受人無提供載具, 則此參數為空值 4. 當此參數有提供數值時,LoveCode 參數必為空值 5. 若是其它載具, 則直接輸入載具代碼 1. 若 CarrierType 參數有提供數值時, 則此參數為必填 2. 當 CarrierType 為手機條碼載具 自然人憑證條碼載具時, 此參數請提供買受人之載具號碼 電子發票加值服務平台 18 輕鬆開立. 批量申報. 省時環保. 成本低廉

20 LoveCode 愛心碼 Int(7) PrintFlag 索取紙本發票 V Varchar(1) TaxType 課稅別 V Varchar(2) TaxRate 稅率 V Float(6,4) 電子發票技術串接手冊 手機條碼載具檢核 : 第 1 碼為 / +7 碼英 數字, 除第 1 碼外, 只有 ABCDEFGHIJKLMNOPQRSTUVWXYZ + -. 這 39 個字元, 限大寫英字 自然人憑證條碼檢核 :2 碼大寫英字 +14 碼數字 3. 當 CarrierType 為智付寶載具時, 此參數請提供可識別買受人之代號 ( 例 : 手機號碼 會員編號 等 ), 由賣方自訂即可, 同一個代號則視為同一個買受人 本平台將以賣方統編加上買受人代號做為該買受人的智付寶載具號碼 4. 請用 rawurlencode() 將該參數值做 encode 處理, 確認資料內容不會被濾掉 5. 若此參數有提供數值時, 數值前後不得含空白 1. 限 3~7 碼純數字 2. 當 Category=B2C 時, 才適用此參數 3. 買受人選擇捐贈, 則於此參數填入受贈單位之愛心碼 買受人選擇不捐贈則此參數為空值 4. 若此參數有提供數值時, 則 CarrierType 參數必為空值 Y= 索取 ( 營業人可於本平台列印此發票 ) N= 不索取 1. 當 Category=B2B 時, 則此參數必填 Y 2. 當 Category=B2C 時, 若 CarrierType LoveCode 參數皆為空值, 則此參數必填 Y 1= 應稅 2= 零稅率 3= 免稅 9= 混合應稅與免稅或零稅率 ( 限收銀機發票無法分辨時使用 ) 1. 課稅別為應稅時, 一般稅率請帶 5, 特種稅率請帶入規定的課稅稅率 ( 不含 %, 例稅率 18% 則帶入 18) 2. 課稅別為零稅率 免稅時, 稅率請帶入 0 電子發票加值服務平台 19 輕鬆開立. 批量申報. 省時環保. 成本低廉

21 CustomsClearance 報關標記 Varchar(1) Amt 銷售額合計 V Int(10) 銷售額 AmtSales ( 課稅別應稅 ) Int(10) 銷售額 AmtZero ( 課稅別零稅率 ) Int(10) 銷售額 AmtFree ( 課稅別免稅 ) Int(10) TaxAmt 稅額 V Int(10) TotalAmt 發票金額 V Int(10) ItemName 商品名稱 V Varchar(30) 電子發票技術串接手冊 1. 課稅別為零稅率時, 才須使用的欄位 2. 課稅別為零稅率時, 須帶海關報關出口類別, 代號如下 : 1 = 非經海關出口 2 = 經海關出口 1. 純數字, 為發票銷售額 ( 未稅 ) 2. 銷售額計算方式, 請務必與公司財會人員進行確認 3. 當 TaxType =9 混合應稅與免稅或零稅率時, 此欄位為 AmtSales+ AmtZero+ AmtFree 欄位之合計金額 1. 當 TaxType =9 混合應稅與免稅或零稅率時, 才須提供此欄位 2. 純數字, 為該發票中課稅別應稅之銷售額 ( 未稅 ) 3. 銷售額計算方式請務必與公司財會人員進行確認 1. 當 TaxType =9 混合應稅與免稅或零稅率時, 才須提供此欄位 2. 純數字, 為該發票中課稅別零稅率之銷售額 3. 銷售額計算方式請務必與公司財會人員進行確認 1. 當 TaxType =9 混合應稅與免稅或零稅率時, 才須提供此欄位 2. 純數字, 為該發票中課稅別免稅之銷售額 3. 銷售額計算方式請務必與公司財會人員進行確認 1. 純數字, 為發票稅額 2. 稅額計算方式請務必與公司財會人員進行確認 1. 純數字, 為發票總金額 ( 含稅 ) 2. 銷售額 + 稅額需等於發票金額 多項商品時, 商品名稱以 分隔 例 :ItemName= 商品一 商品二 ItemCount 商品數量 V Int(5) 1. 純數字 電子發票加值服務平台 20 輕鬆開立. 批量申報. 省時環保. 成本低廉

22 ItemUnit 商品單位 V Varchar(2) ItemPrice 商品單價 V Int(10) ItemAmt 商品小計 V Int(10) ItemTaxType 商品課稅別 Int(2) Comment 備註 Varchar(71) 電子發票技術串接手冊 2. 多項商品時, 商品數量以 分隔 例 :ItemCount = 內容如 : 個 件 本 張.. 2. 多項商品時, 商品單位以 分隔 例 :ItemUnit = 個 本 1. 純數字 2.Category=B2B 時, 此參數金額為未稅金額 3.Category=B2C 時, 此參數金額為含稅金額 4. 多項商品時, 商品單價以 分隔 例 :ItemPrice = 純數字 2. 計算方式為 : 數量 * 單價 = 小計 3.Category=B2B 時, 此參數金額為未稅金額 4.Category=B2C 時, 此參數金額為含稅金額 5. 多項商品時, 商品小計以 分隔 例 :ItemAmt = 當 TaxType =9 混合應稅與免稅或零稅率時, 才須提供此欄位 2. 課稅別為混合應稅與免稅或零稅率時, 需區分各項商品之課稅別, 課稅別代號如下 : 1= 應稅 2= 零稅率 3= 免稅 3. 多項商品時, 商品課稅別以 分隔 例 :ItemRate = 發票備註, 字數限 71 字 2. 依據統一發票使用辦法第三章 第 9 條 第四項規定 : 營業人銷售貨物或勞務與持用簽帳卡之買受人者, 應於開立統一發票時, 於發票備註欄載明簽帳卡號末四碼 例 : 信用卡末四碼 :1234 電子發票加值服務平台 21 輕鬆開立. 批量申報. 省時環保. 成本低廉

23 ( 二 ) 開立發票系統回應訊息 電子發票技術串接手冊 1. 完成開立發票後, 將發票資料顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成回應下列訊息 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 開立發票成功, 則回傳 SUCCESS 當該筆開立發票參數 PostData_ 已重覆且參數資料完全一致, 則回傳 SUCCESS 2. 開立發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 Result 回傳資料 Varchar(10) 1.JSON 格式 2. 當該筆開立發票參數 PostData_ 已重覆且參數資料 完全一致, 則回傳原發票 Result Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 此次發票開立的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時提供的自訂編號 TotalAmt 發票金額 Int(10) 此次開立發票的金額 InvoiceNumber 發票號碼 Varchar(10) 1. 此次開立發票的發票號碼 2. 只有 Status=1 立即開立時, 才會回傳 RandomNum 發票防偽隨機碼 Varchar(4) 此次開立發票所產生的 4 碼防偽隨機碼 CreateTime 開立發票時間 DateTime 例 : :12:12 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可以比對此 參數資料, 來檢核是否為本平台所回傳, 檢核方法請 參考 附件二 BarCode 發票條碼 Varchar(50) 電子發票加值服務平台 22 輕鬆開立. 批量申報. 省時環保. 成本低廉

24 QRcodeL QRcodeR 範例 : 發票 QRCode ( 左 ) 發票 QRCode ( 右 ) Varchar(200) Varchar(200) 電子發票技術串接手冊 {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u958b\u7acb\u6210\u529f","Res ult":"{\"checkcode\":\"00e108df7de8756af da77a4c37ae33990ea04a944c D512228\",\"MerchantID\":\" \",\"MerchantOrderNo\":\" \",\"Inv oicenumber\":\"ds \",\"totalamt\":348,\"invoicetransno\":\" \",\"r andomnum\":\"4253\",\"createtime\":\" :58:36\",\"BarCode\":\"10412DS \",\"QRcodeL\":\"DS b c KbEN94WjYK3Jzwhx4VGtAw==:**********:2:2:0:\",\"QR coder\":\"**\\u5546\\u54c1\\u4e00:2:99:\\u5546\\u54c1\\u4e8c:3:50\"}"} 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 開立發票成功, 則回傳 SUCCESS 2. 開立發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 此次開立發票的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時提供的自訂編號 TotalAmt 發票金額 Int(10) 此次開立發票的金額 InvoiceNumber 發票號碼 Varchar(10) 1. 此次開立發票的發票號碼 2. 只有 Status=1 立即開立時, 才會回傳 RandomNum 發票防偽隨機碼 Varchar(4) 此次開立發票所產生的 4 碼防偽隨機碼 CreateTime 開立發票時間 DateTime 此次開立發票的時間, 例 : :12:12 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可以比對此 參數資料, 來檢核是否為本平台所回傳, 檢核方法請 參考 附件二 BarCode 發票條碼 Varchar(50) 電子發票加值服務平台 23 輕鬆開立. 批量申報. 省時環保. 成本低廉

25 QRcodeL 發票 QRCode ( 左 ) Varchar(200) QRcodeR 發票 QRCode ( 右 ) Varchar(200) EndStr 字串結尾 Varchar(2) 電子發票技術串接手冊 固定回傳 ##, 使用 String 方式接收資料的用戶, 須 多判斷 EndStr=##, 確保資料傳遞完整 範例 : Status=SUCCESS&Message=%E9%9B%BB%E5%AD%90%E7%99%BC%E7%A5%A8%E9 %96%8B%E7%AB%8B%E6%88%90%E5%8A%9F&Result=&CheckCode=2676BC6ADE A D055D46277E8D32A49B7D5DE77B70D9C6A&InvoiceNumber=DS &InvoiceTransNo= &MerchantID= &TotalAmt=365&Rando mnum=2909&merchantorderno= &createtime= %3A23%3A33&BarCode=10412DS &QRcodeL=DS c d fqMSCB6cFRvu3oUfw2bfgg%3D%3D%3A%2A%2 A%2A%2A%2A%2A%2A%2A%2A%2A%3A2%3A2%3A0%3A&QRcodeR=%2A%2A%E5%9 5%86%E5%93%81%E4%B8%80%3A2%3A99%3A%E5%95%86%E5%93%81%E4%BA%8 C%3A3%3A50&EndStr=%23%23 Urldecode() 後的結果如下 : Status=SUCCESS&Message= 電子發票開立成功 &Result=&CheckCode=2676BC6ADE A D055D46277E8D32A49B7D5 DE77B70D9C6A&InvoiceNumber=DS &InvoiceTransNo= &Mer chantid= &totalamt=365&randomnum=2909&merchantorderno= &CreateTime= :23:33&BarCode=10412DS &QRcodeL=DS c d fqMSCB6cFRvu3oUfw2bfgg==:**********:2:2:0:&QRcodeR=** 商品一 :2:99: 商品二 :3:50&EndStr=## PS:String 格式回傳時, 會多回 EndStr=##, 代表資料結尾, 確保資料完整性 電子發票加值服務平台 24 輕鬆開立. 批量申報. 省時環保. 成本低廉

26 ( 三 ) 觸發開立發票參數設定 電子發票技術串接手冊 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. 適用條件 : (1) 發票開立方式須為 A. 等待觸發開立發票 B. 預約自動開立發票 (2) 當發票開立方式為等待觸發開立發票時, 發票資料僅暫存於本平台, 若確認要開立, 則需再執行本章節的 觸發開立發票, 觸發後會立即開出發票 (3) 當發票開立方式為預約自動開立發票時, 本平台會於已設定預計開立日期執行開立發票, 於預計開立日期前若想提前開立, 則可執行本章節的 觸發開立發票, 觸發後會立即開出發票 3. Post 參數說明 : 參數名稱 參數中文名稱 必填 型態 備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 4. PostData_ 內含欄位 : 參數名稱 參數中文名稱 必填 型態 備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.0 TimeStamp 時間戳記 V Varchar(30) 智付寶平台 TransNum 交易序號 Varchar(20) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 商店如有同時使用智付寶金流服務者, 於此參數傳送智付寶交易序號, 可作為對應該筆金流交易進行發票開立 電子發票加值服務平台 25 輕鬆開立. 批量申報. 省時環保. 成本低廉

27 2. 未使用智付寶金流服務者, 則不須輸入此 參數 InvoiceTransNo 智付寶開立序號 V Varchar(20) 開立發票時的智付寶開立序號 MerchantOrderNo 自訂編號 V Varchar(20) 1. 商店自訂訂單編號, 限英 數字 _ 格式 例 : 可用於與營業人內部系統對應使用, 可填入訂單編號 帳務編號等等, 同一商店中此編號不可重覆 TotalAmt 發票金額 V Int(10) 此次開立發票的金額 電子發票加值服務平台 26 輕鬆開立. 批量申報. 省時環保. 成本低廉

28 ( 四 ) 觸發開立發票系統回應訊息 電子發票技術串接手冊 1. 觸發開立發票後, 將發票號碼顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成後, 回應下列訊息 : 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 開立發票成功, 則回傳 SUCCESS 2. 開立發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 Result 回傳資料 Varchar(10) JSON 格式 Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 此次發票開立的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時提供的自訂編號 TotalAmt 發票金額 Int(10) 此次開立發票的金額 InvoiceNumber 發票號碼 Varchar(10) 此次開立發票的發票號碼 RandomNum 發票防偽隨機碼 Varchar(4) 此次開立發票所產生的 4 碼防偽隨機碼 CreateTime 開立發票時間 DateTime 此次開立發票的時間, 例 : :12:12 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可比對此參 數資料來檢核是否為本平台所回傳, 檢核方法請參 考 附件二 電子發票加值服務平台 27 輕鬆開立. 批量申報. 省時環保. 成本低廉

29 範例 : {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u958b\u7acb\u6210\u529f","Res ult":"{\"merchantid\":\" \",\"invoicetransno\":\" \",\"merchantorder No\":\" \",\"TotalAmt\":\"500\",\"RandomNum\":\"0142\",\"CreateTime\":\" :12:13\",\"InvoiceNumber\":\"AB \",\"CheckCode\":\"F3BB07F44794AEB98A280F78 133AA59B7332EE3DEF470EB837D2BEB4A \"}"} 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 開立發票成功則回傳 SUCCESS 2. 開立發票失敗則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 此次發票開立的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時提供的自訂編號 TotalAmt 發票金額 Int(10) 此次開立發票的金額 InvoiceNumber 發票號碼 Varchar(10) 此次開立發票的發票號碼 RandomNum 發票防偽隨機碼 Varchar(4) 此次開立發票所產生的 4 碼防偽隨機碼 CreateTime 開立發票時間 DateTime 此次開立發票的時間, 例 : :12:12 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可比對此參 數資料, 來檢核是否為本平台所回傳, 檢核方法請參 考 附件二 範例 : Status=SUCCESS&Message=%E9%9B%BB%E5%AD%90%E7%99%BC%E7%A5%A8%E9 %96%8B%E7%AB%8B%E6%88%90%E5%8A%9F&MerchantID= &InvoiceTransNo= &MerchantOrderNo= &TotalAmt=500&RandomNu m=0142&createtime= %3A12%3A13&InvoiceNumber=AB &CheckCode=F3BB07F44794AEB98A28 0F78133AA59B7332EE3DEF470EB837D2BEB4A 電子發票加值服務平台 28 輕鬆開立. 批量申報. 省時環保. 成本低廉

30 五 作廢發票 ( 一 ) 作廢發票參數設定 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. Post 參數說明 : 參數名稱 參數中文名稱 必填 型態 備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 3. PostData_ 內含欄位 : 參數名稱 參數中文名稱 必填 型態 備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.0 TimeStamp 時間戳記 V Varchar(30) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 InvoiceNumber 發票號碼 V Varchar(10) 欲執行作廢之發票號碼 InvalidReason 作廢原因 V Varchar(20) 作廢原因, 字數限 20 字 電子發票加值服務平台 29 輕鬆開立. 批量申報. 省時環保. 成本低廉

31 ( 二 ) 作廢發票系統回應訊息 電子發票技術串接手冊 1. 完成作廢發票後, 將發票資料顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成回應下列訊息 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 作廢發票成功, 則回傳 SUCCESS 2. 作廢發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 Result 回傳資料 Varchar(10) JSON 格式 Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceNumber 發票號碼 Varchar(10) 此次作廢發票的發票號碼 CreateTime 作廢發票時間 DateTime 此次作廢發票的時間, 例 : :00:33 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可比對此參 數資料, 來檢核是否為本平台所回傳, 檢核方法請參 考 附件二 範例 : {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u4f5c\u5ee2\u958b\u7acb\u621 0\u529f","Result":"{\"CheckCode\":\"01DD7B45A33B D81656C6B3E93B B9 4EE0674D92D6BDB3204A\",\"MerchantID\":\" \",\"InvoiceNumber\":\"OU \",\" CreateTime\":\" :00:33\"}"} 電子發票加值服務平台 30 輕鬆開立. 批量申報. 省時環保. 成本低廉

32 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 電子發票技術串接手冊 Status 回傳狀態 Varchar(10) 1. 作廢發票成功, 則回傳 SUCCESS 2. 作廢發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceNumber 發票號碼 Varchar(10) 此次作廢發票的發票號碼 CreateTime 作廢發票時間 DateTime 此次作廢發票的時間, 例 : :00:33 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可比對此參 數資料, 來檢核是否為本平台所回傳, 檢核方法請參 考 附件二 範例 : Status=SUCCESS&Message=%E9%9B%BB%E5%AD%90%E7%99%BC%E7%A5%A8%E4 %BD%9C%E5%BB%A2%E9%96%8B%E7%AB%8B%E6%88%90%E5%8A%9F&CheckCod e=01dd7b45a33b d81656c6b3e93b b94ee0674d92d6bdb3204a&mer chantid= &invoicenumber=ou &createtime= %3A03%3A11 電子發票加值服務平台 31 輕鬆開立. 批量申報. 省時環保. 成本低廉

33 六 折讓作業 ( 一 ) 開立折讓參數設定 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. Post 參數說明 : 參數名稱 參數中文名稱 必填 型態 備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 3. PostData_ 內含欄位 : 參數名稱 參數中文名稱 必填 型態 備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.3 TimeStamp 時間戳記 V Varchar(30) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 InvoiceNo 發票號碼 V Varchar(10) 此次開立折讓的發票號碼 MerchantOrderNo 自訂編號 V Varchar(20) ItemName 折讓商品名稱 V Varchar(100) ItemCount 折讓商品數量 V Int(20) ItemUnit 折讓商品單位 V Varchar(30) 此次開立折讓的發票, 於開立發票時, 提供之自訂編號 多項商品時, 商品名稱以 分隔 例 :ItemName= 商品一 商品二 1. 純數字 2. 多項商品時, 商品數量以 分隔 例 :ItemCount = 內容如 : 個 件 本 張.. 2. 多項商品時, 商品單位以 分隔 例 :ItemUnit = 個 本 ItemPrice 折讓商品單價 V Int(30) 1. 純數字 電子發票加值服務平台 32 輕鬆開立. 批量申報. 省時環保. 成本低廉

34 ItemAmt 折讓商品小計 V Int(30) TaxTypeForMixed 折讓課稅別 Int(2) ItemTaxAmt 折讓商品稅額 V Int(10) 電子發票技術串接手冊 2 此參數可為未稅金額或含稅金額, 當此參數為含稅金額時,ItemTaxAmt =0, 申報時將無法扣抵該項營業稅額 請自行與會計人員確認採何種作法 3. 多項商品時, 商品單價以 分隔 例 :ItemPrice = 純數字 2. 計算方式為 : 數量 * 單價 = 小計 3. 多項商品時, 商品小計以 分隔 例 :ItemAmt = 當 TaxType =9 混合應稅與免稅或零稅率時, 才須提供此欄位 2. 當折讓的發票課稅別為混合應稅與免稅或零稅率時, 需依應稅 零稅率 免稅個別開立折讓單 3. 1= 應稅 2= 零稅率 3= 免稅 1. 純數字 2.ItemPrice 為未稅金額時, 計算方式為 : 小計 * 稅率 = 稅額 3.ItemPrice 為含稅金額時, 此參數 =0, 申報時將無法扣抵該項營業稅額 4. 多項商品時, 商品稅額以 分隔 例 :AllowTaxAmt = TotalAmt 折讓總金額 V Int(10) 此次開立折讓加總金額 Buyer 買受人電子信箱 Varchar(50) Status 確認折讓方式 V Varchar(1) 買受人的電子信箱 當折讓開立時, 寄送折讓相關查詢資訊至買受人的電子信箱 0= 開立折讓後, 不立即確認折讓 可待買受人確認折讓後, 再向本平台發動確認折讓 確認折讓參數請參考 六 - ( 三 ) 觸發確認折讓或取消折讓參數設定 1= 開立折讓後, 立即確認折讓 電子發票加值服務平台 33 輕鬆開立. 批量申報. 省時環保. 成本低廉

35 ( 二 ) 開立折讓系統回應訊息 電子發票技術串接手冊 1. 完成開立折讓後, 將折讓資料顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成回應下列訊息 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 開立折讓成功, 則回傳 SUCCESS 2. 開立折讓失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 Result 回傳資料 Varchar(10) JSON 格式 Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 AllowanceNo 折讓號 Varchar(20) 此次開立折讓的折讓號 InvoiceNumber 發票號碼 Varchar(10) 此次開立折讓的發票號碼 MerchantOrderNo 自訂編號 Varchar(20) 此次開立折讓的發票, 於開立發票時, 提供之自訂編 號 AllowanceAmt 折讓金額 Int(10) 此次開立折讓的金額 折讓後剩餘 RemainAmt 發票金額 Int(10) CheckCode 檢查碼 Varchar(150) 確認折讓後, 此張發票剩餘之發票金額 用來檢查此次資料回傳的合法性, 串接時可以比對此參數資料, 來檢核是否為本平台所回傳, 檢核方法請參考 附件二 範例 : {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u958b\u7acb\u6210\u529f","Res ult":"{\"merchantid\":\" \",\"allowanceno\":\"a \",\"merchantorderno\":\ "202E19\",\"AllowanceAmt\":\"500\",\"RemainAmt\":\"0\",\"CheckCode\":\"F3BB07F44794AEB98 A280F78133AA59B7332EE3DEF470EB837D2BEB4A \"}"} 電子發票加值服務平台 34 輕鬆開立. 批量申報. 省時環保. 成本低廉

36 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 電子發票技術串接手冊 Status 回傳狀態 Varchar(10) 1. 開立折讓成功, 則回傳 SUCCESS 2. 開立折讓失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 AllowanceNo 折讓號 Varchar(20) 此次開立折讓的折讓號 InvoiceNumber 發票號碼 Varchar(10) 此次開立折讓的發票號碼 MerchantOrderNo 自訂編號 Varchar(20) 此次開立折讓的發票, 於開立發票時, 提供之自訂編 號 AllowanceAmt 折讓金額 Int(10) 此次開立折讓的金額 折讓後剩餘 RemainAmt 發票金額 Int(10) CheckCode 檢查碼 Varchar(150) 確認折讓後, 此張發票剩餘之發票金額 用來檢查此次資料回傳的合法性, 串接時可以比對此參數資料, 來檢核是否為本平台所回傳, 檢核方法請參考 附件二 範例 : Status=SUCCESS&Message=%E9%9B%BB%E5%AD%90%E7%99%BC%E7%A5%A8%E9 %96%8B%E7%AB%8B%E6%88%90%E5%8A%9F&MerchantID= &AllowanceNo=A &MerchantOrderNo=202E19&AllowanceAmt=500&RemainAmt =0& CheckCode=F3BB07F44794AEB98A280F78133AA59B7332EE3DEF470EB837D2BEB4A 電子發票加值服務平台 35 輕鬆開立. 批量申報. 省時環保. 成本低廉

37 ( 三 ) 觸發確認折讓或取消折讓參數設定 電子發票技術串接手冊 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. 於開立折讓時, 若 Status 參數 =0, 則開立的折讓資料, 僅記錄於本平台, 未上傳至財政部電子發票整合服務平台, 營業人可於與買受人確認後, 依本章節之參數設定, 執行以下動作 : (1) 確認折讓 : 確認折讓後, 本平台將於隔日將折讓資料上傳至財政部電子發票整合服務平台 (2) 取消折讓 : A. 取消折讓後, 則本平台將該折讓狀態變更為取消 B. 已確認折讓後, 則無法再執行取消折讓 3. Post 參數說明 : 參數名稱 參數中文名稱 必填 型態 備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 4. PostData_ 內含欄位 : 參數名稱 參數中文名稱 必填 型態 備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.0 TimeStamp 時間戳記 V Varchar(30) AllowanceStatus 觸發折讓狀態 V Varchar(1) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 C = 確認折讓 D = 取消折讓 AllowanceNo 折讓號 V Varchar(20) 開立折讓時的折讓號 電子發票加值服務平台 36 輕鬆開立. 批量申報. 省時環保. 成本低廉

38 MerchantOrderNo 自訂編號 V Varchar(20) 電子發票技術串接手冊 此次開立折讓的發票, 於開立發票時, 提供 之自訂編號 TotalAmt 折讓總金額 V Int(10) 此折讓之總金額 電子發票加值服務平台 37 輕鬆開立. 批量申報. 省時環保. 成本低廉

39 ( 四 ) 觸發確認折讓或取消折讓系統回應訊息 電子發票技術串接手冊 1. 觸發確認折讓或取消折讓後, 將觸發結果資料顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成後, 回應下列訊息 : 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 觸發確認折讓或取消折讓成功, 則回傳 SUCCESS 2. 觸發確認折讓或取消折讓失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 Result 回傳資料 Varchar(10) JSON 格式 Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 AllowanceNo 折讓號 Varchar(20) 此次開立折讓的折讓號 InvoiceNumber 發票號碼 Varchar(10) 此次開立折讓的發票號碼 MerchantOrderNo 自訂編號 Varchar(20) 此次開立折讓的發票, 於開立發票時, 提供之自訂編 號 AllowanceAmt 折讓金額 Int(10) 此次開立折讓的金額 折讓後剩餘 RemainAmt 發票金額 Int(10) CheckCode 檢查碼 Varchar(150) 確認折讓後, 此張發票剩餘之發票金額 用來檢查此次資料回傳的合法性, 串接時可以比對此參數資料, 來檢核是否為本平台所回傳, 檢核方法請參考 附件二 範例 : {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u958b\u7acb\u6210\u529f","Res ult":"{\"merchantid\":\" \",\"allowanceno\":\"a \",\"merchantorderno\":\ 電子發票加值服務平台 38 輕鬆開立. 批量申報. 省時環保. 成本低廉

40 "202E19\",\"AllowanceAmt\":\"500\",\"RemainAmt\":\"0\",\"CheckCode\":\"F3BB07F44794AEB98 A280F78133AA59B7332EE3DEF470EB837D2BEB4A \"}"} 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 觸發確認折讓或取消折讓成功, 則回傳 SUCCESS 2. 觸發確認折讓或取消折讓失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 此次回傳狀態說明 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 AllowanceNo 折讓號 Varchar(20) 此次開立折讓的折讓號 InvoiceNumber 發票號碼 Varchar(10) 此次開立折讓的發票號碼 MerchantOrderNo 自訂編號 Varchar(20) 此次開立折讓的發票, 於開立發票時, 提供之自訂編 號 AllowanceAmt 折讓金額 Int(10) 此次開立折讓的金額 RemainAmt 折讓後剩餘發票金額 Int(10) 確認折讓後, 此張發票剩餘之發票金額 CheckCode 檢查碼 Varchar(150) 用來檢查此次資料回傳的合法性, 串接時可以比對此參數資料, 來檢核是否為本平台所回傳, 檢核方法請參考 附件二 範例 : Status=SUCCESS&Message=%E9%9B%BB%E5%AD%90%E7%99%BC%E7%A5%A8%E9 %96%8B%E7%AB%8B%E6%88%90%E5%8A%9F&MerchantID= & AllowanceNo = A &MerchantOrderNo=202E19& AllowanceAmt=500& RemainAmt =0& CheckCode=F3BB07F44794AEB98A280F78133AA59B7332EE3DEF470EB837D2BEB4A 電子發票加值服務平台 39 輕鬆開立. 批量申報. 省時環保. 成本低廉

41 七 查詢發票 ( 一 ) 查詢發票參數設定 1. 串接網址 : (1) 測試串接網址 : (2) 正式串接網址 : 2. Post 參數說明 : 參數名稱 參數中文名稱 必填 型態 備註 MerchantID_ 商店代號 V Varchar(15) Pay2go 電子發票加值服務平台商店代號 PostData_ 加密資料 V text 相關加密方法請參考 附件一 註 : 參數 MerchantID_ 及 PostData_ 後方有底線 _ 符號 3. PostData_ 內含欄位 : 參數名稱 參數中文名稱 必填 型態 備註 RespondType 回傳格式 V Varchar(5) JSON 或是 String Version 串接程式版本 V Varchar(5) 固定帶 1.1 TimeStamp 時間戳記 V Varchar(30) SearchType 查詢方式 Varchar(1) 自從 Unix 纪元 ( 格林威治時間 1970 年 1 月 1 日 00:00:00) 到當前時間的秒數, 若以 php 程式語言為例, 即為呼叫 time() 函式所回傳的值 例 : :00:00 這個時間的時間戳記為 = 使用發票號碼及隨機碼查詢 1= 使用訂單編號及發票金額查詢 ( 若沒帶此參數, 則預設為 0 ) MerchantOrderNo 訂單編號 V Varchar(25) 此次查詢的訂單編號 TotalAmt 發票金額 V Varchar(10) 開立發票的總金額 InvoiceNumber 發票號碼 V Varchar(10) 此次查詢的發票號碼 RandomNum 發票防偽隨機碼 V Varchar(4) 開立發票時, 回傳的 4 碼發票防偽隨機碼 DisplayFlag 是否於本平台網頁 顯示發票查詢結果 Varchar(1) 1. 若此參數值為 1, 營業人需以 Form Post 表單送出之方式, 將網頁控制權送至本平 台, 本平台將以網頁顯示發票查詢結果 電子發票加值服務平台 40 輕鬆開立. 批量申報. 省時環保. 成本低廉

42 2. 若不帶此參數, 則以參數回傳該筆發票資料 請參考 七 -( 二 ) 查詢發票系統回應訊息 電子發票加值服務平台 41 輕鬆開立. 批量申報. 省時環保. 成本低廉

43 ( 二 ) 查詢發票系統回應訊息 電子發票技術串接手冊 1. 完成查詢發票後, 將發票資料顯示於 Web Services 頁面 2. 回應訊息格式為依 RespondType 所帶的參數回傳對應格式 回傳格式為兩種 :Json 及 String: (1) 若 RespondType = JSON, 則請參考以下 JSON 回傳參數說明 (2) 若 RespondType = String, 則請參考以下 String 回傳參數說明 3. JSON 回傳參數說明 : 本平台會於接收商戶資訊完成回應下列訊息 參數名稱參數中文名稱型態備註 Status 回傳狀態 Varchar(10) 1. 查詢發票成功, 則回傳 SUCCESS 2. 查詢發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 敘述此次狀態 Result 回傳資料 Varchar(10) JSON 格式 Result 內容包含資料如下 : 參數名稱 參數中文名稱 型態 備註 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 發票開立時的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時帶入的自訂編號 InvoiceNumber 發票號碼 Varchar(10) 此次查詢的發票號碼 RandomNum 發票防偽隨機碼 Varchar(4) 於開立發票時, 所產生的 4 碼發票防偽隨機碼 BuyerName 買受人名稱 Varchar(60) 開立發票時的買受人名稱, 個人姓名或營業人名稱 BuyerUBN 買受人統一編號 Varchar(10) 1. 若為 B2B 發票, 此欄位為買受人統一編號 2. 若為 B2C 發票, 此欄位為空值 BuyerAddress 買受人地址 Varchar(150) 於開立發票時, 該張發票的買受人地址 BuyerPhone 買受人手機號碼 Varchar(15) 於開立發票時, 該張發票的買受人手機號碼 Buyer 買受人電子信箱 Varchar(100) 於開立發票時, 該張發票的買受人電子信箱 InvoiceType 發票字軌類型 Varchar(2) 該張發票的發票字軌類型 07= 一般稅額計算 08= 特種稅額計算 Category 發票種類 Varchar(5) 該張發票的發票種類 電子發票加值服務平台 42 輕鬆開立. 批量申報. 省時環保. 成本低廉

44 TaxType 課稅別 Varchar(2) 電子發票技術串接手冊 B2B= 買受人為營業人 ( 有統編 ) B2C= 買受人為個人該張發票的課稅別 1= 應稅 2= 零稅率 3= 免稅 9= 混合應稅與免稅或零稅率 TaxRate 稅率 Float(6,4) 該張發票的稅率, 例 :0.05 Amt 銷售額合計 Int(10) 純數字, 為發票銷售額 AmtSales 銷售額 Int(10) AmtZero 銷售額 Int(10) AmtFree 銷售額 Int(10) 1. 純數字, 為發票銷售額 ( 課稅別應稅的未稅金額 ) 2. 當 TaxType =9 混合應稅與免稅或零稅率時, 才提供此參數 1. 純數字, 為發票銷售額 ( 課稅別零稅率的未稅金額 ) 2. 當 TaxType =9 混合應稅與免稅或零稅率時, 才提供此參數 1. 純數字, 為發票銷售額 ( 課稅別免稅的未稅金額 ) 2. 當 TaxType =9 混合應稅與免稅或零稅率時, 才提供此參數 TaxAmt 稅額 Int(10) 純數字, 為發票稅額 TotalAmt 發票金額 Int(10) 純數字, 為發票總金額 ( 含稅 ) CarrierType 載具類別 Varchar(2) 1. 該張發票儲存的載具類別 0= 手機條碼載具 1= 自然人憑證條碼載具 2= 智付寶載具 2. 若買受人無提供載具, 則此參數為空值 3. 當 Category=B2C 時, 才適用此參數 CarrierNum 載具編號 Varchar(50) 該張發票儲存的載具之載具編號 LoveCode 愛心碼 Varchar(10) PrintFlag 索取紙本發票 Varchar(1) 1. 該張發票捐贈的愛心碼 2. 買受人選擇不捐贈則此參數為空值 3. 當 Category=B2C 時, 才適用此參數 該張發票是否索取紙本發票 Y= 索取 ( 營業人可於本平台列印此發票 ) N= 不索取 CreateTime 開立發票時間 DateTime 該張發票開立時間, 例 : :12:12 電子發票加值服務平台 43 輕鬆開立. 批量申報. 省時環保. 成本低廉

45 ItemDetail 商品明細 Text InvoiceStatus 發票狀態 Varchar(1) UploadStatus 發票上傳狀態 Varchar(1) CheckCode 檢查碼 Varchar(150) 電子發票技術串接手冊該張發票開立時的商品資訊 (JSON 格式 ) ItemNum = 品項序號 ItemName = 商品名稱 ItemCount = 數量 ItemWord = 單位 ItemPrice = 單價 ItemAmount = 小計 ItemTaxType = 課稅別該張發票之發票狀態 1 = 已開立 ( 有產生發票號碼 ) 2 = 已作廢該張發票上傳財政部之狀態 0 = 未上傳 1 = 已上傳成功 2 = 上傳中 3 = 上傳失敗用來檢查此次資料回傳的合法性, 企業用戶串接時可以比對此參數資料來檢核是否為本平台所回傳, 檢核方法請參考 附件二 範例 : {"Status":"SUCCESS","Message":"\u67e5\u8a62\u6210\u529f","Result":"{\"MerchantID\":\" \",\"InvoiceTransNo\":\" \",\"MerchantOrderNo\":\" \",\"InvoiceNumber\":\"OK \",\"RandomNum\":\"3357\",\"BuyerName\":\"\\u738b\\u59 27\\u660e\",\"BuyerUBN\":\" \",\"BuyerAddress\":\"\\u53f0\\u5317\\u5e02\\u5357\\u7a3 f\\u5340\\u5357\\u6e2f\\u8def2\\u6bb599-4\\u865f3\\u6a13\",\"buyerphone\":\" \",\"buyer \":\"andy@dotway.com.tw\",\"in voicetype\":\"04\",\"category\":\"b2b\",\"taxtype\":\"1\",\"taxrate\":\" \",\"amt\":\"348\",\" TaxAmt\":\"17\",\"TotalAmt\":\"365\",\"CarrierType\":\"\",\"CarrierNum\":\"\",\"LoveCode\":\"\",\"Pri ntflag\":\"y\",\"createtime\":\" :56:00\",\"ItemDetail\":\"[{\\\"ItemNum\\\":1,\\\"ItemName\\\":\\\"\\\\u5546\\\\u54c1\\\\u4e00\\\",\\\ "ItemCount\\\":\\\"2\\\",\\\"ItemWord\\\":\\\"\\\\u500b\\\",\\\"ItemPrice\\\":\\\"99\\\",\\\"ItemAmount\\\": \\\"198\\\"},{\\\"ItemNum\\\":2,\\\"ItemName\\\":\\\"\\\\u5546\\\\u54c1\\\\u4e8c\\\",\\\"ItemCount\\\":\\ \"3\\\",\\\"ItemWord\\\":\\\"\\\\u4ef6\\\",\\\"ItemPrice\\\":\\\"50\\\",\\\"ItemAmount\\\":\\\"150\\\"}]\",\"In voicestatus\":\"2\",\"createstatustime\":\"\",\"uploadstatus\":\"0\",\"checkcode\":\"669a3958b 1316BDADA01C0D25EEEFEAC5A9DBFFDD69305CC9673F599A20C99CC\"}"} 電子發票加值服務平台 44 輕鬆開立. 批量申報. 省時環保. 成本低廉

46 4. String 回傳參數說明 : 參數名稱參數中文名稱型態備註 電子發票技術串接手冊 Status 回傳狀態 Varchar(10) 1. 開立發票成功, 則回傳 SUCCESS 2. 開立發票失敗, 則回傳錯誤代碼 錯誤代碼請參考 八 錯誤代碼 Message 回傳訊息 Varchar(30) 文字, 敘述此次狀態 MerchantID 商店代號 Varchar(15) Pay2go 電子發票加值服務平台商店代號 InvoiceTransNo 智付寶開立序號 Varchar(20) 發票開立時的智付寶開立序號 MerchantOrderNo 自訂編號 Varchar(20) 商店於開立發票時帶入的自訂編號 InvoiceNumber 發票號碼 Varchar(10) 此次查詢的發票號碼 RandomNum 發票防偽隨機碼 Varchar(4) 於開立發票時, 所產生的 4 碼發票防偽隨機碼 BuyerName 買受人名稱 Varchar(60) 開立發票時的買受人名稱, 個人姓名或營業人名稱 BuyerUBN 買受人統一編號 Varchar(10) 1. 若為 B2B 發票, 此欄位為買受人統一編號 2. 若為 B2C 發票, 此欄位為空值 BuyerAddress 買受人地址 Varchar(150) 於開立發票時, 該張發票的買受人地址 BuyerPhone 買受人手機號碼 Varchar(15) 於開立發票時, 該張發票的買受人手機號碼 Buyer 買受人電子信箱 Varchar(100) 於開立發票時, 該張發票的買受人電子信箱 InvoiceType 發票字軌類型 Varchar(2) Category 發票種類 Varchar(5) TaxType 課稅別 Varchar(2) 該張發票的發票字軌類型 07= 一般稅額計算 08= 特種稅額計算該張發票的發票種類 B2B= 買受人為營業人 ( 有統編 ) B2C= 買受人為個人該張發票的課稅別 1= 應稅 2= 零稅率 3= 免稅 9= 混合應稅與免稅或零稅率 TaxRate 稅率 Float(6,4) 該張發票的稅率, 例 :0.05 Amt 銷售額合計 Int(10) 純數字, 為發票銷售額 ( 課稅別應稅的未稅金額 ) AmtSales 銷售額 Int(10) 純數字, 為發票銷售額 ( 課稅別應稅的未稅金額 ) AmtZero 銷售額 Int(10) 純數字, 為發票銷售額 ( 課稅別零稅率的未稅金額 ) AmtFree 銷售額 Int(10) 純數字, 為發票銷售額 ( 課稅別免稅的未稅金額 ) 電子發票加值服務平台 45 輕鬆開立. 批量申報. 省時環保. 成本低廉

47 TaxAmt 稅額 Int(10) 純數字, 為發票稅額 TotalAmt 發票金額 Int(10) 純數字, 為發票總金額 ( 含稅 ) CarrierType 載具類別 Varchar(2) 1. 該張發票儲存的載具類別 0= 手機條碼載具 1= 自然人憑證條碼載具 2= 智付寶載具 2. 若買受人無提供載具, 則此參數為空值 3. 當 Category=B2C 時, 才適用此參數 CarrierNum 載具編號 Varchar(50) 該張發票儲存的載具之載具編號 LoveCode 愛心碼 Varchar(10) PrintFlag 索取紙本發票 Varchar(1) 1. 該張發票捐贈的愛心碼 2. 買受人選擇不捐贈則此參數為空值 3. 當 Category=B2C 時, 才適用此參數 該張發票是否索取紙本發票 Y= 索取 ( 營業人可於本平台列印此發票 ) N= 不索取 CreateTime 開立發票時間 DateTime 該張發票開立時間, 例 : :12:12 ItemDetail 商品明細 Text InvoiceStatus 發票狀態 Varchar(1) UploadStatus 發票上傳狀態 Varchar(1) CheckCode 檢查碼 Varchar(150) 該張發票開立時的商品資訊 (JSON 格式 ) ItemNum = 品項序號 ItemName = 商品名稱 ItemCount = 數量 ItemWord = 單位 ItemPrice = 單價 ItemAmount = 小計 ItemTaxType = 課稅別該張發票之發票狀態 1 = 已開立 ( 有產生發票號碼 ) 2 = 已作廢該張發票上傳財政部之狀態 0 = 未上傳 1 = 已上傳成功 2 = 上傳中 3 = 上傳失敗用來檢查此次資料回傳的合法性, 企業用戶串接時可以比對此參數資料來檢核是否為 Pay2go 平台所回傳, 檢核方法請參考 附件二 電子發票加值服務平台 46 輕鬆開立. 批量申報. 省時環保. 成本低廉

48 範例 : Status=SUCCESS&Message=%E6%9F%A5%E8%A9%A2%E6%88%90%E5%8A%9F&Merc hantid= &invoicetransno= &merchantorderno= &InvoiceNumber=OK &RandomNum=3357&BuyerName=%E7%8E%8B%E5 %A4%A7%E6%98%8E&BuyerUBN= &BuyerAddress=%E5%8F%B0%E5%8C%97 %E5%B8%82%E5%8D%97%E7%A8%BF%E5%8D%80%E5%8D%97%E6%B8%AF%E8%B 7%AF2%E6%AE%B599-4%E8%99%9F3%E6%A8%93&BuyerPhone= &Buyer =andy%40dotway.co m.tw&invoicetype=04&category=b2b&taxtype=1&taxrate= &amt=348&taxamt=17 &TotalAmt=365&CarrierType=&CarrierNum=&LoveCode=&PrintFlag=Y&CreateTime= %3A56%3A00&ItemDetail=%5B%7B%22ItemNum%22%3A1%2C%22ItemName%22 %3A%22%5Cu5546%5Cu54c1%5Cu4e00%22%2C%22ItemCount%22%3A%222%22%2C% 22ItemWord%22%3A%22%5Cu500b%22%2C%22ItemPrice%22%3A%2299%22%2C%22Ite mamount%22%3a%22198%22%7d%2c%7b%22itemnum%22%3a2%2c%22itemname%2 2%3A%22%5Cu5546%5Cu54c1%5Cu4e8c%22%2C%22ItemCount%22%3A%223%22%2C %22ItemWord%22%3A%22%5Cu4ef6%22%2C%22ItemPrice%22%3A%2250%22%2C%22It emamount%22%3a%22150%22%7d%5d&invoicestatus=2&createstatustime=&uploadsta tus=0&checkcode=669a3958b1316bdada01c0d25eeefeac5a9dbffdd69305cc9673 F599A20C99CC 電子發票加值服務平台 47 輕鬆開立. 批量申報. 省時環保. 成本低廉

49 八 錯誤代碼 商店可能遭遇下列錯誤狀況, 其錯誤代碼與對應的錯誤原因如下表所示 : 錯誤代碼錯誤原因備註 KEY10002 KEY10004 KEY10006 KEY10007 KEY10010 KEY10011 KEY10012 KEY10013 KEY10014 KEY10015 INV10003 INV10004 INV10006 INV10012 INV10013 INV10014 INV10015 INV10016 INV10017 INV20006 INV70001 INV90005 INV90006 NOR10001 資料解密錯誤資料不齊全商店未申請啟用電子發票頁面停留超過 30 分鐘商店代號空白 PostData_ 欄位空白資料傳遞錯誤資料空白 TimeOut 發票金額格式錯誤商品資訊格式錯誤或缺少資料商品資訊的商品小計計算錯誤稅率格式錯誤發票金額 課稅別驗證錯誤發票欄位資料不齊全或格式錯誤自訂編號格式錯誤無未稅金額無稅金輸入的版本不支援混合稅率功能查無發票資料欄位資料格式錯誤未簽定合約或合約已到期可開立張數已用罄網路連線異常 電子發票加值服務平台 48 輕鬆開立. 批量申報. 省時環保. 成本低廉

50 LIB10003 LIB10005 LIB10007 LIB10008 LIB10009 商店自訂編號重覆發票已作廢過無法作廢超過可作廢期限發票已開立, 但未上傳至財政部, 無法作廢 當該張發票已執行過發票折讓, 則無法再執行作廢 需於開立發票上傳財政部完成後, 才可執行作廢 電子發票加值服務平台 49 輕鬆開立. 批量申報. 省時環保. 成本低廉

51 附件一 PostData_ 加密方法範例程式 電子發票技術串接手冊 A. PostData_ 加密方法 ( 以 PHP.net c# 為例 ): 傳送發票資料中, 除了商店代號欄位 (MerchantID_) 之外, 其餘欄位均須採用 Aes 加密後放到 PostData_ 欄位, 再以 PHP.net c# 版本程式語言透過幕後方式送至電子發票開立閘道, 可參考 CURL 模組 以下提供 PHP 版本程式語言範例以供參考 : <?php //==== 以下為副程式 ==== function addpadding($string, $blocksize = 32) { $len = strlen($string); $pad = $blocksize - ($len % $blocksize); $string.= str_repeat(chr($pad), $pad); return $string; } function curl_work($url = "", $parameter = "") { $curl_options = array( CURLOPT_URL => $url, CURLOPT_HEADER => false, CURLOPT_RETURNTRANSFER => true, CURLOPT_USERAGENT => "Google Bot", CURLOPT_FOLLOWLOCATION => true, CURLOPT_SSL_VERIFYPEER => FALSE, CURLOPT_SSL_VERIFYHOST => FALSE, CURLOPT_POST => "1", CURLOPT_POSTFIELDS => $parameter ); $ch = curl_init(); curl_setopt_array($ch, $curl_options); $result = curl_exec($ch); $retcode = curl_getinfo($ch, CURLINFO_HTTP_CODE); 電子發票加值服務平台 50 輕鬆開立. 批量申報. 省時環保. 成本低廉

52 $curl_error = curl_errno($ch); curl_close($ch); $return_info = array( "url" => $url, "sent_parameter" => $parameter, "http_status" => $retcode, "curl_error_no" => $curl_error, "web_info" => $result ); return $return_info; } //==== 以上為副程式 ==== $post_data_array = array(//post_data 欄位資料 "RespondType" => "JSON", "Version" => "1.1", "TimeStamp" => " ", // 請以 time() 格式 "TransNum" => "", "MerchantOrderNo" => " ", "BuyerName" => " 王大品 ", "BuyerUBN" => " ", "BuyerAddress" => " 台北市南港區南港路一段 99 號 ", "Buyer " => "abc@gmail.com", "BuyerPhone" => " ", "Category" => "B2B", "TaxType" => "1", "TaxRate" => "5", "Amt" => "490", "TaxAmt" => "10", "TotalAmt" => "500", "CarrierType" => "", "CarrierNum" => rawurlencode(""), "LoveCode" => "", "PrintFlag" => "Y", "ItemName" => " 商品一 商品二 ", // 多項商品時, 以 分開 電子發票加值服務平台 51 輕鬆開立. 批量申報. 省時環保. 成本低廉

53 "ItemCount" => "1 2", // 多項商品時, 以 分開 "ItemUnit" => " 個 個 ", // 多項商品時, 以 分開 "ItemPrice" => " ", // 多項商品時, 以 分開 "ItemAmt" => " ", // 多項商品時, 以 分開 "Comment" => "TEST, 備註說明 ", "Status" => "1", //1= 立即開立,0= 待開立,3= 延遲開立 "CreateStatusTime" => "", "Notify " => "1", //1= 通知,0= 不通知 ); $post_data_str = http_build_query($post_data_array);// 轉成字串排列 $key = "abcdefghijklmnopqrstuvwxyzabcdef"; // 商店專屬串接金鑰 HashKey 值 $iv = " "; // 商店專屬串接金鑰 HashIV 值 $post_data = trim(bin2hex(openssl_encrypt(addpadding($post_data_str), 'AES- 256-CBC', $key, OPENSSL_RAW_DATA OPENSSL_ZERO_PADDING, $iv))); // 加密 // ==== $post_data_str 陣列轉成字串樣式如下 ======== // RespondType=JSON&Version=1.1&TimeStamp= &TransNum=&MerchantOrderNo= &BuyerName=%E7%8E%8B%E5%A4%A7%E5%93%81&BuyerUBN= &BuyerAddress=%E5%8F%B0%E5%8C%97%E5%B8%82%E5%8D%97%E6%B8%AF%E5%8D%80 %E5%8D%97%E6%B8%AF%E8%B7%AF%E4%B8%80%E6%AE%B599%E8%99%9F&Buyer =a bc%40gmail.com&buyerphone= &category=b2b&taxtype=1&taxrate=5&amt=49 0&TaxAmt=10&TotalAmt=500&CarrierType=&CarrierNum=&LoveCode=&PrintFlag=Y&ItemNa me=%e5%95%86%e5%93%81%e4%b8%80%7c%e5%95%86%e5%93%81%e4%ba%8c&itemco unt=1%7c2&itemunit=%e5%80%8b%7c%e5%80%8b&itemprice=300%7c100&itemamt=300% 7C200&Comment=TEST%EF%BC%8C%E5%82%99%E8%A8%BB%E8%AA%AA%E6%98%8E&Stat us=1&createstatustime=&notify =1 // ==== addpadding() 補足字串長度, 回傳樣式 ======== // ( 在 Notify =1 後面補足 22 個 0x16, 因文件無法印出, 故此說明 ; 使用 PKCS#7) // ==== $post_data 壓碼後樣式如下 ( 僅供樣式參考, 依實際資料為主 ) ======== // /* $post_data = 70a61189d7dc0f6abefe7643da144af5a96f5d1290dee28c618fdd11e8dcabe5bbd025b6c2d586ce3 電子發票加值服務平台 52 輕鬆開立. 批量申報. 省時環保. 成本低廉

54 e9fd2af6702f2dad336db419ffa6ca990d10df4d5f5a580c d a0ea 08d1d171187dce545d36e1d02c92f4b1172d9b a023b6490b2dfbe82d905a929dddd cf205de3613ddc93bec63f2f4b7d86dcc2180eaf1d600d049a05bb56f7088b5fb a229e f9969fe7add94562fa83d01b1f917044ede7a099d694ff7b13c868447faad86c5aef10edc756afc698 e2ff2dcaafbf817d2afae62531a50db9d8280d43f2904bbbb1b5ae7e f3f1a1e83855fa 65868fb8d8afd35e348dbb28d0400d0acb50c3be acf ea5248e0b 9bf7231d5286f c9636c75ef421ac98f7b70eddb32c1b f65c a35c42a1 e7dbdaceb2bffd89d038c0ce3970b59500b994cd36fae90575a88dfe188ea8646fab3d26ab720b1d bd7ca3c1b517c75840eebb20e bd28f8faff24c09da3e7ae1f4cb5dda2095d18a56aa9fa5 03b761332dc0c0ee9ebfb8f6382ec4f8cf5ddec368bf f7d038e885d0cf582bb e9221fadd51aef987529cb63d03cb63cced0afa6baa5bf07d28c2043c6aaeaf2c6cbfd624ecffc52 7a5fcb48d6790ee7fd37008acfee1d84ca5b51661bfef8fac00e28d49bb5fc11194fbe2456edf6bbb9 99a80d4830f01d5cd95cfdb58fa90ee06fe69985ebd39c1075dd51ad54619d1ea926bdd689aa8128 aa021d8ce6b3a574b383b3e e70aa1798d082607ac64ae d5f101e04921c2d0352a 9f390c bfd90242cf69a0c1ad309b46f3c419db679d557f3e4f6d549f0b1902ae1a6301f9a 6b6b9e6fc2548df9dc8b46c3bd6a85be01dda39a93a5c373a acb5718f71c54a51b62a6e3f8 478b50d02ddad5d9cfc293271cdad30e5 */ $url = " $MerchantID = " "; // 商店代號 $transaction_data_array = array( // 送出欄位 "MerchantID_" =>$MerchantID, "PostData_" => $post_data ); $transaction_data_str = http_build_query($transaction_data_array); $result = curl_work($url, $transaction_data_str); // 背景送出 print_r($result); // 印出結果?> // ====== $result 印出結果樣式如下 ( 僅供樣式參考, 依實際資料為主 ) ====== // Array ( [url] => [sent_parameter] => +MerchantID_= &PostData_=70a61189d7dc0f6abefe7643da144af5a96f5d1290dee28c61 8fdd11e8dcabe5bbd025b6c2d586ce e9fd2af6702f2dad336db419ffa6ca990d10df4d 5f5a580c d a0ea08d1d171187dce545d36e1d02c92f4b1172d9b a0 電子發票加值服務平台 53 輕鬆開立. 批量申報. 省時環保. 成本低廉

55 23b6490b2dfbe82d905a929dddd cf205de3613ddc93bec63f2f4b7d86dcc2180eaf1d600d 049a05bb56f7088b5fb a229ef9969fe7add94562fa83d01b1f917044ede7a099d694ff7b13 c868447faad86c5aef10edc756afc698e2ff2dcaafbf817d2afae62531a50db9d8280d43f2904bbbb1 b5ae7e f3f1a1e83855fa65868fb8d8afd35e348dbb28d0400d0acb50c3be acf ea5248e0b9bf7231d5286f c9636c75ef421ac98f7b70eddb32c 1b f65c a35c42a1e7dbdaceb2bffd89d038c0ce3970b59500b994cd36fae905 75a88dfe188ea8646fab3d26ab720b1dbd7ca3c1b517c75840eebb20e bd28f8faff24c09 da3e7ae1f4cb5dda2095d18a56aa9fa503b761332dc0c0ee9ebfb8f6382ec4f8cf5ddec368bf f7d038e885d0cf582bb e9221fadd51aef987529cb63d03cb63cced0afa6baa5bf0 7d28c2043c6aaeaf2c6cbfd624ecffc527a5fcb48d6790ee7fd37008acfee1d84ca5b51661bfef8fac00 e28d49bb5fc11194fbe2456edf6bbb999a80d4830f01d5cd95cfdb58fa90ee06fe69985ebd39c1075 dd51ad54619d1ea926bdd689aa8128aa021d8ce6b3a574b383b3e e70aa1798d082607ac6 4ae d5f101e04921c2d0352a9f390c bfd90242cf69a0c1ad309b46f3c419db679d 557f3e4f6d549f0b1902ae1a6301f9a6b6b9e6fc2548df9dc8b46c3bd6a85be01dda39a93a5c373a acb5718f71c54a51b62a6e3f8478b50d02ddad5d9cfc293271cdad30e5 [http_status] => 200 [curl_error_no] => 0 [web_info] => {"Status":"SUCCESS","Message":"\u96fb\u5b50\u767c\u7968\u958b\u7acb\u6210\u529f","Resul t":"{\"checkcode\":\"c4156ca c84d929de48f4a2bcd1ff3ed4b97d09a14e2e2143e3 EFD2E\",\"MerchantID\":\" \",\"MerchantOrderNo\":\" \",\"InvoiceNum ber\":\"uy \",\"totalamt\":500,\"invoicetransno\":\" \",\"randomn um\":\"0142\",\"createtime\":\" :54:16\"}"} ) 電子發票加值服務平台 54 輕鬆開立. 批量申報. 省時環保. 成本低廉

56 以下提供.net c# 版本程式語言範例以供參考 : public string EncryptAES256(string source)// 加密 { string ssecretkey = " "; string iv = " "; byte[] sourcebytes = AddPKCS7Padding(Encoding.UTF8.GetBytes(source), 32); var aes = new RijndaelManaged(); aes.key = Encoding.UTF8.GetBytes(sSecretKey); aes.iv = Encoding.UTF8.GetBytes(iv); aes.mode = CipherMode.CBC; aes.padding = PaddingMode.None; ICryptoTransform transform = aes.createencryptor(); return ByteArrayToHex(transform.TransformFinalBlock(sourceBytes, 0, sourcebytes.length)).tolower(); } public string DecryptAES256(string encryptdata)// 解密 { string ssecretkey = " "; string iv = " "; var encryptbytes = HexStringToByteArray(encryptData.ToUpper()); var aes = new RijndaelManaged(); aes.key = Encoding.UTF8.GetBytes(sSecretKey); aes.iv = Encoding.UTF8.GetBytes(iv); aes.mode = CipherMode.CBC; aes.padding = PaddingMode.None; ICryptoTransform transform = aes.createdecryptor(); return Encoding.UTF8.GetString(RemovePKCS7Padding(transform.TransformFinalBlock (encryptbytes, 0, encryptbytes.length))); 電子發票加值服務平台 55 輕鬆開立. 批量申報. 省時環保. 成本低廉

57 } 電子發票技術串接手冊 private static byte[] AddPKCS7Padding(byte[] data, int iblocksize) { int ilength = data.length; byte cpadding = (byte)(iblocksize - (ilength % iblocksize)); var output = new byte[ilength + cpadding]; Buffer.BlockCopy(data, 0, output, 0, ilength); for (var i = ilength; i < output.length; i++) output[i] = (byte)cpadding; return output; } private static byte[] RemovePKCS7Padding(byte[] data) { int ilength = data[data.length - 1]; var output = new byte[data.length - ilength]; Buffer.BlockCopy(data, 0, output, 0, output.length); return output; } private static string ByteArrayToHex(byte[] barray) { char[] c = new char[barray.length * 2]; byte b; for (int i = 0; i < barray.length; ++i) { b = ((byte)(barray[i] >> 4)); c[i * 2] = (char)(b > 9? b + 0x37 : b + 0x30); b = ((byte)(barray[i] & 0xF)); c[i * 2 + 1] = (char)(b > 9? b + 0x37 : b + 0x30); } } return new string(c); private static byte[] HexStringToByteArray(string hexstring) { 電子發票加值服務平台 56 輕鬆開立. 批量申報. 省時環保. 成本低廉

58 int hexstringlength = hexstring.length; byte[] b = new byte[hexstringlength / 2]; for (int i = 0; i < hexstringlength; i += 2) { int topchar = (hexstring[i] > 0x40? hexstring[i] - 0x37 : hexstring[i] - 0x30) << 4; int bottomchar = hexstring[i + 1] > 0x40? hexstring[i + 1] - 0x37 : hexstring[i + 1] - 0x30; b[i / 2] = Convert.ToByte(topChar + bottomchar); } return b; } 電子發票加值服務平台 57 輕鬆開立. 批量申報. 省時環保. 成本低廉

59 附件二 CheckCode 產生規則範例程式 1. 排序欄位字串並用 & 符號串聯起來將回傳資料其中的五個欄位, 分別是 InvoiceTransNo( 智付寶電子發票開立序號 ) MerchantID( 商店代號 ) MerchantOrderNo( 自訂編號 ) RandomNum( 發票防偽隨機碼 ) TotalAmt( 發票金額 ), 且參數需照英文字母 A~Z 排序, 若第一字母相同比較第二字母, 以此類推 2. 將串聯後的字串前後加上商店串接專屬加密 Hash IV 值與商店串接專屬加密 Hash Key 值 3. 將串聯後的字串用 SHA256 壓碼後轉大寫 範例程式 : (1) 排列參數欄位並串聯 InvoiceTransNo= &MerchantID= &MerchantOrder No= &RandomNum=0142&TotalAmt=500 (2) 前後加上商店串接專屬的 Hash IV 及 Hash Key HashIV= &InvoiceTransNo= &MerchantID= &MerchantOrderNo= &RandomNum=0142&TotalAmt=5 00&HashKey=abcdefg (3) 使用 SHA256 壓碼過後並轉大寫 字串結果如下 : C4156CA C84D929DE48F4A2BCD1FF3ED4B97D09A14E2E2143E3E FD2E 電子發票加值服務平台 58 輕鬆開立. 批量申報. 省時環保. 成本低廉

60 以下提供 PHP 版本程式語言範例以供參考 : $check_code = array( "MerchantID" => ' ',// 商店代號 "MerchantOrderNo" => ' ', // 商店自訂單號 ( 訂單編號 ) "InvoiceTransNo" => ' ', // 智付寶電子發票開立序號 "TotalAmt" => '500', // 發票金額 "RandomNum" => '0142', // 發票防偽隨機碼 ); ksort($check_code); $check_str = http_build_query($check_code); $CheckCode = "HashIV= &$check_str&HashKey=abcdefg"; $CheckCode = strtoupper(hash("sha256", $CheckCode)); print_r($checkcode); $CheckCode=C4156CA C84D929DE48F4A2BCD1FF3ED4B97D09A14E2E2 143E3EFD2E 電子發票加值服務平台 59 輕鬆開立. 批量申報. 省時環保. 成本低廉