iT邦幫忙

2018 iT 邦幫忙鐵人賽
DAY 23
1
自我挑戰組

使用PHP串接金流相關API系列 第 23

Day 22 - 電子發票(3) API 功能(續)

電子發票 API (續)

今天要繼續串接剩下功能:

API 方法網址 HTTP METHOD
愛心碼查詢 /PB2CAPIVAN/loveCodeapp/qryLoveCode POST
載具發票表頭查詢 /PB2CAPIVAN/invServ/InvServ POST
載具發票號碼明細查詢 /PB2CAPIVAN/invServ/InvServ POST
載具發票捐贈 /PB2CAPIVAN/CarInv/Donate POST
手機條碼歸戶載具查詢 /PB2CAPIVAN/Carrier/Aggregate POST
已歸戶載具個別化主題 https://sip.einvoice.nat.gov.tw/ods-main/ODS3 GET

API 方法說明(續)

**.**愛心碼查詢

查詢目前電子發票平台已經完成註冊登記愛心碼的社福團體。

POST https://api.einvoice.nat.gov.tw/PB2CAPIVAN/loveCodeapp/qryLoveCode

參數名稱 是否必填 參數格式 說明 範例
version 浮點數 版本號碼(帶入範例值即可) 0.2
qKey 字串 要查詢的愛心碼/統編之關鍵字 621
action 字串 API 行為(帶入範例值即可) qryLoveCode
UUID 字串 行動工具 Unique ID
appID 字串 透過財政資訊中心大平台申請之軟體 ID

POST request data

$postData = array(
  'version' => '0.2'
  , 'action' => 'qryLoveCode'
  , 'qKey' => '88432'
  , 'appID' => 'EINV12017XXXXXXXX'
  , 'UUID' => '123456'
);

'88432'財團法人喜憨兒社會福利基金會 之愛心碼

查詢成功會得到 社福團體統一編號、愛心碼、社福名稱及社福簡稱等資訊

["details"]=>
  array(1) {
    [0]=>
    array(5) {
      ["rowNum"]=>
      int(0)
      ["SocialWelfareBAN"]=>
      string(8) "92070381"
      ["LoveCode"]=>
      string(5) "88432"
      ["SocialWelfareName"]=>
      string(42) "財團法人喜憨兒社會福利基金會"
      ["SocialWelfareAbbrev"]=>
      string(9) "喜憨兒"
    }
  }
//'qKey'同時也可以用來查詢社福機構名稱
//若有多筆查詢結果,會將資訊放入 array ["details"] 中
'qKey' => '醫院'

//response
["details"]=>
  array(7) {
    [0]=>
    array(5) {
      ["rowNum"]=>
      int(0)
      ["SocialWelfareBAN"]=>
      string(8) "93506428"
      ["LoveCode"]=>
      string(3) "299"
      ["SocialWelfareName"]=>
      string(33) "財團法人台東基督教醫院"
      ["SocialWelfareAbbrev"]=>
      string(6) "東基"
    }
    [1]=>
    array(5) {
      ["rowNum"]=>
      int(1)
      ["SocialWelfareBAN"]=>
      string(8) "94607424"
      ["LoveCode"]=>
      string(3) "555"
      ["SocialWelfareName"]=>
      string(54) "臺灣基督教門諾會醫療財團法人門諾醫院"
      ["SocialWelfareAbbrev"]=>
      string(12) "花蓮門諾"
    }
    ...

上一篇
Day 21 - 電子發票(2) API 功能
下一篇
Day 23 - 電子發票(3) API 功能
系列文
使用PHP串接金流相關API30

尚未有邦友留言

立即登入留言