天地人實業有限公司 - Taiwan Sample Client Plugin
iDempiere 是一套功能強大的開源 ERP 系統，但對於台灣使用者來說，有幾個痛點：
| 問題 | 說明 |
|---|---|
| 🇺🇸 美國會計科目 | 預設的會計科目是美國 GAAP 標準，不符合台灣商業會計法規 |
| 📝 沒有中文示範資料 | 學習和測試時缺乏貼近實務的範例 |
| ⏰ 初始設定繁瑣 | 需要花費大量時間手動建立組織、倉庫、商品、客戶、供應商等基礎資料 |
| 🌐 全英文介面 | 對於初學者有一定的學習門檻 |
這個插件解決了以上問題，讓你可以一鍵建立完整的台灣示範公司，立即開始學習或測試 iDempiere。
安裝後會自動建立一間完整的台灣示範公司「天地人實業有限公司」，包含：
| 組織 | 代碼 | 類型 | 說明 |
|---|---|---|---|
| 台北總公司 | HQ | 總部 | 主要營運據點 |
| 台中分公司 | TC | 分公司 | 中部營運據點 |
| 高雄倉庫 | KH | 倉庫 | 南部物流中心 |
| 倉庫 | 所屬組織 | 用途 |
|---|---|---|
| 台北主倉 | 台北總公司 | 主要存貨倉庫 |
| 台北門市倉 | 台北總公司 | 門市銷售用 |
| 台中倉 | 台中分公司 | 中部配送中心 |
| 高雄倉 | 高雄倉庫 | 南部配送中心 |
符合台灣商業會計法規的完整會計科目，包含正確的樹狀階層結構：
1 資產
├── 11 流動資產
│ ├── 111 現金及約當現金
│ │ ├── 1111 庫存現金
│ │ ├── 1112 零用金
│ │ ├── 1113 銀行存款
│ │ ├── 1114 在途現金
│ │ ├── 1115 未分配現金
│ │ ├── 1116 未確認款項
│ │ ├── 1117 現金調撥
│ │ └── 1118 付款選擇
│ ├── 112 短期投資
│ ├── 113 應收票據
│ ├── 114 應收帳款
│ │ ├── 1141 應收帳款-貿易
│ │ └── 1143 應收帳款-服務
│ ├── 118 其他應收款
│ │ ├── 1184 預付款項
│ │ ├── 1185 進項稅額
│ │ ├── 1186 員工預付款
│ │ └── 1187 稅務應收款
│ └── 119 存貨
│ ├── 1191 商品存貨
│ ├── 1192 原物料
│ ├── 1193 在製品
│ ├── 1196 存貨結轉
│ ├── 1197 到岸成本結轉
│ └── 1198 倉庫存貨
├── 12 非流動資產
│ ├── 121 固定資產
│ └── 122 專案資產
│ ├── 1221 專案資產
│ └── 1222 專案在製品
2 負債
├── 21 流動負債
│ ├── 211 短期借款
│ ├── 212 應付票據
│ ├── 213 應付帳款
│ │ ├── 2131 應付帳款-貿易
│ │ └── 2133 應付帳款-服務
│ ├── 214 其他應付款
│ │ ├── 2142 應付薪資
│ │ ├── 2144 銷項稅額
│ │ ├── 2145 預收款項
│ │ ├── 2146 應付勞保費
│ │ ├── 2147 應付健保費
│ │ ├── 2148 應付勞退金
│ │ ├── 2150 預收收入
│ │ ├── 2155 未開發票收貨
│ │ └── 2156 未開發票應收
│ ├── 215 代扣款項
│ │ ├── 2151 代扣所得稅
│ │ ├── 2152 代扣勞保費
│ │ ├── 2153 代扣健保費
│ │ └── 2154 扣繳稅款
│ └── 216 稅務負債
│ └── 2161 應付稅款
3 權益
├── 31 股本
├── 32 資本公積
└── 33 保留盈餘
4 營業收入
├── 41 銷貨收入
│ ├── 4111 銷貨收入
│ ├── 4113 銷貨折讓
│ ├── 4114 付款折扣收入
│ └── 4115 未開發票收入
└── 42 服務收入
5 營業成本
├── 51 銷貨成本
├── 52 製造成本
│ ├── 5211 直接原料
│ ├── 5212 直接人工
│ ├── 5213 製造費用
│ ├── 5214~5219 成本差異類
│ └── 5221~5224 委外及費用類
└── 53 倉庫成本
├── 5311 倉庫差異
├── 5312 存貨實際調整
└── 5313 存貨重估
6 營業費用
├── 61 推銷費用
└── 62 管理費用
├── 6211 薪資費用
├── 622 人事費用
│ ├── 6221 勞保費用
│ ├── 6222 健保費用
│ ├── 6223 勞退費用
│ ├── 6224 加班費
│ ├── 6225 獎金
│ ├── 6226 員工福利
│ ├── 6227 伙食費
│ └── 6228 員工費用
└── 623 銀行及現金費用
├── 6231 銀行費用
├── 6232 現金費用
├── 6233 現金差異
├── 6234 付款折扣費用
└── 6235 呆帳沖銷
7 營業外收支
├── 71 營業外收入
│ ├── 7111 利息收入
│ ├── 7114 未實現兌換利益
│ ├── 7116 已實現兌換利益
│ ├── 7117 銀行重估利益
│ ├── 7118 結算利益
│ └── 7121 現金收入
└── 72 營業外費用
├── 7211 利息費用
├── 7212 未實現兌換損失
├── 7214 已實現兌換損失
├── 7215 銀行重估損失
└── 7216 結算損失
8 所得稅費用
| 稅別 | 稅率 | 用途 |
|---|---|---|
| 應稅 5% | 5% | 一般商品/服務 |
| 零稅率 | 0% | 外銷商品 |
| 免稅 | 0% | 免稅商品 |
| 付款條件 | 天數 | 說明 |
|---|---|---|
| 現金 | 0 | 立即付款 |
| 月結30天 | 30 | 常見 B2B 條件 |
| 月結60天 | 60 | 大型客戶常用 |
| 銀行 | 帳號 | 幣別 |
|---|---|---|
| 台灣銀行 | 004-12345678 | TWD |
| 價格表 | 用途 | 說明 |
|---|---|---|
| 標準銷售價格表 | 銷售 | 一般客戶報價 |
| 標準採購價格表 | 採購 | 供應商成本價 |
| 員工價格表 | 內部 | 員工優惠價 |
包含多種商品類別的示範商品：
| 類別 | 商品範例 |
|---|---|
| 紙類 | A4 影印紙、信封、便條紙 |
| 書寫用品 | 原子筆、鉛筆、簽字筆 |
| 辦公用品 | 訂書機、膠水、剪刀 |
| 檔案用品 | 資料夾、檔案盒、標籤 |
| 電子產品 | USB 隨身碟、滑鼠、鍵盤 |
| 服務 | 顧問服務、維護服務 |
| 類型 | 數量 | 範例 |
|---|---|---|
| 客戶 | 7 家 | 誠品書店、全家便利商店、台北市政府 |
| 供應商 | 5 家 | 大同文具、永豐紙業、聯強電子 |
| 員工 | 3 位 | 王小明、李小華、陳大文 |
每個業務夥伴都包含：
- 統一編號（供應商/客戶）
- 完整地址（帳單/送貨地址）
- 付款條件設定
注意：由於 iDempiere 核心的
MInventoryLine.beforeSave()在新建 Client 時會因成本元素未完整設定而發生錯誤，目前初始庫存需要手動建立。建立方式：在完成初始設定後，請至
Material Management → Physical Inventory建立盤點單來設定初始庫存。
包含草稿狀態的示範單據，可體驗完整流程：
採購單（PO）800000 - 向大同文具採購：
| 商品 | 數量 | 單價 |
|---|---|---|
| A4 影印紙 | 50 | 120 |
| 藍色原子筆 | 100 | 15 |
| 訂書機 | 10 | 120 |
銷售訂單（SO）10000 - 銷售給誠品書店：
| 商品 | 數量 | 單價 |
|---|---|---|
| A4 影印紙 | 10 | 120 |
| 25K 筆記本 | 20 | 45 |
| 藍色原子筆 | 50 | 15 |
| A4 資料夾 | 30 | 25 |
# 從 GitHub Releases 下載
wget https://github.com/tm731531/idempiere-tw-init-tenant/releases/latest/download/tw.idempiere.sample.jar
# 或自行編譯
git clone https://github.com/tm731531/idempiere-tw-init-tenant.git
cd idempiere-tw-init-tenant
mvn clean package
# JAR 位於 target/tw.idempiere.sample-2.1.9.jar# 複製到 plugins 目錄
scp tw.idempiere.sample-2.1.0.jar user@your-server:/opt/idempiere/plugins/方式 A：使用 Web Console
- 開啟瀏覽器：
http://your-server:8080/osgi/system/console/bundles - 登入（預設：SuperUser/System）
- 點選「Install/Update」
- 選擇 JAR 檔案上傳
- 勾選「Start」
- 點選「Install or Update」
方式 B：使用 Telnet
telnet localhost 12612
# 或
ssh -p 12612 localhost
# 執行以下指令
install file:/opt/idempiere/plugins/tw.idempiere.sample-2.1.0.jar
# 記下回傳的 Bundle ID，例如 Bundle ID: 250
start 250# 在 OSGi Console 中
lb | grep -i taiwan
# 應該看到：250 | Active | tw.idempiere.sample# 複製 JAR 到 plugins 目錄
cp tw.idempiere.sample-2.1.0.jar /opt/idempiere/plugins/
# 重啟 iDempiere
sudo systemctl restart idempiere插件啟動後會自動執行以下動作（約需 30-60 秒）：
- ✅ 建立 Client「天地人實業有限公司」
- ✅ 建立 3 個組織（台北總公司、台中分公司、高雄倉庫）
- ✅ 建立 4 個倉庫
- ✅ 匯入 126 個台灣會計科目（含樹狀階層）
- ✅ 建立稅務設定（應稅、零稅率、免稅）
- ✅ 建立 3 個價格表
- ✅ 建立 31 項商品
- ✅ 建立 18 個業務夥伴
- ✅ 設定會計架構（成本法、帳期等）
| 項目 | 值 |
|---|---|
| Client | 天地人實業有限公司 |
| 管理員帳號 | SampleAdmin |
| 一般用戶帳號 | SampleUser |
| 初始密碼 | （查看 iDempiere server.log） |
- 開啟 iDempiere WebUI：
http://your-server:8080/webui/ - 輸入帳號密碼
- 選擇 Client：天地人實業有限公司
- 選擇組織：台北總公司（或其他）
- 選擇角色：管理員
- 開始使用！
有了示範資料，你可以立即練習 ERP 的核心流程：
採購申請 → 採購單 → 收貨 → 供應商發票 → 付款
| 步驟 | 操作 | 說明 |
|---|---|---|
| 1 | 建立採購單 | Menu → Purchase → Purchase Order |
| 2 | 選擇供應商 | 如：大同辦公用品 |
| 3 | 選擇商品 | 如：A4 影印紙，價格自動帶入 |
| 4 | 完成採購單 | 點選「Complete」 |
| 5 | 收貨 | 從採購單產生收貨單，選擇倉庫 |
| 6 | 供應商發票 | 從收貨單產生發票 |
| 7 | 付款 | 建立付款單沖銷應付帳款 |
報價單 → 銷售訂單 → 出貨 → 客戶發票 → 收款
| 步驟 | 操作 | 說明 |
|---|---|---|
| 1 | 建立銷售訂單 | Menu → Sales → Sales Order |
| 2 | 選擇客戶 | 如：台北科技公司 |
| 3 | 選擇商品 | 價格自動從價格表帶入 |
| 4 | 完成訂單 | 點選「Complete」 |
| 5 | 出貨 | 從訂單產生出貨單 |
| 6 | 客戶發票 | 從出貨單產生發票 |
| 7 | 收款 | 建立收款單沖銷應收帳款 |
| 功能 | 路徑 | 說明 |
|---|---|---|
| 庫存查詢 | Material Management → Storage Detail | 查看各倉庫即時庫存 |
| 庫存調撥 | Material Management → Movement | 在倉庫間移動商品 |
| 庫存盤點 | Material Management → Physical Inventory | 實體盤點並調整差異 |
| 功能 | 路徑 | 說明 |
|---|---|---|
| 傳票查詢 | Accounting → Journal Entries | 查看自動產生的會計傳票 |
| 科目餘額 | Accounting → Account Balance | 查看各科目餘額 |
| 試算表 | Accounting → Trial Balance | 產生試算表 |
| 財務報表 | Accounting → Financial Report | 資產負債表、損益表 |
| 項目 | ❌ 沒有插件 | ✅ 有插件 |
|---|---|---|
| 會計科目 | 美國 GAAP 標準（英文） | 台灣商業會計法規（中文） |
| 會計科目樹 | 英文科目名稱 | 中文，樹狀階層清楚 |
| 示範資料 | 無 | 完整的公司、商品、客戶、供應商 |
| 稅務設定 | 需要手動設定 | 已設定台灣常用稅率 |
| 價格表 | 需要手動建立 | 現成的銷售/採購價格表 |
| 學習曲線 | 需花大量時間建立基礎資料 | 立即開始學習 ERP 流程 |
| 測試環境 | 需手動建立測試資料 | 現成的測試資料 |
| 上手時間 | 數小時～數天 | 5 分鐘 |
| 對象 | 用途 |
|---|---|
| 🎓 ERP 學習者 | 快速建立學習環境，專注於流程學習 |
| 💼 系統導入顧問 | 展示 iDempiere 功能給客戶 |
| 👨💻 開發人員 | 測試客製化功能 |
| 🏢 企業評估者 | 評估 iDempiere 是否適合企業需求 |
| 📚 教育訓練 | ERP 課程教學使用 |
| 項目 | 需求 |
|---|---|
| iDempiere 版本 | 12.0.0+ |
| Java 版本 | 17+ |
| 資料庫 | PostgreSQL 14+ / Oracle |
| 授權 | GPL v2 |
idempiere-tw-init-tenant/
├── src/tw/idempiere/sample/
│ ├── Activator.java # OSGi 啟動器
│ ├── setup/
│ │ ├── SampleClientSetup.java # 主流程控制
│ │ ├── TaiwanCoASetup.java # 台灣會計科目（Import 機制）
│ │ ├── SampleOrgSetup.java # 組織和倉庫
│ │ ├── SampleTaxSetup.java # 稅務設定
│ │ ├── SamplePriceListSetup.java # 價格表
│ │ ├── SampleProductSetup.java # 商品
│ │ └── SampleBPSetup.java # 業務夥伴
│ └── util/
│ └── SetupLog.java # 日誌工具
├── data/
│ └── Accounting_tw.csv # 台灣會計科目表
├── META-INF/
│ └── MANIFEST.MF # OSGi Bundle 設定
├── OSGI-INF/
│ └── component.xml # DS 元件定義
└── pom.xml # Maven 建置設定
A: 請檢查 iDempiere server.log，搜尋 [TW-Sample] 查看建立過程的日誌。
A: 目前插件只會建立一個「天地人實業有限公司」。如需多個，請修改 SampleClientSetup.java 中的 CLIENT_NAME。
A: 目前需要手動刪除 Client。未來版本將提供清理功能。
A: 可以修改 data/Accounting_tw.csv 後重新編譯。
歡迎提交 Issue 和 Pull Request！
GNU General Public License v2
- 重大更新：完整對應 iDempiere Accounting Schema 全部 76 個 Default Account
- 新增 50 個會計科目，包含：
- 現金類：未分配現金、未確認款項、現金調撥、付款選擇
- 應收類：應收帳款-服務、員工預付款、稅務應收款
- 存貨類：存貨結轉、到岸成本結轉、倉庫存貨
- 專案類：專案資產、專案在製品
- 負債類：應付帳款-服務、預收收入、未開發票收貨、稅務負債、扣繳稅款
- 收入類：付款折扣收入、未開發票收入、已實現兌換利益、銀行重估利益、結算利益、現金收入
- 成本類：發票價格差異、平均成本差異、成本調整、委外加工、倉庫差異等
- 費用類：銀行費用、現金費用、現金差異、付款折扣費用、呆帳沖銷
- 損失類：已實現兌換損失、銀行重估損失、結算損失
- 新增：人事薪資相關會計科目
- 負債類：應付勞保費、應付健保費、應付勞退金、代扣所得稅、代扣勞保費、代扣健保費
- 費用類：勞保費用、健保費用、勞退費用、加班費、獎金、員工福利、伙食費
- 修正：解決 PO/SO 訂單明細無法建立的根本問題
- 根本原因：System Administrator (Role 0) 沒有權限存取新建 Client 的資料
- 修正方式：在建立訂單前設定正確的 AD_ROLE_ID 到 context
- 修正：跳過自動建立初始庫存（iDempiere 核心 MCostElement NPE 問題）
- 修正 P_FREIGHT_ACCT Default Account 不存在問題
- 改用系統預設 UOM (EA)
- 修正 UOM 建立為系統級別
- 修正商品不在價格表的驗證錯誤
- 修正必填欄位驗證問題
- 完整示範資料建立功能
- 台灣會計科目表（176 個科目）
- 31 項商品、18 個業務夥伴
- 3 個組織、4 個倉庫
- 示範採購單和銷售訂單
- GitHub: https://github.com/tm731531/idempiere-tw-init-tenant
- iDempiere 官網: https://www.idempiere.org/
- iDempiere 台灣社群: idempiere.tw