PART ONE
專案總覽｜功能與應用場景
此 Odoo 18 模組整合了台灣綠界科技 (ECPay) 的金流與電子發票服務。它讓 Odoo 系統能夠處理 ECPay 的多種支付方式，並直接從 Odoo 開立、作廢、或折讓符合台灣法規的電子發票，同時支援網站結帳時的發票選項。
🔑 核心功能
- 綠界金流整合
- 台灣電子發票
- 多種載具支援
- 發票作廢與折讓
- 電商網站結帳整合
- 信用卡/ATM/超商支付
- 捐贈發票功能
📋 功能詳細說明
| 功能名稱 | 說明 |
|---|---|
| 電商網站自動開立發票 | 一家線上零售商店使用 Odoo 作為後端管理系統。顧客在網站下單並使用 ECPay 信用卡付款成功後，系統會根據顧客在結帳時選擇的載具（如手機條碼或自然人憑證），自動觸發並開立電子發票，無需人工介入。 |
| 企業B2B應收帳款發票開立 | 一家提供顧問服務的公司使用 Odoo 管理客戶合約與帳務。當一筆應收帳款確認後，財務人員可直接在 Odoo 的發票紀錄中點擊「開立發票」，系統即透過 ECPay API 將電子發票寄送給客戶，並同步更新發票狀態。 |
PART TWO
深入解析｜執行環境與部署步驟
⚙️ 執行環境需求
- 運行此專案所需的軟體、硬體和相依套件
- 需要 Odoo 18.0 社區版或企業版。建議在 Ubuntu 22.04 LTS 上運行。
- 需要 Python 3.10 或更高版本，模組相依套件會自動安裝。
- 需要 PostgreSQL 14 或更高版本作為 Odoo 的後端資料庫。
- 必須擁有有效的綠界科技商戶資格，並取得 API 串接所需的 Hash Key 與 Hash IV。
🔧 部署安裝步驟
| 步驟 | 說明 |
|---|---|
| Step 1 | 將 \`ecpay_invoice_tw\`, \`ecpay_invoice_website\`, \`payment_ecpay\` 三個模組資料夾複製到 Odoo 的 addons 路徑下。 |
| Step 2 | 以開發者模式進入 Odoo，點擊「應用程式」選單中的「更新應用程式列表」。 |
| Step 3 | 在搜尋框中找到 'ecpay' 相關模組。 |
| Step 4 | 依照順序安裝模組：先安裝 \`ecpay_invoice_tw\`，接著是 \`ecpay_invoice_website\`，最後是 \`payment_ecpay\`。 |
| Step 5 | 前往「會計/開立憑單」->「配置」->「設定」，填寫 ECPay 電子發票的商戶 ID、Hash Key 和 Hash IV。 |
| Step 6 | 前往「會計/開立憑單」->「配置」->「付款服務提供者」，啟用 ECPay 金流服務並設定相關金鑰。 |
PART THREE
總結與展望｜AI Agent 部署 Prompt
🤖 AI Agent 部署 Prompt
以下是用於部署此專案的 AI Agent Prompt，可直接複製使用：
複製此 Prompt 給 AI Agent，即可自動完成安裝、部署與測試
← 返回開源專案列表