TapPay 電子發票 x WooCommerce

• 設定
• 前置作業
• 查詢 Partner Key
• API 設定
• 結帳介面
• 前台電子發票資訊
• 後台電子發票資訊
• 過濾電子發票開立狀態
• 後台電子發票資訊
• 作廢發票
• 查詢發票
• 捐贈單位設定
• 如何查詢 request_id 並完成功能串接
• 常見問題 Q&A

設定

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

查詢 Partner Key

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

API 設定

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

結帳介面

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

前台電子發票資訊

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

後台電子發票資訊

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

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

過濾電子發票開立狀態

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

後台電子發票資訊

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

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

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

作廢發票

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

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

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

查詢發票

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

捐贈單位設定

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

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

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

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

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

常見問題 Q&A