taiwan-logistics-skill 1.2.1 → 1.2.2
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 +132 -132
- package/assets/taiwan-logistics/EXAMPLES.md +75 -0
- package/assets/taiwan-logistics/README.md +68 -342
- package/assets/taiwan-logistics/examples/hct-logistics-example.py +288 -0
- package/assets/taiwan-logistics/examples/paynow-logistics-cvs-example.py +263 -0
- package/assets/taiwan-logistics/examples/pchomepay-logistics-cvs-example.py +255 -0
- package/assets/taiwan-logistics/examples/smilepay-logistics-cvs-example.py +298 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,132 +1,132 @@
|
|
|
1
|
-
<h1 align="center">taiwan-logistics-skill</h1>
|
|
2
|
-
|
|
3
|
-
<h3 align="center">台灣物流 AI 開發技能包</h3>
|
|
4
|
-
|
|
5
|
-
<p align="center">
|
|
6
|
-
<strong>6 家物流 aggregator + HCT 新竹物流直連 carrier API</strong>
|
|
7
|
-
</p>
|
|
8
|
-
|
|
9
|
-
<p align="center">
|
|
10
|
-
ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · HCT 直連
|
|
11
|
-
</p>
|
|
12
|
-
|
|
13
|
-
<p align="center">
|
|
14
|
-
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/v/taiwan-logistics-skill?style=flat-square&logo=npm" alt="npm version"></a>
|
|
15
|
-
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/dm/taiwan-logistics-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
|
|
16
|
-
<img src="https://img.shields.io/badge/providers-7-success?style=flat-square" alt="7 Providers">
|
|
17
|
-
<img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
|
|
18
|
-
<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>
|
|
19
|
-
</p>
|
|
20
|
-
|
|
21
|
-
<p align="center">
|
|
22
|
-
<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>
|
|
23
|
-
</p>
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 安裝
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
npm install -g taiwan-logistics-skill
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
## 快速開始
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
cd /path/to/your/project
|
|
37
|
-
|
|
38
|
-
taiwan-logistics init # 互動式
|
|
39
|
-
taiwan-logistics init --ai claude # Claude Code
|
|
40
|
-
taiwan-logistics init --ai all # 全部安裝
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
安裝完後,在 AI 助手用自然語言:
|
|
44
|
-
|
|
45
|
-
```
|
|
46
|
-
查詢台北市信義區的 7-11 取貨點,整合 ECPay 物流
|
|
47
|
-
建立 SmilePay 黑貓宅急便冷凍 C2C 訂單,COD 1000 元
|
|
48
|
-
PChomePay 7-11 取貨付款,金額 1500 元,notify URL 設好
|
|
49
|
-
PayNow 7-11 大宗寄倉,使用 3DES 加密
|
|
50
|
-
HCT 直連 API 傳入託運資料,逆物流單獨處理
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
55
|
-
## 7 家物流服務商
|
|
56
|
-
|
|
57
|
-
| 服務商 | 類型 | 加密 / 認證 | 特色 |
|
|
58
|
-
|---|---|---|---|
|
|
59
|
-
| **ECPay 綠界** | aggregator | MD5 CheckMacValue | 市佔率最高、SDK 完整、7-11/全家/萊爾富/OK/黑貓/宅配通/HCT |
|
|
60
|
-
| **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11/全家/萊爾富/OK/黑貓 |
|
|
61
|
-
| **PAYUNi 統一** | aggregator | AES-256-GCM + SHA256 | 7-11 常溫/冷凍 + T-Cat 常溫/冷藏/冷凍(溫控配送最完整) |
|
|
62
|
-
| **SmilePay 速買配** | aggregator | Verify_key + 加權檢核碼 | Pay_zg 矩陣 51/52/55/56/81/82/83,含逆物流 |
|
|
63
|
-
| **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、Notify IP 113.196.231.190、4 大超商 |
|
|
64
|
-
| **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
|
|
65
|
-
| **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 直連 carrier API(vs 透過 aggregator) |
|
|
66
|
-
|
|
67
|
-
## 技能包內容
|
|
68
|
-
|
|
69
|
-
```
|
|
70
|
-
taiwan-logistics/
|
|
71
|
-
├── SKILL.md # AI 技能主文檔
|
|
72
|
-
├── EXAMPLES.md # 實戰範例集
|
|
73
|
-
├── references/ # 7 份 API 規格 (~10,300 行)
|
|
74
|
-
│ ├── ecpay-logistics-api.md
|
|
75
|
-
│ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
|
|
76
|
-
│ ├── payuni-logistics-api.md
|
|
77
|
-
│ ├── smilepay-logistics-api.md # 1,332 行 / Pay_zg 矩陣
|
|
78
|
-
│ ├── pchomepay-logistics-api.md # 1,154 行 / NDJSON 對帳 parser
|
|
79
|
-
│ ├── paynow-logistics-api.md # 1,670 行 / 11 產品線
|
|
80
|
-
│ └── hct-logistics-api.md # 1,102 行 / 直連 HCT
|
|
81
|
-
├── examples/ # Python 範例
|
|
82
|
-
└── data/ # 5 份 CSV
|
|
83
|
-
├── providers.csv # 7 服務商
|
|
84
|
-
├── operations.csv # 30+ API 操作
|
|
85
|
-
├── logistics-types.csv # CVS / Home / 溫控
|
|
86
|
-
├── status-codes.csv # 跨服務商狀態碼
|
|
87
|
-
└── field-mappings.csv # 欄位對照
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
## CLI 指令
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
taiwan-logistics list # 列出 AI 平台
|
|
94
|
-
taiwan-logistics info # 技能資訊
|
|
95
|
-
taiwan-logistics update # 檢查更新
|
|
96
|
-
taiwan-logistics init --force # 覆蓋安裝
|
|
97
|
-
taiwan-logistics init --global # 全域安裝
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
## 14 個 AI 平台支援
|
|
101
|
-
|
|
102
|
-
Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
|
|
103
|
-
|
|
104
|
-
## 物流類型支援矩陣
|
|
105
|
-
|
|
106
|
-
| 取貨方式 | 7-11 | 全家 | 萊爾富 | OK | 黑貓 | 海外 | HCT |
|
|
107
|
-
|---|---|---|---|---|---|---|---|
|
|
108
|
-
| ECPay | ✅ | ✅ | ✅ | ✅ | ✅(常溫) | — | ✅ |
|
|
109
|
-
| NewebPay | ✅ | ✅ | ✅ | ✅ | ✅ | — | — |
|
|
110
|
-
| PAYUNi | ✅ | — | — | — | ✅(常溫/冷凍/冷藏) | — | — |
|
|
111
|
-
| SmilePay | ✅ C2C+B2C | ✅ C2C+B2C | — | — | ✅(COD/PICKUP/逆物流) | — | — |
|
|
112
|
-
| PChomePay | ✅ | ✅ | ✅ | ✅ | — | — | — |
|
|
113
|
-
| PayNow | ✅(含冷凍) | ✅(含冷凍) | ✅ | ✅ | ✅(宅配 + 店到店) | ✅(7-11) | — |
|
|
114
|
-
| HCT 直連 | — | — | — | — | — | — | ✅(直連) |
|
|
115
|
-
|
|
116
|
-
## 相關套件
|
|
117
|
-
|
|
118
|
-
本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
|
|
119
|
-
|
|
120
|
-
- [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 5 家電子發票
|
|
121
|
-
- [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) — 10 家金流
|
|
122
|
-
|
|
123
|
-
## 授權
|
|
124
|
-
|
|
125
|
-
[MIT License](https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE)
|
|
126
|
-
|
|
127
|
-
---
|
|
128
|
-
|
|
129
|
-
<p align="center">
|
|
130
|
-
<sub>Made by <strong>Moksa</strong></sub><br>
|
|
131
|
-
<sub>service@moksaweb.com</sub>
|
|
132
|
-
</p>
|
|
1
|
+
<h1 align="center">taiwan-logistics-skill</h1>
|
|
2
|
+
|
|
3
|
+
<h3 align="center">台灣物流 AI 開發技能包</h3>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
<strong>6 家物流 aggregator + HCT 新竹物流直連 carrier API</strong>
|
|
7
|
+
</p>
|
|
8
|
+
|
|
9
|
+
<p align="center">
|
|
10
|
+
ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · HCT 直連
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p align="center">
|
|
14
|
+
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/v/taiwan-logistics-skill?style=flat-square&logo=npm" alt="npm version"></a>
|
|
15
|
+
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/dm/taiwan-logistics-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
|
|
16
|
+
<img src="https://img.shields.io/badge/providers-7-success?style=flat-square" alt="7 Providers">
|
|
17
|
+
<img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
|
|
18
|
+
<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>
|
|
19
|
+
</p>
|
|
20
|
+
|
|
21
|
+
<p align="center">
|
|
22
|
+
<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>
|
|
23
|
+
</p>
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 安裝
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm install -g taiwan-logistics-skill
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## 快速開始
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
cd /path/to/your/project
|
|
37
|
+
|
|
38
|
+
taiwan-logistics init # 互動式
|
|
39
|
+
taiwan-logistics init --ai claude # Claude Code
|
|
40
|
+
taiwan-logistics init --ai all # 全部安裝
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
安裝完後,在 AI 助手用自然語言:
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
查詢台北市信義區的 7-11 取貨點,整合 ECPay 物流
|
|
47
|
+
建立 SmilePay 黑貓宅急便冷凍 C2C 訂單,COD 1000 元
|
|
48
|
+
PChomePay 7-11 取貨付款,金額 1500 元,notify URL 設好
|
|
49
|
+
PayNow 7-11 大宗寄倉,使用 3DES 加密
|
|
50
|
+
HCT 直連 API 傳入託運資料,逆物流單獨處理
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## 7 家物流服務商
|
|
56
|
+
|
|
57
|
+
| 服務商 | 類型 | 加密 / 認證 | 特色 |
|
|
58
|
+
|---|---|---|---|
|
|
59
|
+
| **ECPay 綠界** | aggregator | MD5 CheckMacValue | 市佔率最高、SDK 完整、7-11/全家/萊爾富/OK/黑貓/宅配通/HCT |
|
|
60
|
+
| **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11/全家/萊爾富/OK/黑貓 |
|
|
61
|
+
| **PAYUNi 統一** | aggregator | AES-256-GCM + SHA256 | 7-11 常溫/冷凍 + T-Cat 常溫/冷藏/冷凍(溫控配送最完整) |
|
|
62
|
+
| **SmilePay 速買配** | aggregator | Verify_key + 加權檢核碼 | Pay_zg 矩陣 51/52/55/56/81/82/83,含逆物流 |
|
|
63
|
+
| **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、Notify IP 113.196.231.190、4 大超商 |
|
|
64
|
+
| **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
|
|
65
|
+
| **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 直連 carrier API(vs 透過 aggregator) |
|
|
66
|
+
|
|
67
|
+
## 技能包內容
|
|
68
|
+
|
|
69
|
+
```
|
|
70
|
+
taiwan-logistics/
|
|
71
|
+
├── SKILL.md # AI 技能主文檔
|
|
72
|
+
├── EXAMPLES.md # 實戰範例集
|
|
73
|
+
├── references/ # 7 份 API 規格 (~10,300 行)
|
|
74
|
+
│ ├── ecpay-logistics-api.md
|
|
75
|
+
│ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
|
|
76
|
+
│ ├── payuni-logistics-api.md
|
|
77
|
+
│ ├── smilepay-logistics-api.md # 1,332 行 / Pay_zg 矩陣
|
|
78
|
+
│ ├── pchomepay-logistics-api.md # 1,154 行 / NDJSON 對帳 parser
|
|
79
|
+
│ ├── paynow-logistics-api.md # 1,670 行 / 11 產品線
|
|
80
|
+
│ └── hct-logistics-api.md # 1,102 行 / 直連 HCT
|
|
81
|
+
├── examples/ # Python 範例
|
|
82
|
+
└── data/ # 5 份 CSV
|
|
83
|
+
├── providers.csv # 7 服務商
|
|
84
|
+
├── operations.csv # 30+ API 操作
|
|
85
|
+
├── logistics-types.csv # CVS / Home / 溫控
|
|
86
|
+
├── status-codes.csv # 跨服務商狀態碼
|
|
87
|
+
└── field-mappings.csv # 欄位對照
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## CLI 指令
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
taiwan-logistics list # 列出 AI 平台
|
|
94
|
+
taiwan-logistics info # 技能資訊
|
|
95
|
+
taiwan-logistics update # 檢查更新
|
|
96
|
+
taiwan-logistics init --force # 覆蓋安裝
|
|
97
|
+
taiwan-logistics init --global # 全域安裝
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## 14 個 AI 平台支援
|
|
101
|
+
|
|
102
|
+
Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
|
|
103
|
+
|
|
104
|
+
## 物流類型支援矩陣
|
|
105
|
+
|
|
106
|
+
| 取貨方式 | 7-11 | 全家 | 萊爾富 | OK | 黑貓 | 海外 | HCT |
|
|
107
|
+
|---|---|---|---|---|---|---|---|
|
|
108
|
+
| ECPay | ✅ | ✅ | ✅ | ✅ | ✅(常溫) | — | ✅ |
|
|
109
|
+
| NewebPay | ✅ | ✅ | ✅ | ✅ | ✅ | — | — |
|
|
110
|
+
| PAYUNi | ✅ | — | — | — | ✅(常溫/冷凍/冷藏) | — | — |
|
|
111
|
+
| SmilePay | ✅ C2C+B2C | ✅ C2C+B2C | — | — | ✅(COD/PICKUP/逆物流) | — | — |
|
|
112
|
+
| PChomePay | ✅ | ✅ | ✅ | ✅ | — | — | — |
|
|
113
|
+
| PayNow | ✅(含冷凍) | ✅(含冷凍) | ✅ | ✅ | ✅(宅配 + 店到店) | ✅(7-11) | — |
|
|
114
|
+
| HCT 直連 | — | — | — | — | — | — | ✅(直連) |
|
|
115
|
+
|
|
116
|
+
## 相關套件
|
|
117
|
+
|
|
118
|
+
本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
|
|
119
|
+
|
|
120
|
+
- [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 5 家電子發票
|
|
121
|
+
- [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) — 10 家金流
|
|
122
|
+
|
|
123
|
+
## 授權
|
|
124
|
+
|
|
125
|
+
[MIT License](https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE)
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
<p align="center">
|
|
130
|
+
<sub>Made by <strong>Moksa</strong></sub><br>
|
|
131
|
+
<sub>service@moksaweb.com</sub>
|
|
132
|
+
</p>
|
|
@@ -3181,3 +3181,78 @@ try {
|
|
|
3181
3181
|
**Total Lines**: 1400+
|
|
3182
3182
|
|
|
3183
3183
|
This comprehensive guide covers all major NewebPay Logistics integration scenarios with production-ready code examples.
|
|
3184
|
+
|
|
3185
|
+
---
|
|
3186
|
+
|
|
3187
|
+
## SmilePay 速買配物流範例
|
|
3188
|
+
|
|
3189
|
+
SmilePay 透過 `Pay_zg` 矩陣編碼涵蓋 7-11/全家 + 黑貓三大配送:
|
|
3190
|
+
|
|
3191
|
+
| Pay_zg | 用途 |
|
|
3192
|
+
|---|---|
|
|
3193
|
+
| 51 / 52 | C2C COD / PICKUP |
|
|
3194
|
+
| 55 / 56 | B2C COD / PICKUP |
|
|
3195
|
+
| 81 / 82 | TCAT 黑貓 COD / PICKUP |
|
|
3196
|
+
| 83 | TCAT 逆物流 |
|
|
3197
|
+
|
|
3198
|
+
完整範例見 [`examples/smilepay-logistics-cvs-example.py`](examples/smilepay-logistics-cvs-example.py)。
|
|
3199
|
+
|
|
3200
|
+
### 三大要點
|
|
3201
|
+
|
|
3202
|
+
1. **Pay_subzg**:`7NET` 對應 7-11、`FAMI` 對應全家。
|
|
3203
|
+
2. **回應是 XML**:用 `xml.etree.ElementTree` parse;常用欄位 `Status` / `PaymentNo` / `Smseid` / `Storeid`。
|
|
3204
|
+
3. **電子地圖選店**:先導轉到 `LogisticsEmap.asp`,客戶選完門市後 SmilePay 會 redirect 回 RtURL 並帶 storeid/storename。
|
|
3205
|
+
|
|
3206
|
+
---
|
|
3207
|
+
|
|
3208
|
+
## PChomePay 拍錢包物流範例
|
|
3209
|
+
|
|
3210
|
+
⚠️ Notify IP 必加白名單:**`113.196.231.190`**。
|
|
3211
|
+
|
|
3212
|
+
完整範例見 [`examples/pchomepay-logistics-cvs-example.py`](examples/pchomepay-logistics-cvs-example.py)。涵蓋:
|
|
3213
|
+
- 取號列印交寄單 (`/v1/logistic/batch`)
|
|
3214
|
+
- 物流歷程查詢 (`/v1/logistic/query/{order_id}/history`)
|
|
3215
|
+
- 對帳資料 NDJSON 解析 (`/v1/logistic/accounting/{date}`)
|
|
3216
|
+
- 賠款入帳查詢 (`/v1/logistic/compensation/{date}`)
|
|
3217
|
+
|
|
3218
|
+
### 三大要點
|
|
3219
|
+
|
|
3220
|
+
1. **兩段式認證**:先用 Basic Auth 取 `pcpay-token`(8 小時 TTL),後續 API 帶 token header。
|
|
3221
|
+
2. **對帳資料是 NDJSON**:每行一個獨立 JSON 物件,須逐行 parse;不是標準 JSON array。
|
|
3222
|
+
3. **沙箱依金額尾數模擬情境**:例 ATM 金額尾數 `0-7` 自動付款成功、`8` 過期、`9` 5 分鐘後過期。
|
|
3223
|
+
|
|
3224
|
+
---
|
|
3225
|
+
|
|
3226
|
+
## PayNow 立吉富物流範例
|
|
3227
|
+
|
|
3228
|
+
⚠️ **加密用 3DES (TripleDES) / ECB / Zero-Padding**,24-byte Key + 8-byte IV。**不同於金流端的動態 AES-256**。
|
|
3229
|
+
|
|
3230
|
+
完整範例見 [`examples/paynow-logistics-cvs-example.py`](examples/paynow-logistics-cvs-example.py)。涵蓋 11 條產品線(7-11 大宗 / 冷凍 / 海外、全家 大宗 / 冷凍、4 大超商常溫 C2C、黑貓宅配 / 店到店)。
|
|
3231
|
+
|
|
3232
|
+
### 四大要點
|
|
3233
|
+
|
|
3234
|
+
1. **3DES 不要用 AES**:物流端跟金流端是兩套不同加密;混用會直接失敗。
|
|
3235
|
+
2. **ServiceID 對應產品線**:`20=7-11 大宗 B2C` `40=4 大超商常溫 C2C` `50=黑貓宅配` 等。
|
|
3236
|
+
3. **海外配送限 7-11**:透過 `7-11 over-sea` 產品線寄送;其他超商不支援海外。
|
|
3237
|
+
4. **Webhook 簽章機制官方未明示**:建議自行驗證 LogisticTradeNo + 商家代號比對。
|
|
3238
|
+
|
|
3239
|
+
---
|
|
3240
|
+
|
|
3241
|
+
## HCT 新竹物流(直連 carrier API)範例
|
|
3242
|
+
|
|
3243
|
+
⚠️ **先確認你需要的是直連還是 aggregator**:
|
|
3244
|
+
- **透過 ECPay/PayNow/SmilePay** 走 HCT 配送 → 用 aggregator 的 `LogisticsType=HCT`,不需要本範例
|
|
3245
|
+
- **直接打 HCT 自家系統**(大量出貨、自備站所對接)→ 用本範例,需向 HCT 申請
|
|
3246
|
+
|
|
3247
|
+
完整範例見 [`examples/hct-logistics-example.py`](examples/hct-logistics-example.py)。
|
|
3248
|
+
|
|
3249
|
+
### 四大要點
|
|
3250
|
+
|
|
3251
|
+
1. **加密演算法申請後才提供**:HCT 給的是 C# Sample Code,需自行轉譯。範例的 `_encrypt()` 是 placeholder,串接前必填。
|
|
3252
|
+
2. **`TransReport` 必須當日 18:00 前呼叫**:否則無法列印託運單,包裹無法配送。
|
|
3253
|
+
3. **JSON / XML / DataSet 三種變體**:建議用 JSON 變體,避開 .NET DataSet 跨語言難題。
|
|
3254
|
+
4. **逆物流只有 JSON**:`R_TransData` 沒有 XML 或 DataSet 版本。
|
|
3255
|
+
|
|
3256
|
+
---
|
|
3257
|
+
|
|
3258
|
+
**更多範例持續更新中...**
|