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

在 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 的流程。如果店家在宅配的部分沒有要串接綠界,仍會在輸入地址頁面出現綠界的物流選項,要到選擇付款方式頁面才會出現選擇店家自行設定的送貨方式。這樣的流程在實際使用上,一定會造成消費者的混淆,希望綠界能儘速在未來的版本中修正此一問題。