綠界科技股份有限公司

GreenWorldFinTechServiceCo.
,Ltd.
電子發票B2B介接技術文件V1.
0.
9文件編號:gw_i2002020-09-25綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
I目錄1.
B2B電子發票簡介12.
前置準備事項.
43.
交易對象維護.
64.
發送通知.
105.
開立發票.
146.
開立發票確認.
217.
作廢發票.
258.
作廢發票確認.
309.
退回發票.
3410.
退回發票確認.
3911.
開立折讓發票.
4312.
折讓發票確認.
4913.
作廢折讓發票.
5314.
作廢折讓發票確認.
5815.
查詢發票.
6216.
查詢發票確認.
6917.
查詢作廢發票.
7518.
查詢作廢發票確認.
7819.
查詢退回發票.
8420.
查詢退回發票確認.
8821.
查詢折讓發票.
9222.
查詢折讓發票確認.
9823.
查詢作廢折讓發票.
10224.
查詢作廢折讓發票確認.
106附錄1.
交易狀態代碼表.
110附錄2.
參數加密方式說明.
111綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
IIVersionHistory:VersionDateContentV1.
0.
02020/01/01CreateV1.
0.
12020/02/11修改開立發票、查詢發票與查詢折讓參數Item為Items.
修改附錄2加解密說明V1.
0.
22020/03/11修改Word標題與標籤V1.
0.
32020/03/23優化總流程圖V1.
0.
42020/04/14修改ItemCount與ItemAmount大小V1.
0.
52020/04/24修正存證模式下使用問題V1.
0.
62020/06/02優化文件V1.
0.
72020/07/13修正參數[InvoiceTime]發票開立時間參數說明修正開立發票參數[ItemTax]商品稅額參數說明修正開立發票參數[TaxAmount]稅額合計參數說明修正開立折讓參數[Tax]商品稅額參數說明修正開立折讓參數[TaxAmount]稅額合計參數說明V1.
0.
82020/07/24移除第三章參數使用中統一編號[CustomerIdentifier]V1.
0.
92020/09/25新增Upload_Status狀態綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件1/1111.
B2B電子發票簡介綠界提供買/賣方(皆為營業人)透過介接方式整合B2B電子發票作業功能,支援存證與交換開立模式,B2B存證模式即為類似傳統發票的電子化,將發票資料存證至財政部,B2B交換模式即為仿照目前交付紙本發票的流程,轉換成電子資料交換的流程.
綠界科技電子發票加值中心支援7天內將B2B電子發票上傳至財政部,同時也提供查詢發票的各種狀態,可協助特店將其功能整合至網站(特店系統),讓買/賣方能在線上查詢銷項發票與進項發票.
買/賣方也可透過電子郵件的方式將發票的各種狀態通知寄出給交易相對人.

綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件2/111綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件3/111綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件4/1112.
前置準備事項(1)到「綠界廠商管理後台->系統開發管理->系統介接設定」設定[允許的IP],以方便後續API介接.
(注意事項:基於資訊安全考量,需要填寫特店伺服器的對外IP位址至[允許的IP]欄位).
(2)財政部授權與接收設定授權綠界:使用綠界電子發票加值中心前,請務必至財政部電子發票整合服務平台完成授權綠界.
接收設定:使用綠界電子發票加值中心前,請務必至財政部電子發票整合服務平台完成設定由綠界接收.
(3)字軌與配號設定請依以下步驟:1.
於財政部電子發票整合服務平台取得電子發票專用字軌2.
當您完成授權綠界後,可在綠界科技系統廠商後台(以下簡稱廠商後台)查詢授權期間在財政部取號的結果3.
於廠商後台新增字軌及等候字軌審核4.
字軌通過審核後須啟用字軌;啟用後可暫停或停用發票字軌,但停用後無法再度啟用.

詳細設定資訊請參照https://www.
ecpay.
com.
tw/Content/files/ecpay_056.
pdf(4)測試環境系統介接相關資訊請使用以下資訊在測試環境介接綠界電子發票服務綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件5/111注意事項:(1)以下為測試環境的資訊,請勿對正式環境做處理否則無法正常介接.
(2)更換介接正式環境時,請將以下資訊更換成正式環境中特店所持有的相關資訊,請參考正式環境金鑰取得.

