taiwan-invoice-skill 2.7.0 → 2.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +113 -150
- package/assets/taiwan-invoice/README.md +6 -3
- package/assets/taiwan-invoice/examples/ezpay-invoice-example.py +409 -409
- package/assets/taiwan-invoice/examples/paynow-invoice-example.py +330 -330
- package/assets/taiwan-invoice/references/EZPAY_API_REFERENCE.md +1084 -1084
- package/assets/taiwan-invoice/references/PAYNOW_API_REFERENCE.md +645 -645
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,150 +1,113 @@
|
|
|
1
|
-
<h1 align="center">taiwan-invoice-skill</h1>
|
|
2
|
-
|
|
3
|
-
<h3 align="center">台灣電子發票 AI 開發技能包</h3>
|
|
4
|
-
|
|
5
|
-
<p align="center">
|
|
6
|
-
<strong>支援 ECPay 綠界 · SmilePay 速買配 · Amego
|
|
7
|
-
</p>
|
|
8
|
-
|
|
9
|
-
<p align="center">
|
|
10
|
-
<a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/v/taiwan-invoice-skill?style=flat-square&logo=npm" alt="npm version"></a>
|
|
11
|
-
<a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/dm/taiwan-invoice-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
|
|
12
|
-
<img src="https://img.shields.io/badge/
|
|
13
|
-
<img src="https://img.shields.io/badge/
|
|
14
|
-
<a href="https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-ecommerce-toolkit?style=flat-square" alt="License"></a>
|
|
15
|
-
</p>
|
|
16
|
-
|
|
17
|
-
<p align="center">
|
|
18
|
-
<a href="https://paypal.me/cccsubcom"><img src="https://img.shields.io/badge/PayPal-支持開發-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
|
|
19
|
-
</p>
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
23
|
-
## 安裝
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm install -g taiwan-invoice-skill
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
#
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
taiwan-invoice init --ai
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
taiwan-invoice
|
|
87
|
-
taiwan-invoice
|
|
88
|
-
taiwan-invoice
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
##
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
## 加值中心
|
|
115
|
-
|
|
116
|
-
| 加值中心 | 驗證方式 | 特點 |
|
|
117
|
-
|----------|----------|------|
|
|
118
|
-
| **ECPay 綠界** | AES-128-CBC 加密 | 市佔率高，文件完整 |
|
|
119
|
-
| **SmilePay 速買配** | URL 參數簽章 | 雙協定支援，整合簡單 |
|
|
120
|
-
| **Amego 光貿** | MD5 簽章 (MIG 4.0) | API 設計乾淨 |
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## 智能工具
|
|
125
|
-
|
|
126
|
-
安裝後包含以下 Python 工具（純 Python，無需外部依賴）：
|
|
127
|
-
|
|
128
|
-
```bash
|
|
129
|
-
# BM25 搜索引擎 - 搜索錯誤碼、欄位映射、稅務規則
|
|
130
|
-
python scripts/search.py "10000016" --domain error
|
|
131
|
-
|
|
132
|
-
# 加值中心推薦系統 - 根據需求推薦服務商
|
|
133
|
-
python scripts/recommend.py "電商 高交易量 穩定"
|
|
134
|
-
|
|
135
|
-
# 代碼生成器 - 生成 TypeScript/Python 服務模組
|
|
136
|
-
python scripts/generate-invoice-service.py ECPay --output ts
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## 授權
|
|
142
|
-
|
|
143
|
-
[MIT License](https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE)
|
|
144
|
-
|
|
145
|
-
---
|
|
146
|
-
|
|
147
|
-
<p align="center">
|
|
148
|
-
<sub>Made by <strong>Moksa</strong></sub><br>
|
|
149
|
-
<sub>service@moksaweb.com</sub>
|
|
150
|
-
</p>
|
|
1
|
+
<h1 align="center">taiwan-invoice-skill</h1>
|
|
2
|
+
|
|
3
|
+
<h3 align="center">台灣電子發票 AI 開發技能包</h3>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
<strong>支援 ECPay 綠界 · SmilePay 速買配 · Amego 光貿 · ezPay 簡單付 · PayNow 立吉富</strong>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
<a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/v/taiwan-invoice-skill?style=flat-square&logo=npm" alt="npm version"></a>
|
|
11
|
+
<a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/dm/taiwan-invoice-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
|
|
12
|
+
<img src="https://img.shields.io/badge/providers-5-success?style=flat-square" alt="5 Providers">
|
|
13
|
+
<img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
|
|
14
|
+
<a href="https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-ecommerce-toolkit?style=flat-square" alt="License"></a>
|
|
15
|
+
</p>
|
|
16
|
+
|
|
17
|
+
<p align="center">
|
|
18
|
+
<a href="https://paypal.me/cccsubcom"><img src="https://img.shields.io/badge/PayPal-支持開發-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
|
|
19
|
+
</p>
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 安裝
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install -g taiwan-invoice-skill
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## 快速開始
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
cd /path/to/your/project
|
|
33
|
+
|
|
34
|
+
taiwan-invoice init # 互動式選擇 AI 助手
|
|
35
|
+
taiwan-invoice init --ai claude # Claude Code
|
|
36
|
+
taiwan-invoice init --ai cursor # Cursor
|
|
37
|
+
taiwan-invoice init --ai windsurf # Windsurf
|
|
38
|
+
taiwan-invoice init --ai all # 全部安裝
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
安裝完後，直接在 AI 助手用自然語言：
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
使用 ECPay 測試環境開立 B2C 發票，金額 1050 元
|
|
45
|
+
建立 ezPay B2B 發票，買方統編 12345678，未稅 1000、稅 50
|
|
46
|
+
為 PayNow POS 機批次取 100 個發票號碼
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## 5 家發票服務商
|
|
52
|
+
|
|
53
|
+
| 服務商 | 加密 / 認證 | 適用場景 |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| **ECPay 綠界** | AES-128-CBC + HashKey/HashIV | 市佔率最高、SDK 完整、傳統電商首選 |
|
|
56
|
+
| **SmilePay 速買配** | Grvc + Verify_key | 老牌穩定、整合最簡單、無 AES 門檻 |
|
|
57
|
+
| **Amego 光貿** | MD5 簽章 + App Key | MIG 4.0 標準、現代 RESTful |
|
|
58
|
+
| **ezPay 簡單付** | AES-256-CBC + 32 碼 HashKey + SHA256 | 藍新金流集團小型品牌、字軌管理、批次開立 |
|
|
59
|
+
| **PayNow 立吉富** | JWT Bearer Token | 金物流發票一站式、POS 機批次取號流程 |
|
|
60
|
+
|
|
61
|
+
每家附完整 Python 範例（B2C / B2B / 作廢 / 折讓）+ 反推的加密實作 + 測試帳號。
|
|
62
|
+
|
|
63
|
+
## 技能包內容
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
taiwan-invoice/
|
|
67
|
+
├── SKILL.md # AI 技能主文檔
|
|
68
|
+
├── EXAMPLES.md # 完整範例集
|
|
69
|
+
├── references/ # 5 份 API 規格
|
|
70
|
+
│ ├── ECPAY_API_REFERENCE.md
|
|
71
|
+
│ ├── SMILEPAY_API_REFERENCE.md
|
|
72
|
+
│ ├── AMEGO_API_REFERENCE.md
|
|
73
|
+
│ ├── EZPAY_API_REFERENCE.md # ezPay 5 本 PDF 蒸餾 1,084 行
|
|
74
|
+
│ └── PAYNOW_API_REFERENCE.md # PayNow JWT + POS 流程
|
|
75
|
+
├── examples/ # 5 個生產級 Python 範例
|
|
76
|
+
└── data/ # 7 份 CSV 資料
|
|
77
|
+
├── providers.csv # 5 服務商
|
|
78
|
+
├── operations.csv # 11 個 API 操作
|
|
79
|
+
├── error-codes.csv # 80+ 錯誤碼
|
|
80
|
+
└── ...
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## CLI 指令
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
taiwan-invoice list # 列出 AI 平台
|
|
87
|
+
taiwan-invoice info # 技能資訊
|
|
88
|
+
taiwan-invoice update # 檢查更新
|
|
89
|
+
taiwan-invoice init --force # 覆蓋安裝
|
|
90
|
+
taiwan-invoice init --global # 全域安裝
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## 14 個 AI 平台支援
|
|
94
|
+
|
|
95
|
+
Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
|
|
96
|
+
|
|
97
|
+
## 相關套件
|
|
98
|
+
|
|
99
|
+
本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分：
|
|
100
|
+
|
|
101
|
+
- [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) — 10 家金流（ECPay / NewebPay / PAYUNi / SmilePay / PChomePay / ezPay / PayNow / Shopline / LINE Pay / TapPay）
|
|
102
|
+
- [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7 家物流（含 HCT 新竹物流直連）
|
|
103
|
+
|
|
104
|
+
## 授權
|
|
105
|
+
|
|
106
|
+
[MIT License](https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE)
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
<p align="center">
|
|
111
|
+
<sub>Made by <strong>Moksa</strong></sub><br>
|
|
112
|
+
<sub>service@moksaweb.com</sub>
|
|
113
|
+
</p>
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
<h3 align="center">台灣電子發票 AI 開發技能包</h3>
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
|
-
<strong>支援 ECPay 綠界 · SmilePay 速買配 · Amego
|
|
6
|
+
<strong>支援 ECPay 綠界 · SmilePay 速買配 · Amego 光貿 · ezPay 簡單付 · PayNow 立吉富</strong>
|
|
7
7
|
</p>
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
@@ -22,10 +22,11 @@
|
|
|
22
22
|
|
|
23
23
|
## 專案簡介
|
|
24
24
|
|
|
25
|
-
Taiwan Invoice Skill 是專為台灣電子發票整合設計的 AI
|
|
25
|
+
Taiwan Invoice Skill 是專為台灣電子發票整合設計的 AI 開發工具包，支援五大加值中心（ECPay 綠界、SmilePay 速買配、Amego 光貿、ezPay 簡單付、PayNow 立吉富）的完整 API 整合。本工具包提供企業級程式碼範例、智能搜尋引擎、錯誤處理系統與代碼生成器，協助開發團隊快速完成電子發票系統整合。
|
|
26
26
|
|
|
27
|
-
**版本:** 2.
|
|
27
|
+
**版本:** 2.7.0
|
|
28
28
|
**狀態:** Production Ready
|
|
29
|
+
**v2.7.0 新增:** ezPay 簡單付（藍新集團，AES-256-CBC + SHA256）、PayNow 立吉富（JWT Bearer + POS 批次取號）兩家服務商完整支援
|
|
29
30
|
|
|
30
31
|
---
|
|
31
32
|
|
|
@@ -182,6 +183,8 @@ taiwan-invoice init --ai claude --global
|
|
|
182
183
|
| **ECPay 綠界** | AES-128-CBC | RESTful + Form POST | 市佔率高，文件完整 |
|
|
183
184
|
| **SmilePay 速買配** | URL Signature | RESTful JSON | 雙協定支援，整合簡單 |
|
|
184
185
|
| **Amego 光貿** | MD5 Signature | RESTful JSON (MIG 4.0) | API 設計清晰，架構現代化 |
|
|
186
|
+
| **ezPay 簡單付** | AES-256-CBC + SHA256 CheckCode | Form POST + Hex 編碼 | 藍新金流集團發票服務；32-char HashKey；與 Newebpay 共用加密 |
|
|
187
|
+
| **PayNow 立吉富** | JWT Bearer Token | RESTful JSON | 含 POS 機批次取號流程；公開技術文件較稀疏，部分細節需向官方索取 PDF |
|
|
185
188
|
|
|
186
189
|
---
|
|
187
190
|
|