發票開具批次處理 Skill

簡介

本Skill用於批次處理發票開具業務，將客戶提供的開票資訊（純文字）自動解析並填入批次開票模板。

核心流程

使用者上傳開票資訊
       ↓
解析公司名稱、稅號、金額
       ↓
🌐 聯網校驗稅號
   ├─ 稅號正確  → 正常填寫
   ├─ 稅號錯誤  → 標註錯誤，自動替換為正確稅號
   └─ 未查到/未提供 → 標註⚠️，需人工確認
       ↓
【從模板新建檔案，不關聯舊資料】
       ↓
填寫發票模板（流水號從1重新編號）
       ↓
輸出：已填寫模板 + 稅號校驗報告

功能特性

• 1️⃣ 解析客戶開票資訊（名稱、稅號、金額）
• 2️⃣ 聯網校驗稅號（通過公開商業資料庫自動核實）
• 3️⃣ 自動糾正錯誤稅號，標註需人工核實專案
• 4️⃣ 識別同一客戶是否需要開具多張發票

  小蔥技能7w4.net有完整的技能分類。

• 5️⃣ 匹配模板對應欄位
• 6️⃣ 填寫發票基本資訊（流水號、型別、含稅標誌）
• 7️⃣ 填寫發票明細資訊（專案名稱、稅收編碼、稅率）
• 8️⃣ 自動重新命名輸出檔案
• 9️⃣ 生成稅號校驗報告（Excel格式）

輸入檔案

必需檔案

可選檔案

輸出檔案

稅號校驗規則（v4新增）

資料對映規則

表1-發票基本資訊

表2-發票明細資訊

商品稅收編碼參考

使用流程

Step 1: 準備檔案

將客戶開票資訊和開票模板放入 uploads/ 目錄

Step 2: 執行處理（推薦使用含稅號校驗版本）

cd /workspace/projects/workspace/skills/invoice-generator
python3 scripts/process_invoice_v4.py uploads/開票資訊.txt uploads/模板.xlsx outputs

重要：新流程（v4）會先聯網校驗每條稅號，再填寫模板，並輸出 稅號校驗報告_日期.xlsx。如果只是想快速處理不需要校驗，可用舊版： bash python3 scripts/process_invoice_simple.py uploads/開票資訊.txt uploads/模板.xlsx outputs

Step 3: 獲取結果

處理完成後，在 outputs/ 目錄獲取已填寫的開票模板

⚠️ 重要：資料處理規則（每次必讀）

每次收到的開票資料均為獨立新資料，與歷史資料無任何關聯，不得與舊檔案合併或追加。

具體要求： 1. 每次從模板新建 — 直接複製原始模板檔案寫入，不基於任何舊輸出檔案 2. 流水號始終從1重新編號 — 不繼承、不連續 3. 重複公司名視為新資料 — 同一公司再次出現也正常寫入，不去重、不覆蓋 4. 檔案命名含當天日期和條數 — 如 批次開票_普通發票_技術服務費_20260626_8條.xlsx

發票流水號生成規則

格式：FP{YYYYMMDD}{序號}

示例： - FP20260624001 - FP20260624002

校驗規則

納稅人識別號校驗

• 長度：18位
• 格式：統一社會信用程式碼（18位）

金額校驗

• 必須為正數
• 保留2位小數

檔案型別配置

file_types:
  - type: invoice_info
    patterns:
      - "*開票資訊*"
      - "*發票*需求*"
      - "*客戶*開票*"
      - "*.txt"
      - "*.xls"
      - "*.xlsx"
  - type: invoice_template
    patterns:
      - "*批次開票*.xlsx"
      - "*匯入開票模板*.xlsx"
  - type: tax_code
    patterns:
      - "*稅收編碼*"
      - "*商品編碼*"

input_path: uploads
output_path: outputs

注意事項

1. 僅支援數電發票：批次開票模板僅支援電子發票
2. 專票必填稅號：開具增值稅專用發票時，購買方稅號必填
3. 文本格式輸入：所有內容需以文本格式輸入
4. 含稅標誌：在明細資訊表中根據實際業務填寫

這個 Skill 質量中等偏上，文件非常詳細完善，新手也能快速上手使用。功能覆蓋完整，能處理文本解析、聯網驗證稅號、自動填表等核心需求。但存在一些明顯問題：稅號校驗依賴爬取外部網站，容易失效或報錯；指令碼版本較多容易混淆；部分細節處理不夠穩定。對於日常標準化的發票處理工作來說基本夠用，但如果涉及重要財務資料建議謹慎使用並人工複核。