欄位說明欄位內容廠商管理後台測試環境https://vendor-stage.
ecpay.
com.
tw此網站可提供:1.
電子發票查詢2.
發票資料維護與管理介接的HashKeyejCk326UnaZWKisg介接的HashIVq9jcZX8Ib9LM8wYk特店編號(MerchantID)2000132統一編號53538851廠商管理後台登入帳號/密碼StageTest1234/test1234注意事項:接收傳送綠界API通知時,請特店開發人員確認下面事項,以利正常收到綠界發送的各項通知:(1)請確認特店伺服器是否有開通防火牆,以避免回傳通知被防火牆阻擋.
(請參考IPList)(2)呼叫綠界API連接port只提供https(443port)連線方式,並請使用合法的DNS(DomainNameSystem)進行介接.
(3)請確認各項交易參數傳送時是使用HttpPOST方式傳送至綠界API.
(4)請確認特店伺服器URL連接port為http80port與https443port.
(5)請勿將金鑰資訊(HashKey、HashIV)存放或顯示於前端網頁內,如Javascript、html、Css…等,避免金鑰被盜取使用造成損失及交易資料外洩.
(6)回傳網址不支援中文網址,網址參數請使用punycode編碼後的網址,例如中文.
tw改成xn--fiq228c.
tw.
(7)若您要使用電子發票服務,需與綠界提出申請方可使用.
(8)為保障消費者權益與網路交易安全,綠界串接服務支援TLS1.
1以上之加密通訊協定.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件6/1113.
交易對象維護應用場景:B2B電子發票分為交換與存證模式,在串接此規格文件前,必須先用此API設定交易對象(參數[type])為買方/賣方/買賣方、設定開立形式(參數[ExchangeMode])為交換/存證以及新增交易對象的相關資訊.
介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/MaintainMerchantCustomerData正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/MaintainMerchantCustomerData特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3301","Revision":"1.
0.
0"},綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件7/111"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*Action動作String(10)Add:新增Update:編輯Delete:刪除CustomerNumber公司編號String(20)可以與統一編號相同*Identifier統一編號String(8)固定長度為數字8碼、註冊當下所使用的統一編號、設定後不可變更*type交易對象String(1)1:買方2:賣方3:買賣方*CompanyName公司名稱String(60)PersonInCharge公司負責人String(30)*Address公司地址String(100)*TelephoneNumber電話號碼String(30)FacsimileNumber傳真號碼String(30)*TradingSlang交易暗語String(20)*ExchangeMode開立形式String(1)0:存證1:交換存證:綠界會將您的發票資料上傳至財政部,僅適用於銷項發票加值中心無法接收其他營業人開立給您的電子發票交換:綠界會將發票資料上傳至財政部發票傳輸軟體供對方營業人確認及接收請務必先至財政部平台設定由綠界接收*EmailAddress公司信箱String(80)可輸入多組,以半形分號區隔SalesName業務負責人String(30)ContactAddress聯絡地址String(100)Data範例{"MerchantID":"2000132","Action":"Add","Identifier":"53538851","CustomerIdentifier":"53538851","type":"2","CompanyName":"小王電子支付",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件8/111"Address":"台北市內湖區大王路3號","TelephoneNumber":"22222222","TradingSlang":"123","ExchangeMode":"1","EmailAddress":"abc@pay.
com.
tw;def@pay.
com.
tw;ghi@pay.
com.
tw"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3301","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件9/111}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)Data範例{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件10/1114.
發送通知應用場景:B2B電子發票應在任何發票狀態變動時通知交易雙方,特店(營業人)可使用此API來發送電子發票通知(若不撰寫此API,則可透過廠商後台功能處理),綠界將以發票開立時所提供之交易雙方聯絡資料進行通知.
應用流程:(圖)發送發票通知情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/Notify正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/Notify注意事項:(1)測試環境下綠界不會『主動』發送任何通知,需於廠商管理後臺使用『補發通知』,才會寄送通知信到指定信箱.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件11/111特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3302","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceDate發票開立日期String(20)格式為yyyy-mm-dd*InvoiceNumber發票號碼String(10)AllowanceNo折讓單編號String(16)長度固定為16碼*NotifyMail發送電子郵件String(80)1.
僅接受Email的標準格式2.
可輸入多組,以半形分號(;)區隔綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件12/111參數參數名稱型態說明*InvoiceTag發送內容類型String(1)交換模式:1:發票開立2:發票作廢3:發票退回4:開立折讓5:作廢折讓6:開立發票確認7:作廢發票確認8:退回發票確認9:折讓確認10:作廢折讓確認存證模式:1:發票開立2:發票作廢3:發票退回4:開立折讓注意事項:1.
存證模式下,根據財政部文件規定只允許買方開立作廢折讓,因此以賣方角度使用5.
作廢折讓通知,會收到買/賣方錯誤,實際意義為無須再另行通知給作廢折讓開立方.
*Notified發送對象String(1)C:發送通知給客戶M:發送通知給合作特店A:皆發送通知Data範例{"MerchantID":"2000132","InvoiceDate":"2019-09-04","InvoiceNumber":"VG11000000","NotifyMail":"abc5678@gmail.
com;def5678@gmail.
com","InvoiceTag":1,"Notified":"C"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件13/111Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3302","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)Data範例{"RtnCode":1,"RtnMsg":"發送完成"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件14/1115.
開立發票應用場景:交換模式:特店(營業人)傳送開立發票參數給綠界科技加值中心(以下簡稱綠界)後,由綠界暫存相關資料.

綠界會於隔日開立發票後上傳至財政部電子發票整合服務平台,並根據發送通知API設定,通知交易相對人(營業人)電子發票已開立.
(注意事項:需等待交易相對人(營業人)確認後才完成交換,此時發票狀態為已開立成功,屬於有效憑證,只是尚未完成交換,尚未完成交換的發票無法進行折讓、作廢等操作).
存證模式:特店(營業人)在與交易相對人(營業人)達成合意後,特店(營業人)傳送開立發票參數給綠界,由綠界暫存相關資料.
綠界會於隔日開立發票後上傳至財政部電子發票整合服務平台,並根據發送通知API設定,通知交易相對人(營業人)電子發票已開立.
應用流程:(圖)開立發票(交換模式)情境流程圖處理角色流程名稱處理說明特店1.
發送開立發票參數特店呼叫開立發票API傳送發票開立參數.
綠界2.
回傳開立發票結果接收並解析特店傳送過來的電子發票開立資料.
確立發票開立資料無誤後,於綠界電子發票系統產生特店的電子發票開立資料.
綠界3.
上傳財政部開立成功後,綠界會把開立成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
發票開立通知上傳成功後,綠界會通知交易相對人電子發票已完成開立的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件15/111(圖)開立發票(存證模式)情境流程圖處理角色流程名稱處理說明特店1.
達成交換合意特店與交易相對人對於發票開立內容達成合意特店2.
發送開立發票參數特店呼叫開立發票API傳送發票開立參數.
綠界3.
回傳開立發票結果接收並解析特店傳送過來的電子發票開立資料.
確立發票開立資料無誤後,於綠界電子發票系統產生特店的電子發票開立資料.
綠界4.
上傳財政部開立成功後,綠界會把開立成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人5.
發票開立通知上傳成功後,綠界會通知交易相對人電子發票已完成開立的訊息.
介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/Issue正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/Issue特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件16/111參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3303","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*RelateNumber廠商自訂編號String(20)均為唯一值不可重覆使用InvoiceTime發票開立時間String(20)格式為yyyy-mm-ddhh:mm:ss1.
參數有值時,僅接受過去6天內日期,並注意順時順號2.
建議不帶值,系統會自動開立當下日期*CustomerIdentifier買方統編String(8)CustomerEmail買方電子信箱String(80)1.
僅接受Email的標準格式.
2.
多組Email請以半形分號區隔,未帶值時自動帶入交易對象維護API設定的資料ClearanceMark通關方式註記String(1)當課稅類別[TaxType]為2(零稅率)時,則該參數請帶1(非經海關出口)或2(經海關出口)*InvType字軌類別String(2)07(一般稅額計算之電子發票)、08(特種稅額計算之電子發票)*TaxType課稅別String(1)1.
當字軌類別[InvType]為07(一般稅額計算之電子發票)時,則該參數請帶1(一般應稅)、2(零稅率)或3(免稅)2.
當字軌類別[InvType]為08(特種稅額計算之電子發票)時,則該參數請帶4(特種應稅)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件17/111參數參數名稱型態說明TaxRate稅率Number1.
當課稅類別[TaxType]為1(一般應稅)時,則該參數非必填(系統會帶0.
05)2.
當課稅類別[TaxType]為2(零稅率)時,則該參數非必填(系統會帶0)3.
當課稅類別[TaxType]為3(免稅)時,則該參數非必填(系統會帶0)4.
當發票類別[TaxType]為4(特種應稅)時,則該參數必填(請帶0.
01~0.
99)*Items傳入資料*ItemSeq明細排列序號Int1.
請帶1~999的整數值2.
商品排序不可重複*ItemName商品名稱String(256)*ItemCount商品數量Number支援整數最多8位,小數2位ItemWord商品單位String(6)商品單位最多是6碼*ItemPrice商品價格Number支援整數最多8位,小數7位*ItemAmount商品合計Number1.
支援整數最多12位,小數7位2.
定義【商品數量[ItemCount]*商品價格[ItemPrice]】=A,則商品合計的值與A四捨五入後的值,差距不可大於1ItemTax商品稅額Int1.
須為整數2.
若商品稅額[ItemTax]有值,定義【商品合計[ItemAmount]*稅率[TaxRate]】=B,則商品稅額的值與B四捨五入後的值,差距不可大於1財政部無提供此參數格式,此處提供營業人檢核營業稅額[TaxAmount]用,不會上傳.

ItemRemark商品備註String(200)*SalesAmount銷售額合計Int1.
請帶整數,不可有小數點,不可為0元2.
需等於商品金額[ItemAmount]加總後四捨五入至整數的值*TaxAmount稅額合計Int1.
請帶整數,不可有小數點.
2.
定義【銷售額合計[SalesAmount]乘以稅率[TaxRate]後再四捨五入至整數】為C,則稅額合計[TaxAmount]的值與C的差距不可大於2*TotalAmount發票金額Int1.
請帶整數,不可有小數點,不可為0元2.
需等於銷售額合計[SalesAmount]與稅額合計[TaxAmount]相加InvoiceRemark發票備註String(200)Data範例{"MerchantID":"2000132","RelateNumber":"20190922000000003",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件18/111"InvoiceTime":"2019/09/2200:00:00","CustomerIdentifier":"23165448","CustomerEmail":"","ClearanceMark":"1","InvType":"07","TaxType":1,"TaxRate":0.
05,"SalesAmount":100,"TaxAmount":5,"TotalAmount":105,"InvoiceRemark":"發票備註","Items":[{"ItemSeq":1,"ItemName":"item01","ItemCount":1,"ItemWord":"件","ItemPrice":50,"ItemAmount":50,"ItemTax":2,"ItemRemark":"item01_desc"},{"ItemSeq":2,"ItemName":"item02","ItemCount":1,"ItemWord":"個","ItemPrice":20,"ItemAmount":20,"ItemTax":1,"ItemRemark":"item02_desc"},{"ItemSeq":3,"ItemName":"item03","ItemCount":3,"ItemWord":"粒","ItemPrice":10,綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件19/111"ItemAmount":30,"ItemTax":2,"ItemRemark":"item03_desc"}]}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3303","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件20/111}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)InvoiceNumber發票號碼String(10)若開立成功,則會回傳一組發票號碼;若開立失敗,則會回傳空值.
Data範例{"RtnCode":1,"RtnMsg":"新增成功","InvoiceNumber":"VG11000002"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件21/1116.
開立發票確認應用場景:交換模式:特店(營業人)收到開立發票訊息通知後,傳送開立發票確認參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界會於隔日將開立發票確認訊息後上傳至財政部電子發票整合服務平台,完成發票開立交換.
並根據發送通知API設定,通知交易相對人(營業人)電子發票開立已完成確認.
應用流程:(圖)開立發票確認情境流程圖處理角色流程名稱處理說明特店1.
發送開立發票確認參數特店呼叫開立發票確認API傳送發票開立確認參數.
綠界2.
回傳開立發票確認結果接收並解析特店傳送過來的電子發票開立確認資料.
確定開立發票確認無誤後,於綠界電子發票系統產生特店的電子發票開立確認資料.
綠界3.
上傳財政部開立發票確認成功後,綠界會把確認成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
發票開立通知上傳成功後,綠界會通知交易相對人電子發票已確認成功的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件22/111介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/IssueConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/IssueConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3304","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceNumber發票號碼String(10)InvoiceDate發票開立日String(20)格式為yyyy-mm-dd綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件23/111參數參數名稱型態說明期Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000002","InvoiceDate":"2019/09/22","Remark":""}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3304","Revision":"1.
0.
0"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件24/111},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)範例:{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件25/1117.
作廢發票應用場景:交換模式:交易雙方因發生銷貨退回或發票內容開立錯誤,由特店(營業人)傳送作廢發票參數給綠界科技加值中心(以下簡稱綠界)後,由綠界暫存相關資料.
綠界會於隔日將發票作廢後上傳至財政部電子發票整合服務平台,同時根據發送通知API設定,通知交易相對人(營業人)電子發票已作廢.
(注意事項:根據財政部規定,需等待交易相對人(營業人)確認後才完成交換,否則不屬於有效憑證).

存證模式:交易雙方因發生銷貨退回或發票內容開立錯誤,特店(營業人)在與交易相對人(營業人)達成合意後,特店(營業人)傳送作廢發票參數給綠界,由綠界暫存相關資料.
綠界會於隔日將發票作廢後上傳財政部電子發票整合服務平台,並根據發送通知API設定,通知交易相對人(營業人)電子發票已作廢.
應用流程:(圖)作廢發票(交換模式)情境流程圖綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件26/111處理角色流程名稱處理說明特店1.
發送作廢發票參數特店呼叫作廢發票API傳送發票作廢參數.
綠界2.
回傳作廢結果接收並解析特店傳送過來的電子發票作廢資料.
確定發票作廢資料無誤後,於綠界電子發票系統產生特店的發票作廢資料.
綠界3.
上傳財政部作廢成功後,綠界會把作廢成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
發票作廢通知上傳成功後,綠界會通知交易相對人電子發票已作廢的訊息.
(圖)作廢發票(存證模式)情境流程圖處理角色流程名稱處理說明特店1.
達成交換合意特店與交易相對人對於發票作廢達成合意特店2.
發送作廢發票參數特店呼叫作廢發票API傳送發票作廢參數.
綠界3.
回傳作廢結果接收並解析特店傳送過來的電子發票作廢資料.
確定發票作廢資料無誤後,於綠界電子發票系統產生特店的發票作廢資料.
綠界4.
上傳財政部作廢成功後,綠界會把作廢成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人5.
發票作廢通知上傳成功後,綠界會通知交易相對人電子發票已作廢的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件27/111介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/Invalid正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/Invalid特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3305","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceNumber發票號碼String(10)*InvoiceDate發票開立日String(20)格式為yyyy-mm-dd綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件28/111參數參數名稱型態說明期*Reason作廢原因String(20)Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000002","InvoiceDate":"2019-09-23","Reason":"Invalid_Reason","Remark":"Seller_Invalid_Remark",}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件29/111"RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3305","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)範例:{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件30/1118.
作廢發票確認應用場景:交換模式:交易雙方因發生銷貨退回或發票內容開立錯誤,特店(營業人)收到作廢發票訊息通知後,傳送作廢發票確認參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將此作廢發票確認訊息上傳至財政部電子發票整合服務平台,完成發票作廢交換.
並根據發送通知API設定,通知交易相對人(營業人)電子發票作廢已完成確認.
應用流程:(圖)作廢發票確認情境流程圖處理角色流程名稱處理說明特店1.
發送作廢發票確認參數特店呼叫作廢發票確認API傳送發票作廢確認參數.
綠界2.
回傳作廢確認結果接收並解析特店傳送過來的電子發票作廢確認資料.
確定發票作廢確認資料無誤後,於綠界電子發票系統產生特店的發票作廢確認資料.
綠界3.
上傳財政部作廢發票確認成功後,綠界會把作廢確認成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
發票作廢確認通知上傳成功後,綠界會通知交易相對人電子發票已作廢確認的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件31/111介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/InvalidConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/InvalidConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3306","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceNumber發票號碼String(10)*InvoiceDate發票開立日String(20)格式為yyyy-mm-dd綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件32/111參數參數名稱型態說明期Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000002","InvoiceDate":"2019-09-22","Remark":"Seller_Invalid_Remark"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3306","Revision":"1.
0.
0"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件33/111},"TransCode":1,"TransMsg":"","Data":"…"}綠界回傳參數說明:參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)範例:{"RtnCode":"1","RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件34/1119.
退回發票應用場景:交換模式:特店(營業人)收到發票訊息發現內容錯誤(如數量、單價或品名錯誤),拒絕確認此發票訊息.
特店(營業人)傳送退回發票參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將發票退回資料上傳至財政部電子發票整合服務平台,同時根據發送通知API設定,通知交易相對人(營業人)電子發票已退回.
存證模式:特店(營業人)收到發票訊息發現內容錯誤(如數量、單價或品名錯誤),拒絕接受此發票訊息.
特店(營業人)在與交易相對人(營業人)達成合意後,特店(營業人)傳送退回發票參數給綠界,由綠界暫存相關資料.
綠界於隔天將發票退回資料上傳至財政部電子發票整合服務平台,並根據發送通知API設定,通知交易相對人(營業人)電子發票已退回.
應用流程:(圖)退回發票(交換模式)情境流程圖處理角色流程名稱處理說明特店1.
發送退回發票參數特店呼叫退回發票API傳送發票退回參數.
綠界2.
回傳退回結果接收並解析特店傳送過來的電子發票退回資料.
確定發票退回資料無誤後,於綠界電子發票系統產生特店的發票退回資料.
綠界3.
上傳財政部退回成功後,綠界會把退回成功的發票資料上傳財政部電子發票整合服務平台.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件35/111交易相對人4.
發票退回通知上傳成功後,綠界會通知交易相對人電子發票已退回的訊息.
(圖)退回發票(存證模式)情境流程圖處理角色流程名稱處理說明特店1.
達成交換合意特店與交易相對人對於發票退回達成合意特店2.
發送退回發票參數特店呼叫退回發票API傳送發票退回參數.
綠界3.
回傳退回結果接收並解析特店傳送過來的電子發票退回資料.
確定發票退回資料無誤後,於綠界電子發票系統產生特店的發票退回資料.
綠界4.
上傳財政部退回成功後,綠界會把退回成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人5.
發票退回通知上傳成功後,綠界會通知交易相對人電子發票已退回的訊息.
介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/Reject正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/Reject特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件36/111接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3307","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceNumber發票號碼String(10)*InvoiceDate發票開立日期String(20)格式為yyyy-mm-dd*Reason退回原因String(20)Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000001","InvoiceDate":"2019-09-22","Reason":"Reject_Reason","Remark":"Buyer_Reject_Remark"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件37/111}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3307","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件38/111參數參數名稱型態說明RtnMsg回應訊息String(200)範例:{"RtnCode":"1","RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件39/11110.
退回發票確認應用場景:交換模式:交易雙方因發生發票訊息內容錯誤(如數量、單價或品名錯誤),特店(營業人)收到退回發票訊息通知後,傳送退回發票確認參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將此退回發票確認訊息上傳至財政部電子發票整合服務平台,完成發票退回交換.
並根據發送通知API設定,通知交易相對人(營業人)電子發票退回已完成確認.
應用流程:(圖)退回發票確認情境流程圖處理角色流程名稱處理說明特店1.
發送退回發票確認參數特店呼叫退回發票確認API傳送發票退回確認參數.
綠界2.
回傳退回確認結果接收並解析特店傳送過來的電子發票退回確認資料.
確定發票退回確認資料無誤後,於綠界電子發票系統產生特店的發票退回確認資料.
綠界3.
上傳財政部退回確認成功後,綠界會把退回確認成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
發票退回確認通知上傳成功後,綠界會通知交易相對人電子發票已退回確認的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件40/111介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/RejectConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/RejectConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3308","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceNumber發票號碼String(10)*InvoiceDate發票開立日String(20)格式為yyyy-mm-dd綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件41/111參數參數名稱型態說明期Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000001","InvoiceDate":"2019-09-22","Remark":"Buyer_Reject_Remark",}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3308","Revision":"1.
0.
0"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件42/111},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)Data範例{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件43/11111.
開立折讓發票應用場景:交換模式:買方/賣方開立折讓單:特店(營業人)收到發票訊息後,發生銷貨退回、調換貨物或折讓等情事.
特店(營業人)傳送折讓發票參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將發票折讓並上傳至財政部電子發票整合服務平台,同時根據發送通知API設定,通知交易相對人(營業人)電子發票已折讓.
注意事項:1.
由賣方開立折讓的目的是為了避免買方開立折讓單填寫2.
需等待交易相對人(營業人)確認後才完成交換,此時發票狀態為已折讓成功,屬於有效憑證,只是尚未完成交換.
存證模式:特店(營業人)開立發票訊息後,發生銷貨退回、調換貨物或折讓等情事.
特店(營業人)在與交易相對人(營業人)達成合意後,特店(營業人)傳送折讓發票參數給綠界,由綠界暫存相關資料.
綠界於隔天將發票折讓並上傳至財政部電子發票整合服務平台,並根據發送通知API設定,通知交易相對人(營業人)電子發票已折讓.
應用流程:(圖)開立折讓(交換模式)情境流程圖處理角色流程名稱處理說明特店1.
發送開立折讓參數特店呼叫開立折讓API傳送開立發票折讓參數.
綠界2.
回傳開立折讓結果接收並解析特店傳送過來的電子發票開立折讓資料.
確定開立折讓資料無誤後,於綠界電子發票系統產生綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件44/111特店的發票開立折讓資料.
綠界3.
上傳財政部開立折讓成功後,綠界會把開立折讓成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
折讓開立通知上傳成功後,綠界會通知交易相對人電子發票已成功開立折讓的訊息.
(圖)開立折讓(存證模式)情境流程圖處理角色流程名稱處理說明特店1.
達成交換合意特店與交易相對人對於發票開立折讓達成合意特店2.
發送開立折讓參數特店呼叫開立折讓API傳送開立發票折讓參數.
綠界3.
回傳開立折讓結果接收並解析特店傳送過來的電子發票開立折讓資料.
確定開立折讓資料無誤後,於綠界電子發票系統產生特店的電子發票開立折讓資料.
綠界4.
上傳財政部開立折讓成功後,綠界會把開立折讓成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人5.
折讓開立通知上傳成功後,綠界會通知交易相對人電子發票已成功開立折讓的訊息.
介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/Allowance正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/Allowance特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件45/1112.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3309","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)AllowanceDate折讓單時間String(20)格式為yyyy-mm-ddhh:mm:ss參數有值時,僅接受6天內日期,沒有值則會開立當下日期.
CustomerEmail買方電子信箱String(80)1.
僅接受Email的標準格式.
2.
多組Email請以半形分號區隔,未帶值時將自動帶入交易對象維護API設定的資料.
*TaxAmount營業稅額Int1.
請帶整數,不可有小數點.
2.
定義【折讓金額總計(未稅)[TotalAmount]乘以開立發票API的稅率[TaxRate]後再四捨五入至整數】為C,則營業稅額[TaxAmount]的值與綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件46/111參數參數名稱型態說明C的差距不可大於2*TotalAmount折讓金額總計(未稅)Int1.
請帶整數,不可有小數點,金額不可為0元.
2.
需等於每張發票折讓的商品金額[ItemAmount]加總後四捨五入至整數的值*Details傳入資料B2B可以在一張折讓單上同時折讓多筆發票,以下是每項商品的折讓明細*OriginalInvoiceNumber原發票號碼String(10)*OriginalInvoiceDate原發票日期String(20)格式為yyyy-mm-dd*OriginalSequenceNumber原發票號碼排序Int1.
請帶1~999的整數值2.
商品排序需與原發票開立時的商品排序相同*ItemName商品名稱String(256)折讓的商品名稱[ItemName],需與原發票號碼排序的對應商品名稱相同*ItemCount商品數量Number1.
支援整數最多8位,小數2位2.
折讓的商品數量[ItemCount],不可超過原發票商品開立的數量*ItemPrice商品價格Number1.
支援整數最多8位,小數7位2.
折讓的商品價格[ItemPrice],不可超過原發票商品開立的價格*ItemAmount商品合計Number1.
支援整數最多12位,小數7位2.
折讓的商品合計[ItemAmount],定義【折讓的商品數量[ItemCount]*折讓的商品價格[ItemPrice]】=A,則折讓的商品合計[ItemAmount]與A的差距不可大於1Tax商品稅額Int1.
須為整數2.
折讓的商品稅額[Tax],定義【折讓的商品合計[ItemAmount]*開立發票API的稅率[TaxRate]】=B,則折讓的商品稅額[Tax]與B四捨五入至整數的差距不可大於1Data範例{"MerchantID":"2000132","AllowanceDate":"2019-09-2400:00:00","CustomerEmail":"abc1234@gmail.
com","TaxAmount":1,"TotalAmount":24,"Details":[{"OriginalInvoiceNumber":"VG11000003",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件47/111"OriginalInvoiceDate":"2019-09-24","OriginalSequenceNumber":1,"ItemName":"小浣熊","ItemCount":2,"ItemPrice":12,"ItemAmount":24,"Tax":1}]}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3309","Revision":"1.
0.
0"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件48/111},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)AllowanceNo綠界折讓編號String(16)若開立成功,則會回傳一組綠界折讓編號;若開立失敗,則會回傳空值.
AllowanceNumber折讓單號碼String(16)廠商自訂折讓單號碼Data範例{"RtnCode":1,"RtnMsg":"","AllowanceNo":"1909241702402030","AllowanceNumber":"1909241702402030"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件49/11112.
折讓發票確認應用情景:交換模式:買方/賣方折讓確認交易雙方因發生銷貨退回、調換貨物或折讓等情事,特店(營業人)收到折讓發票訊息通知後,傳送折讓發票確認參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將此折讓發票確認訊息上傳至財政部電子發票整合服務平台,完成發票折讓交換.
並根據發送通知API設定,通知交易相對人(營業人)電子發票折讓已完成確認.
應用流程:(圖)折讓確認情境流程圖處理角色流程名稱處理說明特店1.
發送折讓確認參數特店呼叫折讓確認API傳送發票折讓確認參數.
綠界2.
回傳折讓確認結果接收並解析特店傳送過來的電子發票折讓確認資料.
確定折讓確認資料無誤後,於綠界電子發票系統產生特店的發票折讓確認資料.
綠界3.
上傳財政部折讓確認成功後,綠界會把折讓確認成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人4.
折讓確認通知上傳成功後,綠界會通知交易相對人電子發票已成功折讓確認的訊息.
介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/AllowanceConfirm綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件50/111正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/AllowanceConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330A","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼Remark備註String(200)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件51/111範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030","Remark":"Allowance_Confirm_Remark"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)時間戳記,格式為UnixtimestampRqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330A","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件52/111範例:{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件53/11113.
作廢折讓發票應用情景:交換模式於發票開立後發生銷貨退回、調換貨物或折讓等情事,特店(營業人)開立折讓單後,因發生內容開立錯誤,營業人(特店)可使用此功能將作廢折讓參數傳送至綠界科技加值中心(以下簡稱綠界),由綠界暫存作廢折讓資料.
綠界於隔日將作廢折讓訊息上傳至財政部電子發票整合服務平台,同時根據發送通知API設定,通知交易相對人(營業人)電子發票折讓部分已作廢(不是整張發票作廢).

注意事項:1.
根據財政部規定,需等待交易相對人(營業人)確認後才完成交換,否則不屬於有效憑證.

2.
根據財政部規定,只有買方可以上傳作廢折讓發票.
存證模式:於發票開立後發生銷貨退回、調換貨物或折讓等情事,特店(營業人)開立折讓單後,因發生內容開立錯誤,特店(營業人)在與交易相對人(營業人)達成合意後,特店(營業人)可使用此功能將作廢折讓參數傳送至綠界,由綠界更新作廢折讓資料.
應用流程:(圖)作廢折讓(交換模式)情境流程圖處理角色流程名稱處理說明特店1.
作廢折讓參數特店呼叫作廢折讓API傳送作廢折讓參數.
綠界2.
回傳作廢折讓結果接收並解析特店傳送過來的電子發票作廢折讓資料.
確立作廢折讓資料無誤後,於綠界電子發票系統產生特店的發票作廢折讓資料.
綠界3.
上傳財政部作廢折讓成功後,綠界會把作廢折讓成功的資料上傳綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件54/111財政部電子發票平台.
交易相對人4.
作廢折讓成功通知上傳成功後,綠界會通知買家電子發票折讓已作廢的訊息.
(圖)作廢折讓(存證模式)情境流程圖處理角色流程名稱處理說明特店1.
達成交換合意特店與交易相對人對於發票開立折讓達成合意特店2.
發送作廢折讓參數特店呼叫作廢折讓API傳送作廢折讓參數.
綠界3.
回傳開立折讓結果接收並解析特店傳送過來的電子發票作廢折讓資料.
確定作廢折讓資料無誤後,於綠界電子發票系統產生特店的電子發票作廢折讓資料.
綠界4.
上傳財政部作廢折讓成功後,綠界會把作廢折讓成功的發票資料上傳財政部電子發票整合服務平台.
交易相對人5.
作廢折讓成功通知上傳成功後,綠界會通知交易相對人電子發票已成功作廢折讓的訊息.
介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/CancelAllowance正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/CancelAllowance綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件55/111特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330B","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼*Reason折讓作廢原因String(20)Remark備註String(200)範例:綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件56/111{"MerchantID":"2000132","AllowanceNo":"1909241702402030","Reason":"Cancel_Allowance_Reason","Remark":"Cancel_Allowance_Reamrk"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330B","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件57/111}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)範例:{"RtnCode":1,"RtnMsg":"新增成功"}注意事項:(1)發票若已被折讓過,無法直接作廢發票,請先確認該發票所開立的折讓單是否全部已作廢.

綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件58/11114.
作廢折讓發票確認應用情景:交換模式:買方/賣方於發票開立後發生銷貨退回、調換貨物或折讓等情事,但開立折讓單後,發生內容開立錯誤而進行作廢折讓,特店(營業人)收到作廢折讓訊息通知後,傳送作廢折讓確認參數給綠界科技加值中心(以下簡稱綠界),由綠界暫存相關資料.
綠界於隔日將此作廢折讓確認訊息上傳至財政部電子發票整合服務平台,完成發票作廢折讓交換.
並根據發送通知API設定,通知交易相對人(營業人)電子發票作廢折讓已完成確認.
應用流程:(圖)作廢折讓確認情境流程圖處理角色流程名稱處理說明特店1.
發送作廢折讓確認參數特店呼叫作廢折讓確認API傳送作廢折讓確認參數.
綠界2.
回傳作廢折讓確認結果接收並解析特店傳送過來的電子發票作廢折讓確認資料.
確定作廢折讓確認無誤後,於綠界電子發票系統產生特店的發票作廢折讓確認資料.
綠界3.
上傳財政部作廢成功後,綠界會把作廢成功的發票資料上傳財政部電子發票平台.
交易相對人4.
發票作廢折讓確認通知上傳成功後,綠界會通知交易相對人電子發票已作廢折讓確認的訊息.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件59/111介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/CancelAllowanceConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/CancelAllowanceConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330C","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件60/111參數參數名稱型態說明Remark備註String(200)範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030","Remark":"Cancel_Allowance_Reamrk"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330C","Revision":"1.
0.
0"},"TransCode":1,綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件61/111"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)範例:{"RtnCode":1,"RtnMsg":"新增成功"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件62/11115.
查詢發票應用場景:特店(營業人)可使用此API查詢已開立發票資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票機制整合至營業人網站,提供快速查詢服務.
應用流程:(圖)查詢發票情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetIssue正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetIssue特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件63/111API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330D","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店開給交易相對人的發票明細)1:進項發票(查詢交易相對人開給特店的發票明細)*InvoiceNumber發票號碼String(10)*InvoiceDate發票開立日期String(20)格式為yyyy-mm-ddRelateNumber自訂編號String(20)均為唯一值不可重覆使用範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602"}綠界Response回傳參數說明(Json格式)::參數參數名稱型態說明綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件64/111MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330D","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件65/111"RtnMsg":"查詢成功","RtnData":"…"}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)InvoiceDate發票開立日期String(20)格式為yyyy-mm-ddRelateNumber自訂編號String(20)均為唯一值不可重覆使用Buyer_Identifier買方統編String(8)Buyer_Name買方名稱String(60)Buyer_Address買方地址String(100)Buyer_TelephoneNumber買方電話String(26)Buyer_EmailAddress買方電子信箱String(80)Buyer_FacsimileNumber買方傳真號碼String(26)Seller_Identifier賣方統編String(8)若發票種類[InvoiceCategory]=0,此欄為空值Seller_Name賣方名稱String(60)若發票種類[InvoiceCategory]=0,此欄為空值Seller_Address賣方地址String(100)若發票種類[InvoiceCategory]=0,此欄為空值Seller_TelephoneNumber賣方電話String(26)若發票種類[InvoiceCategory]=0,此欄為空值Seller_EmailAddress賣方電子信箱String(80)若發票種類[InvoiceCategory]=0,此欄為空值Seller_FacsimileNumber賣方傳真號碼String(26)若發票種類[InvoiceCategory]=0,此欄為空值CustomsClearanceMark通關方式註記String(1)1:非經海關出口2:經海關出口InvoiceType字軌類別String(1)07:一般稅額計算08:特種稅額計算TaxType課稅別Int1.
當字軌類別[InvType]為07(一般稅額計算之電子發票)時,則該參數請帶1(一般應稅)、2(零稅率)或3(免稅)2.
當字軌類別[InvType]為08(特種稅額計算之電子發票)時,則該參數請帶4(特種應稅)TaxRate稅率Number1.
當課稅類別[TaxType]為1(一般應稅)時,則該參數非必填綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件66/111參數參數名稱型態說明(系統會帶0.
05)2.
當課稅類別[TaxType]為2(零稅率)時,則該參數非必填(系統會帶0)3.
當課稅類別[TaxType]為3(免稅)時,則該參數非必填(系統會帶0)4.
當發票類別[TaxType]為4(特種應稅)時,則該參數必填(請帶0.
01~0.
99)SalesAmount銷售額合計Int1.
請帶整數,不可有小數點,不可為0元2.
需等於商品金額[ItemAmount]加總後四捨五入至整數的值TaxAmount營業稅額Int1.
請帶整數,不可有小數點.
TotalAmount發票金額Int1.
請帶整數,不可有小數點,不可為0元2.
需等於銷售額合計[SalesAmount]與稅額合計[TaxAmount]相加IP發票開立IPString(15)IPV4CreateDate建檔時間String(20)格式為yyyy-mm-ddhh:mm:ssIssue_Status發票開立狀態String(1)0:發票退回1:發票開立Upload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=1,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)若發票種類[InvoiceCategory]=1,此欄為nullConfirmDate發票確認時間String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullInvalid_Status發票作廢狀態String(1)0:未作廢1:已作廢ExchangeMode發票開立方式String(1)0:存證1.
交換ExchangeStatus發票確認狀態String(1)若為空值表示未設定0:未確認1:已確認BalanceAmount剩餘可折讓金額NumberMainRemark發票備註String(200)Items傳入資料ItemSeq商品明細排列序號String(3)1.
請帶1~999的整數值2.
商品排序不可重複ItemName商品名稱String(256)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件67/111參數參數名稱型態說明ItemCount商品數量Number支援整數最多8位,小數2位ItemWord商品單位String(6)商品單位最多是6碼ItemPrice商品價格Number支援整數最多8位,小數7位ItemAmount商品合計Number1.
支援整數最多12位,小數7位2.
設【商品數量[ItemCount]*商品價格[ItemPrice]】=A,則商品合計的值與A四捨五入後的值,差距不可大於1ItemTax商品稅額Int1.
須為整數2.
若商品稅額[ItemTax]有值,定義【商品合計[ItemAmount]*稅率[TaxRate]】=B,則商品稅額[ItemTax]的值與B四捨五入後的值,差距不可大於1財政部無提供此參數格式,此處提供營業人檢核營業稅額[TaxAmount]用,不會上傳.
ItemRemark商品備註String(200)範例:{"MerchantID":"2000132","InvoiceDate":"2019-08-31","RelateNumber":"2019081602","Buyer_Identifier":"11456006","Buyer_Name":"黃黑糖的店","Buyer_Address":"200基隆市仁愛區200基隆市仁愛區200基隆市仁愛區","Buyer_TelephoneNumber":"02-12344321","Buyer_EmailAddress":"abc@sunup.
net","Buyer_FacsimileNumber":"","CustomsClearanceMark":"","InvoiceType":"07","TaxType":1,"TaxRate":0.
05,"SalesAmount":952,"TaxAmount":48,"TotalAmount":1000,"IP":2130706433,"CreateDate":"2019-09-0313:57:07","Issue_Status":"1","Invalid_Status":"0","IP":"4000003",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件68/111"Upload_Status":"1","Upload_Date":"2019-09-0314:57:07","ConfirmDate":"2019-09-0315:57:07","ExchangeStatus":"1","ExchangeMode":"0","BalanceAmount":952,"MainRemark":"","Items":[{"ItemSeq":1,"ItemName":"手機測試","ItemCount":1,"ItemWord":"支","ItemPrice":952,"ItemAmount":952,"ItemTax":48,"ItemRemark":""}]}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件69/11116.
查詢發票確認應用場景:特店(營業人)可使用此API查詢已開立發票是否完成確認資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票確認機制整合至特店(營業人)網站,提供快速查詢服務.
應用流程:(圖)查詢發票確認情境流程圖介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetIssueConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetIssueConfirm綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件70/111特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330E","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店開給交易相對人的發票是否已確認)1:進項發票(查詢交易相對人開給特店的發票是否已確認)InvoiceNumber發票號碼String(10)當自訂編號[RelateNumber]為空值時,此欄需有值.
InvoiceDate發票開立日期String(20)1.
格式為yyyy-mm-dd2.
當發票號碼[InvoiceNumber]有值時,此欄必填.
RelateNumber自訂編號String(20)當發票號碼[InvoiceNumber]為空值時,此欄需有值.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件71/111參數參數名稱型態說明Seller_Identifier賣家統一編號String(8)Buyer_Identifier買家統一編號String(8)InvoiceDateBegin發票開立日期起始日String(20)格式為yyyy-mm-ddInvoiceDateEnd發票開立日期結束日String(20)格式為yyyy-mm-ddInvoiceNumberBegin發票號碼起始號碼String(8)不包含字軌(例:00000000)InvoiceNumberEnd發票號碼結束號碼String(8)不包含字軌(例:00000000)Issue_Status發票狀態String(1)1:發票開立0:發票退回Invalid_Status作廢狀態String(1)1:已作廢0:未作廢ExchangeMode上傳模式String(1)1:交換0:存證ExchangeStatus發票開立交換進度String(1)若為空值表示未設定1:完成,當ExchangeMode=00:開立等待確認1:接收開立確認,當ExchangeMode=1Upload_Status上傳狀態String(1)0:未上傳1:已上傳2:上傳失敗範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602","Seller_Identifier":"","Buyer_Identifier":"","InvoiceDateBeign":"","InvoiceDateEnd":"","InvoiceNumberBegin":"","InvoiceNumberEnd":"","Issue_Status":"","Invalid_Status":"",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件72/111"ExchangeMode":"","ExchangeStatus":"","Upload_Status":""}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330E","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件73/111Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)InvoiceDate發票開立日期String(20)格式為yyyy-mm-ddBuyer_Identifier買方統編String(8)Seller_Identifier賣方統編String(8)ConfirmDate確認日期String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullUpload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=0,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)若發票種類[InvoiceCategory]=0,此欄為nullConfirmRemark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","Buyer_Identifier":"11456006","Seller_Identifier":"","ConfirmDate":"2019-09-02","Upload_Status":"",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件74/111"Upload_Date":"2019-09-01","ConfirmRemark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件75/11117.
查詢作廢發票應用場景:特店(營業人)可使用此API查詢已作廢發票資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票作廢機制整合至特店(營業人)網站,提供快速查詢服務.

