如何安裝綠界金流及電子發票模組?

在 Odoo 安裝綠界模組啟用綠界線上金流服務及電子發票

Andy Cheng
Odoo image and text block

線上金流與電子發票

這幾年電商網站如雨後春筍般蓬勃發展, Odoo 也不落人後的推出了電商相關功能的模組。但在使用 Odoo 來線上開店時,也會需要串接第三方金流的服務,才能提供客人線上刷卡、虛擬帳號銀行轉帳和超商取貨等便利的功能。

除了線上支付外,因為政府近年大力推行電子發票,這麼便利的功能,自然對電商賣家來說也不可缺少(現在去登記然後說是要做線上購物的公司,十之八九都會被國稅局要求使用電子發票)。

綠界 ECPay

在串接金流和電子發票時,常見的一個選項就是綠界了。綠界提供以下金流服務:

  • 信用卡

  • 信用卡分期

  • 信用卡定期定額

  • 銀行轉帳

  • 超商代碼繳費

  • 超商條碼繳費

  • 超商取貨付款/不付款

除了金流服務,綠界也提供了電子發票加值中心的服務,讓店家可以透過綠界開立電子發票,不需自行串接國稅局。現在綠界更提供了 Odoo 的串接模組( https://www.ecpay.com.tw/Intro/OdooIntro ),讓大家可以快速的用 Odoo 架設電商官網。以下就來帶大家一步一步在 Odoo 11 上安裝並設定綠界的串接模組。

Odoo text and image block

安裝 ECPay 綠界第三方金流模組

  1. 首先至 https://github.com/ECPay/Odoo_Payment/blob/master/payment_ecpay.zip 下載金流串接模組。進入該頁面後,點選「 Download 」直接下載該壓縮檔。

  2. 下載完成後,直接解壓縮該檔案,並將解出的資料夾直接放至 Odoo 的 addon 資料夾底下。

  3. 到已開好的 Odoo 站台中的「 Apps 」頁面,點選左方選單中的「 Update Apps List 」,讓 Odoo 抓到該模組的資料。

  4. 安裝「 payment_ecpay 」模組。

  5. 安裝完成。

Odoo text and image block

設定 ECPay 綠界第三方金流模組

  1. Start with the customer – find out what they want and give it to them.

  2. 設定綠界金流模組

    到 Odoo 的「 Invoicing 」或「 Accounting 」模組,進入左方選單中的「 Configurations > Payments > Payment Acquirers 」頁面。

  3. 找到綠界 / ECpay 的項目,點擊「 Configure 」。

  4. 輸入「特店編號」、「 Hash Key 」、「 Hash IV 」。

  5. 輸入「網域名稱」,例如 odoo11.example.com 。此網域名稱就是連接 Odoo 站台時的網域,必須是從外部可以連上的網域,綠界的主機才能將付款結果傳回 Odoo 。若是測試時不想再去買網域,也可以使用網路上很多廠商提供的 Dynamic DNS 的服務,例如 No IP

  6. 設定想要提供的付款方式。記得,此處開啟的付款方式,在綠界後台的商店設定中也要開啟,否則會導致串接失敗。

  7. 確認右上角啟用/停用的 buttonbox 是否顯示為「 Published 」,不然前台會選不到綠界的付款方式。

  8. 右上角的「 Environment 」 buttonbox 可以切換綠界金流的測試/正式環境。建議可以在測試環境中確認運作正常後,再切換至正式環境。測試環境的金鑰和密鑰可以在綠界官網的 API 串接說明文件中找到。

  9. 記得確認設定是在測試環境還是正式環境!
  10. 設定完成後,在前台的結帳頁面中就可以看到綠界的選項了。

附註:超商取貨付款/不付款是歸在在綠界物流模組中。

Odoo text and image block

安裝 ECPay 綠界第三方物流模組

  1. 首先至 https://github.com/ECPay/Odoo_Logistics/blob/master/logistic_ecpay.zip 下載物流串接模組。進入該頁面後,點選「 Download 」直接下載該壓縮檔。

  2. 下載完成後,直接解壓縮該檔案,並將解出的資料夾直接放至 Odoo 的 addon 資料夾底下。

  3. 到已開好的 Odoo 站台中的「 Apps 」頁面,點選左方選單中的「 Update Apps List 」,讓 Odoo 抓到該模組的資料。

  4. 安裝「 logistic_ecpay 」模組。

  5. 安裝完成。

Odoo text and image block

設定 ECPay 綠界第三方物流模組

  1. 到 Odoo 的「 Inventory 」模組,進入左方選單中的「 Delivery > Delivery Methods 」頁面。

  2. 找到綠界 / ECpay 的項目,點擊進入。

  3. 輸入「特店編號」、「 Hash Key 」、「 Hash IV 」。

  4. 輸入「網域名稱」,例如 odoo11.example.com 。此網域名稱就是連接 Odoo 站台時的網域,必須是從外部可以連上的網域,綠界的主機才能將付款結果傳回 Odoo 。若是測試時不想再去買網域,也可以使用網路上很多廠商提供的 Dynamic DNS 的服務,例如 No IP

  5. 選擇「會員種類」,此處是指超取的類型。「 B2C 」為大宗寄倉,「 C2C 」是店到店,兩者不可混用。

  6. 設定想要提供的送貨方式。記得,此處開啟的送貨方式,在綠界後台的商店設定中也要開啟,否則會導致串接失敗。

  7. 設定各個送貨方式的運費金額。

  8. 確認右上角啟用/停用的 buttonbox 是否顯示為「 Published 」,不然前台會選不到綠界的送貨方式。

  9. 右上角的「 Environment 」 buttonbox 可以切換綠界金流的測試/正式環境。建議可以在測試環境中確認運作正常後,再切換至正式環境。測試環境的金鑰和密鑰可以在綠界官網的 API 串接說明文件中找到。

  10. 記得確認設定是在測試環境還是正式環境!
  11. 設定完成後,在前台的輸入地址頁面中就可以看到綠界的選項了。

Odoo text and image block

安裝 ECPay 綠界電子發票模組

  1. 首先至 https://github.com/ECPay/Odoo_Invoice/blob/master/ecpay_invoice_tw.zip 下載電子發票串接模組。進入該頁面後,點選「 Download 」直接下載該壓縮檔。

  2. 下載完成後,直接解壓縮該檔案,並將解出的資料夾直接放至 Odoo 的 addon 資料夾底下。

  3. 安裝 Python 套件「 ecpay_invoice3 」。在 Linux 命令列底下輸入「 sudo pip3 install ecpay_invoice3 」。

  4. 到已開好的 Odoo 站台中的「 Apps 」頁面,點選左方選單中的「 Update Apps List 」,讓 Odoo 抓到該模組的資料。

  5. 安裝「 ecpay_invoice_tw 」模組。

  6. 安裝完成。

Odoo text and image block

設定 ECPay 綠界電子發票模組

  1. 到 Odoo 的「 Invoicing 」或「 Accounting 」模組,進入左方選單中的「 Configurations > Settings 」頁面。

  2. 找到綠界電子發票的區塊。

  3. 輸入「特店編號」、「 Hash Key 」、「 Hash IV 」。

  4. 輸入「賣方統編」。 

  5. 「測試模式」選項可以切換綠界金流的測試/正式環境。建議可以在測試環境中確認運作正常後,再切換至正式環境。測試環境的金鑰和密鑰可以在綠界官網的 API 串接說明文件中找到。

  6. 記得確認設定是在測試環境還是正式環境!
  7. 設定完成後,完成結帳的訂單就會自動開立電子發票了。

Odoo text and image block

附註

目前測試下來,綠界的串接尚稱完整,唯一美中不足的地方是在結帳流程上破壞了原本 Odoo 的流程。如果店家在宅配的部分沒有要串接綠界,仍會在輸入地址頁面出現綠界的物流選項,要到選擇付款方式頁面才會出現選擇店家自行設定的送貨方式。這樣的流程在實際使用上,一定會造成消費者的混淆,希望綠界能儘速在未來的版本中修正此一問題。