財務會計憑證生成器 (finance-ledger-generator)

技能概述

本技能用於生成符合主流財務軟體（金蝶、用友、SAP、Oracle等）匯入格式的會計憑證檔案。支援：

• 賬簿清單管理
• 科目編碼與全稱管理
• 核算規則自動學習與使用者修正
• 客戶、供應商、員工等輔助核算項管理
• 多幣種匯率管理
• Excel模板檔案生成
• JSON格式本地資料儲存

核心資料結構

1. 賬簿清單 (ledger_books.json)

儲存賬簿資訊，包括賬簿編碼、名稱、啟用日期等。

2. 科目檔案 (account_codes.json)

儲存科目資訊，包括科目編碼、科目名稱、科目類別、是否需要輔助核算等。

3. 核算規則 (accounting_rules.json)

儲存自動學習的核算規則，包括：

• 原始欄位到目標科目的對映
• 取數規則（從原始檔哪個欄位取值）
• 資料轉換規則

4. 客戶清單 (customers.json)

儲存客戶資訊，用於輔助核算。

5. 供應商清單 (suppliers.json)

儲存供應商資訊，用於輔助核算。

6. 員工清單 (employees.json)

儲存員工資訊，用於輔助核算。

7. 匯率表 (exchange_rates.json)

儲存匯率資訊，支援多幣種核算。

初始化流程

首次使用本技能時，需要引導客戶完成基礎資料初始化：

第一步：上傳賬簿清單

1. 提示客戶上傳賬簿清單檔案（Excel或JSON格式）
2. 若客戶無模板，提供標準模板下載
3. 解析並存儲賬簿資料到 ledger_books.json

第二步：上傳科目編碼與全稱

1. 提示客戶上傳科目檔案檔案
2. 若客戶使用金蝶/用友，可提供對應軟體的科目模板
3. 解析並存儲科目資料到 account_codes.json

第三步：學習核算規則（可選但推薦）

1. 提示客戶上傳歷史明細賬或財務核算手冊
2. 自動分析歷史資料，推斷核算規則
3. 展示推斷的規則供客戶確認
4. 客戶可修正不準確的規則
5. 儲存最終規則到 accounting_rules.json

第四步：上傳輔助核算資料

1. 客戶清單（customers.json）
2. 供應商清單（suppliers.json）
3. 員工清單（employees.json）
4. 其他輔助資料

第五步：配置匯率（如需多幣種）

上傳匯率表或手動維護匯率資料

憑證生成流程

輸入

客戶上傳原始業務資料檔案（Excel、CSV等），例如：

• 銀行回單
• 發票清單
• 報銷單據
• 採購/銷售資料

處理步驟

1. 讀取原始檔

   • 使用 pandas 讀取上傳的業務資料檔案
   • 識別列名和資料型別

2. 匹配核算規則

   • 根據業務型別自動匹配核算規則
   • 對於無法匹配的欄位，標記待確認

3. 生成憑證分錄

   • 根據規則對映生成借方和貸方分錄
   • 自動補充輔助核算資訊
   • 應用匯率轉換（如適用）

4. 生成Excel模板

   • 使用 openpyxl 在執行時動態生成符合目標財務軟體的Excel檔案
   • 支援金蝶、用友、SAP、Oracle四種格式
   • 模板欄位規範詳見 assets/template_format.md

5. 輸出檔案

   • 生成可直接匯入財務軟體的Excel檔案
   • 生成規則應用報告，列出所有對映關係

資料儲存結構

所有資料以 JSON 格式儲存在 skill 資料目錄：

~/.workbuddy/skills/finance-ledger-generator/data/
├── ledger_books.json       # 賬簿清單
├── account_codes.json      # 科目檔案
├── accounting_rules.json   # 核算規則
├── customers.json          # 客戶清單
├── suppliers.json          # 供應商清單
├── employees.json          # 員工清單
├── exchange_rates.json     # 匯率表
├── auxiliary_data.json     # 其他輔助資料
└── meta.json               # 後設資料（版本、上次更新時間等）

Excel模板格式

憑證表頭欄位（通用）

憑證分錄欄位（通用）

*借方金額和貸方金額至少填寫一項

支援的財務軟體格式

金蝶K/3 Cloud

• 憑證模板：K3_Voucher_Template.xlsx
• 匯入方式：標準Excel匯入

用友U8/U9

• 憑證模板：Yonyou_Voucher_Template.xlsx
• 匯入方式：UFO報表格式

SAP

• 憑證模板：SAP_BAPI_Template.xlsx
• 匯入方式：FBV0事務碼匯入

Oracle Fusion

• 憑證模板：Oracle_Journal_Template.xlsx
• 匯入方式：REST API或電子表格匯入

核算規則學習機制

自動推斷規則

1. 分析歷史明細賬資料
2. 識別交易型別與科目的對應關係
3. 學習金額欄位的取數來源
4. 學習輔助核算項的匹配邏輯

使用者修正規則

1. 展示推斷的規則列表
2. 使用者可編輯任意規則
3. 支援新增新規則
4. 支援刪除不需要的規則
5. 修正後的規則自動儲存

規則優先順序

1. 使用者自定義規則（最高優先順序）
2. 自動學習的規則
3. 系統預設規則（最低優先順序）

輔助核算項管理

支援的輔助核算型別

• 客戶核算
• 供應商核算
• 員工核算
• 專案核算
• 部門核算
• 合同核算

資料來源

• 客戶上傳清單檔案
• 手動錄入
• 從歷史憑證自動提取

使用示例

示例1：初始化基礎資料

使用者：幫我初始化財務憑證生成的基礎資料
助手：
1. 引導上傳賬簿清單
2. 引導上傳科目檔案
3. 引導上傳歷史明細賬學習核算規則
4. 引導上傳客戶/供應商/員工清單
5. 配置匯率表

示例2：生成憑證

更多技能請訪問小蔥技能站7w4.net。

使用者：幫我把這張銀行回單轉換成金蝶憑證
助手：
1. 讀取銀行回單內容
2. 根據核算規則生成憑證分錄
3. 匹配客戶/供應商資訊
4. 生成Excel格式的金蝶憑證檔案
5. 提供下載連結

示例3：學習新規則

使用者：上傳了新的財務核算手冊，幫我更新核算規則
助手：
1. 解析新的財務核算手冊
2. 與現有規則對比
3. 標註新增和修改的規則
4. 展示規則供使用者確認
5. 儲存確認後的規則

相關檔案

• 初始化指令碼：scripts/init_data.py
• 資料管理指令碼：scripts/data_manager.py
• 憑證生成指令碼：scripts/voucher_generator.py
• 規則學習指令碼：scripts/rule_learner.py
• 資料結構參考：references/data_schema.md
• 模板格式說明：assets/template_format.md（執行時動態生成Excel模板）

這是一個功能較完善的財務憑證生成工具，能幫助使用者從業務資料自動生成符合多種財務軟體格式的憑證。支援科目對映、輔助核算、多幣種等會計場景，並能從歷史資料學習核算規則。不過目前缺少示例資料，實際使用前需要一定的初始化配置。對於規則學習的準確性，建議首次使用時仔細核對生成結果。