應用流程:(圖)查詢作廢發票情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetInvalid正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetInvalid特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件76/111合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330F","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店開給交易相對人的作廢發票明細)1:進項發票(查詢交易相對人開給特店的作廢發票明細)InvoiceNumber發票號碼String(10)當自訂編號[RelateNumber]為空值時,此欄需有值.
InvoiceDate發票開立日期String(20)1.
格式為yyyy-mm-dd2.
當發票號碼[InvoiceNumber]有值時,此欄必填.
RelateNumber自訂編號String(20)當發票號碼[InvoiceNumber]為空值時,此欄需有值.
範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件77/111綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C330F","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件78/111範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)BuyerId買方統編String(8)SellerId賣方統編String(8)CancelDate作廢日期String(20)格式為yyyy-mm-ddCancelTime作廢時間String(10)CancelReason作廢原因String(20)Upload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=1,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)若發票種類[InvoiceCategory]=1,此欄為nullConfirmDate作廢確認日期String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullExchangeStatus作廢確認狀態String(1)若為空值表示未設定0:未確認1:已確認Remark備註String(200)範例:"MerchantID":"2000132","InvoiceNumber":"VG11000002","BuyerId":"23165448","SellerId":"","CancelDate":"2019-09-23","CancelTime":"13:39:24","CancelReason":"","Upload_Status":"","Upload_Date":"2019-09-24",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件79/111"ConfirmDate":"2019-09-25","ExchangeStatus":"1","Remark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件80/11118.
查詢作廢發票確認應用場景:特店(營業人)可使用此API查詢已作廢發票是否完成確認資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票作廢確認機制整合至特定(營業人)網站,提供快速查詢服務.
應用流程:(圖)查詢作廢確認情境流程圖介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetInvalidConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetInvalidConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件81/111合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3311","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店提供給交易相對人的作廢發票是否已確認)1:進項發票(查詢交易相對人提供給特店的作廢發票是否已確認)InvoiceNumber發票號碼String(10)當自訂編號[RelateNumber]為空值時,此欄需有值.
InvoiceDate發票開立日期String(20)1.
格式為yyyy-mm-dd2.
當發票號碼[InvoiceNumber]有值時,此欄必填.
RelateNumber自訂編號String(20)當發票號碼[InvoiceNumber]為空值時,此欄需有值.
範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件82/111MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3311","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件83/111"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)Buyer_Identifier買方統編String(8)Seller_Identifier賣方統編String(8)CancelDate作廢日期String(20)格式為yyyy-mm-ddCancelReason作廢原因String(20)ConfirmDate作廢確認日期String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullUpload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=0,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=0,此欄為nullConfirmRemark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000002","Buyer_Identifier":"23165448","Seller_Identifier":"","CancelDate":"2019-09-01","CancelReason":"","ConfirmDate":"2019-09-02","Upload_Status":"","Upload_Date":"2019-09-01","ConfirmRemark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件84/11119.
查詢退回發票應用場景:特店(營業人)可使用此API查詢已退回發票資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票退回機制整合至特店(營業人)網站,提供快速查詢服務.

