taiwan-invoice-skill
v2.7.1
Published
AI-powered Taiwan E-Invoice toolkit. Supports ECPay, SmilePay, Amego, ezPay, and PayNow with full B2C/B2B issuance, void, allowance, and POS batch flows.
Maintainers
moksaReadme
安裝
npm install -g taiwan-invoice-skill快速開始
cd /path/to/your/project
taiwan-invoice init # 互動式選擇 AI 助手
taiwan-invoice init --ai claude # Claude Code
taiwan-invoice init --ai cursor # Cursor
taiwan-invoice init --ai windsurf # Windsurf
taiwan-invoice init --ai all # 全部安裝安裝完後，直接在 AI 助手用自然語言：
使用 ECPay 測試環境開立 B2C 發票，金額 1050 元
建立 ezPay B2B 發票，買方統編 12345678，未稅 1000、稅 50
為 PayNow POS 機批次取 100 個發票號碼5 家發票服務商
| 服務商 | 加密 / 認證 | 適用場景 | |---|---|---| | ECPay 綠界 | AES-128-CBC + HashKey/HashIV | 市佔率最高、SDK 完整、傳統電商首選 | | SmilePay 速買配 | Grvc + Verify_key | 老牌穩定、整合最簡單、無 AES 門檻 | | Amego 光貿 | MD5 簽章 + App Key | MIG 4.0 標準、現代 RESTful | | ezPay 簡單付 | AES-256-CBC + 32 碼 HashKey + SHA256 | 藍新金流集團小型品牌、字軌管理、批次開立 | | PayNow 立吉富 | JWT Bearer Token | 金物流發票一站式、POS 機批次取號流程 |
每家附完整 Python 範例（B2C / B2B / 作廢 / 折讓）+ 反推的加密實作 + 測試帳號。
技能包內容
taiwan-invoice/
├── SKILL.md # AI 技能主文檔
├── EXAMPLES.md # 完整範例集
├── references/ # 5 份 API 規格
│ ├── ECPAY_API_REFERENCE.md
│ ├── SMILEPAY_API_REFERENCE.md
│ ├── AMEGO_API_REFERENCE.md
│ ├── EZPAY_API_REFERENCE.md # ezPay 5 本 PDF 蒸餾 1,084 行
│ └── PAYNOW_API_REFERENCE.md # PayNow JWT + POS 流程
├── examples/ # 5 個生產級 Python 範例
└── data/ # 7 份 CSV 資料
├── providers.csv # 5 服務商
├── operations.csv # 11 個 API 操作
├── error-codes.csv # 80+ 錯誤碼
└── ...CLI 指令
taiwan-invoice list # 列出 AI 平台
taiwan-invoice info # 技能資訊
taiwan-invoice update # 檢查更新
taiwan-invoice init --force # 覆蓋安裝
taiwan-invoice init --global # 全域安裝14 個 AI 平台支援
Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
相關套件
本套件是 Taiwan E-Commerce Toolkit 的一部分：
- taiwan-payment-skill — 10 家金流（ECPay / NewebPay / PAYUNi / SmilePay / PChomePay / ezPay / PayNow / Shopline / LINE Pay / TapPay）
- taiwan-logistics-skill — 7 家物流（含 HCT 新竹物流直連）