驗證發票統編
對於在台營運的電商系統,本篇提供利用公開的第三方去驗證發票統編是否有效之範例。
針對在台灣登記的公司,目前經濟部已有公開平台可以查詢:https://data.gcis.nat.gov.tw/main/index
除了網頁直接操作的查詢介面,該平台亦提供程式串接的API介面:https://data.gcis.nat.gov.tw/od/rule
因此系統可以透過串接這些API,去驗證統編是否有效。以下採用上列項目 2.公司登記基本資料-應用ㄧ 作為範例,輸入統編來查詢對應的公司
https://data.gcis.nat.gov.tw/od/demo_cond/5F64D864-61CB-4D0D-8AD9-492047CC1EA6
依照使用參數說明,必要輸入為 資料格式 與 公司統一編號,本範例使用 json 格式與歐斯瑞統編 24625602 產生如下查詢網址:
http://data.gcis.nat.gov.tw/od/data/api/5F64D864-61CB-4D0D-8AD9-492047CC1EA6?$format=json&$filter=Business_Accounting_NO eq 24625602
我們可以直接在瀏覽器上開啟該網址(GET),就會取得如下回傳內容
比對網頁的查詢介面,此應用項目所回傳的資訊明細如下
|
公司統一編號 |
|
公司狀況描述 |
|
公司名稱 |
|
資本總額(元) |
|
實收資本額(元) |
|
代表人姓名 |
|
公司登記地址 |
|
登記機關名稱 |
|
核准設立日期 |
|
最後核准變更日期 |
|
撤銷日期 |
|
停復業狀況 |
|
停復業狀況描述 |
|
停業核准日期 |
|
停業/延展期間(起) |
|
停業/延展期間(迄) |
而當查詢不存在的統編時,則不會有任何資訊回傳。開發者只需將瀏覽器查詢網址的行為,轉化為程式執行,即可利用這項應用API去確認統編的有效性,甚至進一步驗證相關資料是否相符。
最後要提醒開發人員,網站上列示的API,有標示(測試)的項目,需先透過email申請,請維運團隊協助將欲存取的來源IP加到白名單,才能順利使用。另外,API端也有限制存取頻率與次數,因此實作上,建議加上快取以降低重複確認的次數。
參考資料來源:https://data.gcis.nat.gov.tw/main/index
以上就是歐斯瑞本次 驗證發票統編 的分享
我要留言