應用流程:(圖)查詢退回發票情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetReject正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetReject特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件85/111合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3321","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店開給交易相對人的退回發票明細)1:進項發票(查詢交易相對人開給特店的退回發票明細)InvoiceNumber發票號碼String(10)當自訂編號[RelateNumber]為空值時,此欄需有值.
InvoiceDate發票開立日期String(20)1.
格式為yyyy-mm-dd2.
當發票號碼[InvoiceNumber]有值時,此欄必填.
RelateNumber自訂編號String(20)當發票號碼[InvoiceNumber]為空值時,此欄需有值.
範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602"}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件86/111綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3321","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件87/111範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)Buyer_Identifier買方統編String(8)Seller_Identifier賣方統編String(8)RejectDate退回日期String(20)格式為yyyy-mm-ddRejectReason退回原因String(20)Upload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=1,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)若發票種類[InvoiceCategory]=1,此欄為nullConfirmDate退回確認日期String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullExchangeStatus退回確認狀態String(1)若為空值表示未設定0:未確認1:已確認Remark備註String(200)範例:{"MerchantID":"2000132","InvoiceNumber":"VG11000002","Buyer_Identifier":"23165448","Seller_Identifier":"","RejectDate":"2019-09-02","RejectReason":"","Upload_Status":"","Upload_Date":"2019-09-24","ConfirmDate":"2019-09-25","ExchangeStatus":"1",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件88/111"Remark":""}20.
查詢退回發票確認應用場景:特店(營業人)可使用此API查詢已退回發票是否完成確認資訊,包括銷項發票及進項發票,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票退回確認機制整合至特店(營業人)網站,提供快速查詢服務.
應用流程:(圖)查詢退回發票確認情境流程圖介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetRejectConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetRejectConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件89/111訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3331","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*InvoiceCategory發票種類Int0:銷項發票(查詢特店開給交易相對人的發票是否完成退回確認)1:進項發票(查詢交易相對人開給特店的發票是否完成退回確認)InvoiceNumber發票號碼String(10)當自訂編號[RelateNumber]為空值時,此欄需有值.
InvoiceDate發票開立日期String(20)1.
格式為yyyy-mm-dd2.
當發票號碼[InvoiceNumber]有值時,此欄必填.
RelateNumber自訂編號String(20)當發票號碼[InvoiceNumber]為空值時,此欄需有值.
範例:{"MerchantID":"2000132","InvoiceCategory":0,"InvoiceNumber":"SA37758327","InvoiceDate":"2019-08-31","RelateNumber":"2019081602"}綠界Response回傳參數說明(Json格式):綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件90/111參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3331","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件91/111"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)InvoiceNumber發票號碼String(10)Buyer_Identifier買方統編String(8)Seller_Identifier賣方統編String(8)RejectDate作廢日期String(20)格式為yyyy-mm-ddRejectReason作廢原因String(20)ConfirmDate退回確認日期String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullUpload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=0,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=0,此欄為nullConfirmRemark備註String(200)範例:{"MerchantID":"2000132""InvoiceNumber":"VG11000002","Buyer_Identifier":"23165448","Seller_Identifier":"","RejectDate":"2019-09-02","RejectReason":"","ConfirmDate":"2019-09-03","Upload_Status":"","Upload_Date":"2019-09-02","ConfirmRemark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件92/11121.
查詢折讓發票應用場景:特店(營業人)可使用此API查詢發票折讓資訊,綠界會以回傳參數方式回覆該張發票折讓資料.
此方式可協助特店(營業人)將查詢折讓發票機制整合至營業人網站,提供快速查詢服務.

