WHMCS X 光貿電子發票

安裝

1.請先解壓縮 zip 檔，將整個 amego_einvoice 資料夾上傳至 whmcs 的 modules/addons 目錄下

2.請將 includes/hooks/amego_einvoice.php 複製到 WHMCS 目錄下的 includes/hooks 目錄

以上即完成安裝

請至 System Settings 搜尋 Addons，點擊 Addons Modules

點擊 Activate 按鈕來啟用光貿電子發票模組

啟用後，請點擊 Configure 進行設定

若您要用測試帳號測試，請輸入測試用統一編號 12345678，App Key 請使用 sHeq7t8G1wiQvhAuIM27，若有變動請參考光貿 API 文件的說明

若您希望付款完成後自動開立電子發票，請將「自動開立」功能啟用

Access Control 請針對您希望開放的使用者角色進行勾選

完成後請按下「Save Changes」來完成設定

在結帳頁面 (Checkout) 客戶可選擇電子發票開立的類型，若之前有下過訂單，則會將之前訂單的發票資料直接帶入

手機條碼載具

光貿會員載具 (光貿會員載具是用客戶的 email 為識別，將發票資料儲存在光貿的系統中，客戶若沒有手機條碼可選擇光貿會員載具，客戶不需額外申請)

公司發票

💡

電子發票列表是操作和檢視電子發票的主要頁面，在這個頁面你可以檢視每一個 Invoice 對應的電子發票內容，以及進行開立和作廢的動作，若顧客輸入資料錯誤，亦可在未開立或已作廢的狀態下，修改電子發票開立內容再重新開立。

若您的帳號具有存取 Amego EInvoice 權限，則可以看到 Addons → Amego Einvoice 這個選單

在電子發票列表頁可以看到所有 Invoice 對應的電子發票開立狀態，可以透過開立狀態來篩選，或是搜尋特定 Invoice ID、電子發票號碼和客戶名稱

若要檢視詳細發票資訊，可點擊發票號碼，會顯示 popup，可以檢視發票開立和載具的類型

若發票開立失敗，可點擊紅色「檢視內容」連結，一樣會有popup，內容會顯示錯誤訊息。

開立失敗或未開立的發票可更新發票的開立資訊，儲存變更後再重新開立

在後台的 Invoice 頁面，可以看到多一個電子發票的分頁，內容會顯示對應的電子發票資訊。這邊僅供檢視，如要操作開立或作廢，請至電子發票列表頁面。

客戶可於 Invoice 頁面檢視電子發票資訊 (需修改 template)

若你要在客戶檢視的 Invoice 頁面顯示電子發票資訊，需修改使用的模版

以 Twenty-One 這個模版為例，你需要修改 templates/twenty-one/viewinvoice.tpl 這個檔案

在你要顯示電子發票資訊的地方，貼上以下程式碼。

 {if $amego_einvoice_output}
     {$amego_einvoice_output}
 {/if}

這邊我們把電子發票資訊放在列印和下載的按鈕上方

Q.為什麼在光貿後台的訂單編號都會多一個序號

A: 這是因為訂單編號不能重複，所以為了方便在短時間可以作廢再重新開立，因此我們會在編號後面家一個序號來避免訂單編號重複的問題 (這邊的訂單編號實際上是 WHMCS 中的 Invoice ID)