TapPay 電子發票 x WooCommerce

設定

image
  1. 啟用:啟用 TapPay 電子發票
  2. 除錯紀錄:顯示除錯紀錄
  3. 賣家名稱:請輸入賣家的公司名稱
  4. 賣家統編:請輸入賣家的統一編號
  5. 開立方式:自動開立或手動開立
  6. 自動開立發票的訂單狀態:若選擇自動開立,當訂單狀態為指定的狀態時,系統會自動開立發票
  7. 排除自動開立發票的產品類別:當訂單商品包含指定分類則不自動開立發票
  8. 作廢方式:自動作廢或手動作廢
  9. 自動作廢發票的訂單狀態:若選擇手動作廢,當訂單狀態為指定的狀態時,系統會自動作廢發票
  10. 稅率:預設的發票稅率
  11. 運送方式標題:自訂運送方式顯示在發票明細中的名稱
  12. 折扣顯示模式:設定折扣是否要獨立為一個品項顯示在發票明細中
  13. 載具類型:設定要顯示在前台結帳時的載具類型
  14. 捐贈單位:若有載具類型有選擇捐贈,請設定捐贈單位
  15. 測試模式:連線到測試環境
  16. Partner Key:請於 TapPay 後台查詢 Partner Key

前置作業

請先至雲端發票註冊取得帳號,註冊完成後雲端發票回提供 API_KEY 和 API_SECRET

請分別將 API_KEY 填入 account_id,將 API_SECRET 填入 shared_secret

image

查詢 Partner Key

您可以在 TapPay 後台的公司資訊中查詢 Partner Key,請複製此 Partner Key,輸入到外掛設定頁面中的 Partner Key 欄位

image

API 設定

請將查詢到的 Partner Key 輸入到 API 設定中的 Partner Key 欄位。在測試階段請勾選測試模式

image

結帳介面

在結帳時,消費者可選擇欲開立的電子發票方式。包含個人用電子發票(B2C),公司用電子發票(B2B),或是捐贈

個人用電子發票
個人用電子發票
公司用電子發票
公司用電子發票
捐贈
捐贈
  • 個人用電子發票需選擇以下其中一種載具
    • 手機條碼 (/開頭,總共8碼)
    • 自然人憑證(總共16碼,前兩碼為大寫英文字母)
    • 會員載具
  • 公司用電子發票需輸入:
    • 買方名稱(公司名稱)
    • 統一編號
  • 捐贈:選擇設定好的捐贈單位

前台電子發票資訊

在訂單完成頁面(以及我的帳號中的訂單詳細資訊)會顯示電子發票資訊

image

後台電子發票資訊

在訂單列表頁中,會顯示訂單開立的狀態,方便管理人員了解發票開立狀態。

  • 綠色發票編號:已開立
  • 未開立:從未執行發票開立動作
  • 開立失敗:執行發票開立但失敗
  • 作廢失敗:執行發票作廢但失敗
  • 灰色發票編號:已作廢
image

過濾電子發票開立狀態

在後台訂單清單頁面,可以選擇電子發票開立狀態來過濾訂單

image

後台電子發票資訊

在後台的訂單資訊中,可以查看電子發票的相關資訊。

開立成功或失敗皆會於備註中紀錄相關資訊。若發票已開立,會顯示作廢按鈕。當發票已開立,則欄位會變成不可編輯狀態。

若需重新開立,請先作廢發票。

image

作廢發票

點擊作廢按鈕後,會執行發票作廢。若成功則發票的開立狀態會改為已作廢,同時顯示開立電子發票按鈕。若欲重新開立發票,可點擊開立電子發票按鈕。

⚠️ 若欲修改索取方式及載具資訊,請於修改完後,先更新訂單,才能儲存新的電子發票資料。更新訂單後,再點擊開立電子發票按鈕。

若發票已作廢,或是未開立,則欄位會變成可編輯狀態,可在開立前更新發票資訊。

image

查詢發票

在後台訂單編輯頁面的 TapPay 電子發票資訊中,可以點擊查詢按鈕來查詢發票狀態。查詢結果會記錄在訂單備註中。

image

捐贈單位設定

您可自行設定捐增單位。設定格式為 愛心碼|單位名稱。一行一筆。

您可至可至財政部電子發票整合服務平台查詢

image

如何查詢 request_id 並完成功能串接

在測試的過程中,TapPay 會要求於測試環境中進行一筆開立發票測試,並將該測試的 request_id 輸入。

image

當啟用測試環境時,可以在訂單備註中看到 request_id 的紀錄,請複製圖中紅線標示的內容,並複製到 TapPay 後台功能串接的 Request_id 欄位,然後點擊確認串接狀態按鈕,若成功代表完成功能串接測試。

image

常見問題 Q&A

使用別的金流、物流,可使用 TapPay 電子發票嗎?