應用流程:(圖)查詢折讓情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetAllowance正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetAllowance特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件93/111API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3341","Revision":"1.
0.
0"},"Data":"…"Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件94/111驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3341","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件95/111參數參數名稱型態說明MerchantID特店編號String(10)AllowanceNo綠界折讓編號String(16)長度固定為16碼AllowanceNumber折讓單號碼String(16)廠商自訂折讓單號碼AllowanceType折讓類型String(20)Buyer_Identifier買方統編String(8)Buyer_Name買方名稱String(60)Buyer_Address買方地址String(100)Buyer_TelephoneNumber買方電話String(26)Buyer_EmailAddress買方電子信箱String(80)Seller_Identifier賣方統編String(8)若發票種類[InvoiceCategory]=0,此欄為空值Seller_Name賣方名稱String(60)若發票種類[InvoiceCategory]=0,此欄為空值AllowanceDate折讓單日期String(20)TotalAmount折讓金額總計(未稅)Int1.
請帶整數,不可有小數點,金額不可為0元.
2.
需等於每張發票折讓的商品金額[ItemAmount]加總後四捨五入至整數的值TaxAmount營業稅額Int1.
請帶整數,不可有小數點.
2.
需等於商品稅額[Tax]加總後四捨五入至整數的值IP折讓開立IPString(15)IPV4Upload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=1,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=1,此欄為nullConfirmDate折讓確認時間String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullInvalid_Status作廢狀態String(1)0:未作廢1:已作廢ExchangeStatus發票確認狀態String(1)若為空值表示未設定0:未確認1:已確認Items傳入資料OriginalInvoiceDate原發票日期String(20)格式為yyyy-mm-ddhh:mm:ss綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件96/111參數參數名稱型態說明OriginalInvoiceNumber原發票號碼String(10)OriginalSequenceNumber發票商品明細排序String(3)1.
請帶1~999的整數值2.
商品排序需與原發票開立時的商品排序相同OriginalDescription原商品名稱String(256)InvoiceType字軌類別String(2)07:一般稅額計算08:特種稅額計算TaxType課稅別Int1.
當字軌類別[InvType]為07(一般稅額計算之電子發票)時,則該參數請帶1(一般應稅)、2(零稅率)或3(免稅)2.
當字軌類別[InvType]為08(特種稅額計算之電子發票)時,則該參數請帶4(特種應稅)AllowanceSequenceNumber折讓單排序String(3)1.
請帶1~999的整數值2.
商品排序需與原發票開立時的商品排序相同Quantity商品數量Number1.
支援整數最多8位,小數2位2.
折讓的商品數量[ItemCount],不可超過原發票商品開立的數量Unit商品單位String(6)商品單位最多是6碼UnitPrice商品價格Number支援整數最多8位,小數7位Tax商品稅額Int1.
須為整數2.
折讓的商品稅額[Tax],定義【折讓的商品合計[ItemAmount]*開立發票API的稅率[TaxRate]】=B,則折讓的商品稅額[Tax]與B的差距不可大於1Amount商品合計Number1.
支援整數最多12位,小數7位2.
定義【[商品數量[ItemCount]*商品價格[ItemPrice]】=A,則折讓商品合計[ItemAmount]的值與A四捨五入後的值,差距不可大於1BalanceAmount發票可折讓金額NumberRemark備註String(200)範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030","AllowanceNumber":"1909241702402030","AllowanceType":"2","Buyer_Identifier":"23165448","Buyer_Name":"綠化肥肥化灰",綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件97/111"Buyer_Address":"100臺北市中正區","Buyer_TelephoneNumber":"02-26551775","Buyer_EmailAddress":"abc1234@gmail.
com","Seller_Identifier":"12345671","Seller_Name":"綠界科技BETA綠界科技BETA股份有限公司","AllowanceDate":"2019-09-24","TotalAmount":24,"TaxAmount":1,"IP":2130706433,"Upload_Status":"0","Upload_Date":"2019-09-24","ConfirmDate":"2019-09-25","Invalid_Status":"0","ExchangeStatus":"1","Items":[{"OriginalInvoiceDate":"2019-09-2400:00:00","OriginalInvoiceNumber":"VG11000003","OriginalSequenceNumber":1,"OriginalDescription":"小浣熊","InvoiceType":"07","TaxType":1,"AllowanceSequenceNumber":1,"Quantity":2,"Unit":"粒","UnitPrice":12,"Tax":1,"Amount":24,"BalanceAmount":0}],"Remark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件98/11122.
查詢折讓發票確認應用場景:特店(營業人)可使用此API查詢已開立折讓發票是否完成確認資訊,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢折讓發票確認機制整合至營業人網站,提供快速查詢服務.
應用流程:(圖)查詢折讓確認情境流程圖介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetAllowanceConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetAllowanceConfirm綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件99/111特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3351","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030"綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件100/111}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID廠商編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3351","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件101/111參數參數名稱型態說明RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":""}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)Seller_Identifier賣方統編String(8)Buyer_Identifier買方統編String(8)AllowanceDate折讓單日期String(20)格式為yyyy-mm-ddConfirmDate折讓確認時間String(20)1.
格式為yyyy-mm-dd2.
若未作設定,此欄為nullUpload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=0,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=0,此欄為nullConfirmRemark備註String(200)範例:"MerchantID":"2000132","Seller_Identifier":"23165448","Buyer_Identifier":"","AllowanceDate":"2019-09-24","ConfirmDate":"2019-09-25","Upload_Status":"","Upload_Date":"2019-09-24","ConfirmRemark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件102/11123.
查詢作廢折讓發票應用場景:特店(營業人)可使用此API查詢已作廢折讓發票資訊,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票作廢折讓機制整合至營業人網站,提供快速查詢服務.

(注意事項:根據財政部規定,只有買方可以上傳作廢折讓發票).
應用流程:(圖)查詢作廢折讓情境流程圖介接網址:測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetAllowanceInvalid正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetAllowanceInvalid特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件103/111API無法正常運作.
*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3361","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030"}綠界Response回傳參數說明(Json格式):參數參數名稱型態說明MerchantID廠商編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件104/111訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int回傳代碼1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3361","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,"RtnMsg":"查詢成功","RtnData":"…"}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID廠商編號String(10)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件105/111參數參數名稱型態說明AllowanceNo綠界折讓編號String(16)長度固定為16碼AllowanceNumber折讓單號碼String(16)廠商自訂折讓單號碼SellerId賣方統編String(8)BuyerId買方統編String(8)CancelDate作廢日期String(20)格式為yyyy-mm-ddCancelReason作廢原因String(20)Upload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=0,此參數不顯示0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=0,此參數不顯示ExchangeStatus確認狀態String(1)若為空值表示未設定1:已確認0:未確認Remark備註String(200)範例:{"MerchantID":"200132","AllowanceNo":"1909241702402030","AllowanceNumber":"19092234024023330","SellerId":"23165448","BuyerId":"","CancelDate":"2019-09-25","CancelReason":"","Upload_Status":"","Upload_Date":"null","ExchangeStatus":"1","Remark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件106/11124.
查詢作廢折讓發票確認應用場景:特店(營業人)可使用此API查詢已作廢折讓發票是否完成確認資訊,綠界會以回傳參數方式回覆該張發票資料.
此方式可協助特店(營業人)將查詢發票作廢折讓確認機制整合至營業人網站,提供快速查詢服務.
應用流程:(圖)查詢作廢折讓確認情境流程圖介接網址測試環境:https://einvoice-stage.
ecpay.
com.
tw/B2BInvoice/GetAllowanceInvalidConfirm正式環境:https://einvoice.
ecpay.
com.
tw/B2BInvoice/GetAllowanceInvalidConfirm特店傳入參數說明(Json格式):參數名稱前若有紅色星號*為必填欄位參數參數名稱型態說明*MerchantID特店編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得*RqHeader傳入資料*Timestamp傳入時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件107/111*RqID傳輸編號String(64)每次發動串接API的傳輸編號,需唯一且不可重覆,請使用GUID(全域唯一識別碼)作為傳輸編號*Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0*Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RqHeader":{"Timestamp":"1525168923","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3371","Revision":"1.
0.
0"},"Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明*MerchantID特店編號String(10)*AllowanceNo綠界折讓編號String(16)長度固定為16碼範例:{"MerchantID":"2000132","AllowanceNo":"1909241702402030"}綠界Response回傳參數說明:參數參數名稱型態說明MerchantID廠商編號String(10)1.
測試環境合作特店編號2.
正式環境金鑰取得RpHeader回傳資料Timestamp回傳時間String(10)綠界會利用此參數將當下的時間轉為UnixTimeStamp來驗證此次介接的時間區間.
注意事項:驗證時間區間暫訂為5分鐘內有效,若超過此驗證時間則此次訂單將無法建立,參考資料:http://www.
epochconverter.
com/.
綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件108/111合作特店須進行主機「時間校正」,避免主機產生時差,延伸API無法正常運作.
RqID傳輸編號String(64)特店傳入的傳輸編號Revision串接版號String(10)串接規格文件版號,固定為1.
0.
0TransCode回傳代碼Int回傳代碼1代表API呼叫成功,其餘均為失敗TransMsg回傳訊息String(200)回傳訊息Data加密資料String回傳相關資料,此為加密過JSON格式的資料.
加密方法說明範例:{"MerchantID":"2000132","RpHeader":{"Timestamp":"1525169058","RqID":"3F2504E0-4F89-11D3-9A0C-0305E82C3371","Revision":"1.
0.
0"},"TransCode":1,"TransMsg":"","Data":"…"}Data參數說明(Json格式):參數參數名稱型態說明RtnCode回應代碼Int1為成功,其餘為失敗.
RtnMsg回應訊息String(200)RtnData回應資料String範例:{"RtnCode":1,"RtnMsg":"","RtnData":"…"}RtnData參數說明(Json格式):參數參數名稱型態說明MerchantID特店編號String(10)Seller_Identifier賣方統編String(8)綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件109/111參數參數名稱型態說明Buyer_Identifier買方統編String(8)CancelDate作廢日期String(20)格式為yyyy-mm-ddUpload_Status上傳狀態String(1)若發票種類[InvoiceCategory]=1,此欄為空值0:未上傳1:已上傳2:上傳失敗Upload_Date上傳時間String(20)1.
格式為yyyy-mm-dd2.
若發票種類[InvoiceCategory]=1,此欄為nullExchangeStatus發票確認狀態String(1)若為空值表示未設定0:未確認1:已確認ConfirmRemark備註String(200)0範例:{"MerchantID":"2000132","Seller_Identifier":"23165448","Buyer_Identifier":"","CancelDate":"2019-09-26","Upload_Status":"","Upload_Date":"null","ExchangeStatus":"1","ConfirmRemark":""}綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件110/111附錄1.
交易狀態代碼表因錯誤代碼一直在新增,詳細的錯誤代碼,請到廠商後台->系統開發管理->交易狀態代碼查詢.

綠界科技股份有限公司GreenWorldFinTechServiceCo.
,Ltd.
綠界科技電子發票B2B介接技術文件111/111附錄2.
參數加密方式說明綠界會提供AES加解密用的Key及IV,請將要加密資料先做URLEncode編碼,再進行AES加密.
AES加密的強度設定方式是128bit,CipherMode:CBC,PaddingMode:PKCS7注意事項:(1)以下為測試範例的資訊,請勿對正式環境做處理否則無法正常介接.
(2)更換介接正式環境時,請將以下資訊更換成正式環境中特店所持有的相關資訊,請參考正式環境金鑰取得.