taiwan-logistics-skill 1.4.3 → 1.4.4

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.
Files changed (37) hide show
  1. package/README.md +39 -28
  2. package/assets/taiwan-logistics/CLAUDE.md +18 -14
  3. package/assets/taiwan-logistics/EXAMPLES.md +16 -17
  4. package/assets/taiwan-logistics/README.md +40 -29
  5. package/assets/taiwan-logistics/SKILL.md +29 -21
  6. package/assets/taiwan-logistics/data/logistics-types.csv +54 -30
  7. package/assets/taiwan-logistics/data/operations.csv +1 -1
  8. package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +4 -4
  9. package/assets/taiwan-logistics/examples/ezship-logistics-example.py +37 -13
  10. package/assets/taiwan-logistics/examples/hct-logistics-example.py +1 -2
  11. package/assets/taiwan-logistics/examples/store-map-integration-example.html +3 -3
  12. package/assets/taiwan-logistics/references/carrier-direct-access.md +2 -2
  13. package/assets/taiwan-logistics/references/ecpay-logistics-api.md +17 -12
  14. package/assets/taiwan-logistics/references/ezship-logistics-api.md +18 -7
  15. package/assets/taiwan-logistics/references/hct-logistics-api.md +1 -1
  16. package/assets/taiwan-logistics/references/paynow-logistics-api.md +2 -2
  17. package/assets/taiwan-logistics/scripts/core.py +2 -2
  18. package/assets/taiwan-logistics/scripts/generate-logistics-service.py +70 -1231
  19. package/assets/taiwan-logistics/scripts/test_logistics.py +108 -262
  20. package/assets/templates/base/quick-reference.md +41 -33
  21. package/assets/templates/base/skill-content.md +23 -21
  22. package/assets/templates/platforms/agent.json +2 -2
  23. package/assets/templates/platforms/claude.json +2 -2
  24. package/assets/templates/platforms/cline.json +3 -3
  25. package/assets/templates/platforms/codebuddy.json +2 -2
  26. package/assets/templates/platforms/codex.json +2 -2
  27. package/assets/templates/platforms/continue.json +2 -2
  28. package/assets/templates/platforms/copilot.json +3 -3
  29. package/assets/templates/platforms/cursor.json +2 -2
  30. package/assets/templates/platforms/gemini.json +2 -2
  31. package/assets/templates/platforms/kiro.json +3 -3
  32. package/assets/templates/platforms/opencode.json +2 -2
  33. package/assets/templates/platforms/qoder.json +2 -2
  34. package/assets/templates/platforms/trae.json +2 -2
  35. package/assets/templates/platforms/windsurf.json +2 -2
  36. package/dist/index.js +20 -13
  37. package/package.json +2 -2
package/README.md CHANGED
@@ -3,17 +3,17 @@
3
3
  <h3 align="center">台灣物流 AI 開發技能包</h3>
4
4
 
5
5
  <p align="center">
6
- <strong>6 家物流 aggregator + HCT 新竹物流直連 carrier API</strong>
6
+ <strong>7 家物流 aggregator + HCT 新竹物流直連 + 3 家即時配送</strong>
7
7
  </p>
8
8
 
9
9
  <p align="center">
10
- ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · HCT 直連
10
+ ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · ezShip · HCT 直連 · Lalamove · pandago · Uber Direct
11
11
  </p>
12
12
 
13
13
  <p align="center">
14
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
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">
16
+ <img src="https://img.shields.io/badge/providers-11-success?style=flat-square" alt="11 Providers">
17
17
  <img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
18
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
19
  </p>
@@ -52,17 +52,21 @@ HCT 直連 API 傳入託運資料,逆物流單獨處理
52
52
 
53
53
  ---
54
54
 
55
- ## 7 家物流服務商
55
+ ## 物流服務商
56
56
 
57
57
  | 服務商 | 類型 | 加密 / 認證 | 特色 |
58
58
  |---|---|---|---|
59
- | **ECPay 綠界** | aggregator | MD5 CheckMacValue | 市佔率最高、SDK 完整、7-11/全家/萊爾富/OK/黑貓/宅配通/HCT |
60
- | **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11/全家/萊爾富/OK/黑貓 |
59
+ | **ECPay 綠界** | aggregator | MD5 CheckMacValue | B2C 7-11(含冷凍)/全家/萊爾富;C2C 四大超商;宅配黑貓/中華郵政 |
60
+ | **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | B2C 僅 7-11;C2C 四大超商;無宅配 |
61
61
  | **PAYUNi 統一** | aggregator | AES-256-GCM + SHA256 | 7-11 常溫/冷凍 + T-Cat 常溫/冷藏/冷凍(溫控配送最完整) |
62
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 大超商 |
63
+ | **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、7-11/全家/萊爾富取貨付款 |
64
64
  | **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
65
- | **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 直連 carrier API(vs 透過 aggregator) |
65
+ | **ezShip 台灣便利配** | aggregator | 無簽章(`su_id` 帳號綁定) | 全家/萊爾富/OK、宅配、店港澳;不含 7-11 |
66
+ | **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 收錄的聚合商都沒有新竹物流選項,只能直連 |
67
+ | **Lalamove** | 即時配送 | HMAC-SHA256 自簽 | 先報價後下單(報價 5 分鐘效期) |
68
+ | **pandago** | 即時配送 | OAuth 2.0 + RSA 簽 JWT assertion | 同城即時配送 |
69
+ | **Uber Direct** | 即時配送 | OAuth 2.0 client_credentials | 台灣可用性未經官方確認 |
66
70
 
67
71
  ## 技能包內容
68
72
 
@@ -70,19 +74,23 @@ HCT 直連 API 傳入託運資料,逆物流單獨處理
70
74
  taiwan-logistics/
71
75
  ├── SKILL.md # AI 技能主文檔
72
76
  ├── EXAMPLES.md # 實戰範例集
73
- ├── references/ # 7 份 API 規格 (~10,300 行)
77
+ ├── references/ # 各服務商 API 規格
74
78
  │ ├── ecpay-logistics-api.md
75
79
  │ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
76
80
  │ ├── 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
+ │ ├── smilepay-logistics-api.md # Pay_zg 矩陣
82
+ │ ├── pchomepay-logistics-api.md # NDJSON 對帳 parser
83
+ │ ├── paynow-logistics-api.md # Logistic_service 產品線
84
+ │ ├── ezship-logistics-api.md
85
+ │ ├── hct-logistics-api.md # 直連 HCT
86
+ │ ├── lalamove-logistics-api.md
87
+ │ ├── ondemand-delivery.md # Lalamove / pandago / Uber Direct
88
+ │ └── carrier-direct-access.md # 無公開 API 的物流業者與替代路徑
81
89
  ├── examples/ # Python 範例
82
- └── data/ # 5 份 CSV
83
- ├── providers.csv # 7 服務商
84
- ├── operations.csv # 30+ API 操作
85
- ├── logistics-types.csv # CVS / Home / 溫控
90
+ └── data/ # search / recommend 使用的 CSV
91
+ ├── providers.csv # 可串接 + 僅供查詢
92
+ ├── operations.csv
93
+ ├── logistics-types.csv # 各家實際參數值(子類型/溫層/代收上限)
86
94
  ├── status-codes.csv # 跨服務商狀態碼
87
95
  └── field-mappings.csv # 欄位對照
88
96
  ```
@@ -103,22 +111,25 @@ Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Co
103
111
 
104
112
  ## 物流類型支援矩陣
105
113
 
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 直連 | — | — | — | — | — | — | ✅(直連) |
114
+ 依各家官方規格整理,實際參數值見 `data/logistics-types.csv`。
115
+
116
+ | 服務商 | 7-11 | 全家 | 萊爾富 | OK | 黑貓 | 其他 |
117
+ |---|---|---|---|---|---|---|
118
+ | ECPay | B2C(含冷凍)+ C2C | B2C + C2C | B2C + C2C | C2C | 常溫/冷藏/冷凍 | 中華郵政 |
119
+ | NewebPay | B2C + C2C | C2C | C2C | C2C | — | — |
120
+ | PAYUNi | B2C + C2C(常溫/冷凍) | — | — | — | 常溫/冷凍/冷藏 | — |
121
+ | SmilePay | B2C + C2C | B2C + C2C | — | — | 含逆物流 | — |
122
+ | PChomePay | 取貨付款 | 取貨付款 | 取貨付款 | — | — | — |
123
+ | PayNow | B2C + C2C(含冷凍) | B2C + C2C(含冷凍) | C2C | C2C | 宅配、到店 | 7-11 海外 |
124
+ | ezShip | — | C2C | C2C | C2C | — | 宅配、店港澳 |
125
+ | HCT 直連 | — | — | — | — | — | 新竹物流 |
115
126
 
116
127
  ## 相關套件
117
128
 
118
129
  本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
119
130
 
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 家金流
131
+ - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 7 家電子發票加值中心 + 財政部大平台查詢
132
+ - [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) — 14 家金流
122
133
 
123
134
  ## 授權
124
135
 
@@ -21,11 +21,11 @@ python3 taiwan-logistics/scripts/search.py "<query>" [--domain <domain>]
21
21
  # Recommend logistics provider
22
22
  python3 taiwan-logistics/scripts/recommend.py "<requirements>"
23
23
 
24
- # Test API connectivity
25
- python3 taiwan-logistics/scripts/test_logistics.py [--platform <platform>]
24
+ # 簽章已知答案 + 測試環境連線(ecpay 另可 --create / --query)
25
+ python3 taiwan-logistics/scripts/test_logistics.py [ecpay|newebpay|payuni]
26
26
 
27
- # Generate logistics service code
28
- python3 taiwan-logistics/scripts/generate-logistics-service.py <Platform> --output <ts|py>
27
+ # 輸出已驗證的服務實作(py:examples/;ts:EXAMPLES.md 的 verify 片段)
28
+ python3 taiwan-logistics/scripts/generate-logistics-service.py <Provider> --output <ts|py>
29
29
  ```
30
30
 
31
31
  ## Architecture
@@ -38,22 +38,26 @@ taiwan-logistics/ # Source of Truth
38
38
  │ ├── ecpay-logistics-api.md
39
39
  │ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
40
40
  │ ├── payuni-logistics-api.md
41
- │ ├── smilepay-logistics-api.md # NEW (Phase 4): Pay_zg matrix
42
- │ ├── pchomepay-logistics-api.md # NEW (Phase 4): 金物流二合一
43
- │ ├── paynow-logistics-api.md # NEW (Phase 4): 11 product lines, 3DES/ECB
44
- │ └── hct-logistics-api.md # NEW (Phase 4): HCT 直連 carrier API
45
- ├── examples/ # Python examples per provider
41
+ │ ├── smilepay-logistics-api.md # Pay_zg matrix
42
+ │ ├── pchomepay-logistics-api.md # 金物流二合一
43
+ │ ├── paynow-logistics-api.md # Logistic_service 產品線, 3DES/ECB
44
+ │ ├── ezship-logistics-api.md
45
+ │ ├── hct-logistics-api.md # HCT 直連 carrier API
46
+ │ ├── lalamove-logistics-api.md
47
+ │ ├── ondemand-delivery.md
48
+ │ └── carrier-direct-access.md # 無公開 API 的物流業者
49
+ ├── examples/ # 可執行範例(CI 以官方測試向量驗證)
46
50
  └── data/ # Data-driven CSVs
47
- ├── providers.csv # 9 可串接 + 10 僅供查詢(含 doc_access 分級)
51
+ ├── providers.csv # 11 可串接 + 10 僅供查詢(含 doc_access 分級)
48
52
  ├── operations.csv # cross-provider API operations
49
- ├── logistics-types.csv # CVS/Home/temp variants
53
+ ├── logistics-types.csv # 各家實際參數值(子類型/溫層/代收上限)
50
54
  ├── status-codes.csv # vendor-specific status codes
51
- └── field-mappings.csv # 22 欄位 × 11 家 provider 對照(含即時配送)
55
+ └── field-mappings.csv # 跨 provider 欄位對照(含即時配送)
52
56
 
53
57
  logistics-cli/ # CLI installer (taiwan-logistics-skill on npm)
54
58
  ├── src/
55
59
  │ ├── commands/init.ts # Install command with template generation
56
- │ ├── utils/template.ts # Template rendering engine
60
+ │ └── utils/template.ts # Template rendering engine
57
61
  └── assets/ # Bundled assets
58
62
  ├── taiwan-logistics/ # Copy of taiwan-logistics/
59
63
  └── templates/
@@ -141,6 +145,6 @@ Never push directly to `main`. Always:
141
145
 
142
146
  ## Related Projects
143
147
 
144
- - **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow)
148
+ - **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow, O'Pay, SunPay)
145
149
  - **Taiwan Payment Skill** - Payment integration (14 providers: ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay, GoMyPay)
146
150
 
@@ -1507,7 +1507,7 @@ import axios from 'axios';
1507
1507
 
1508
1508
  interface CreateCVSShipmentRequest {
1509
1509
  merTradeNo: string;
1510
- logisticsSubType: 'FAMI' | 'UNIMART' | 'UNIMARTFREEZE' | 'HILIFE' | 'OKMART';
1510
+ logisticsSubType: 'FAMIC2C' | 'UNIMARTC2C' | 'HILIFEC2C' | 'OKMARTC2C';
1511
1511
  goodsAmount: number;
1512
1512
  goodsName: string;
1513
1513
  senderName: string;
@@ -1588,9 +1588,9 @@ class ECPayCVSLogistics extends ECPayLogistics {
1588
1588
 
1589
1589
  // Usage Example
1590
1590
  const logistics = new ECPayCVSLogistics({
1591
- merchantId: '2000132',
1592
- hashKey: '5294y06JbISpM5x9',
1593
- hashIV: 'v77hoKGq4kWxNNIS',
1591
+ merchantId: '2000933', // C2C 測試特店(B2C/宅配為 2000132)
1592
+ hashKey: 'XBERn1YOvpM9nfZc',
1593
+ hashIV: 'h1ONHk4P4yqbl5LK',
1594
1594
  isProduction: false,
1595
1595
  });
1596
1596
 
@@ -1632,7 +1632,7 @@ from dataclasses import dataclass
1632
1632
  class CVSShipmentData:
1633
1633
  """CVS C2C 物流訂單資料"""
1634
1634
  mer_trade_no: str
1635
- logistics_sub_type: Literal['FAMI', 'UNIMART', 'UNIMARTFREEZE', 'HILIFE', 'OKMART']
1635
+ logistics_sub_type: Literal['FAMIC2C', 'UNIMARTC2C', 'HILIFEC2C', 'OKMARTC2C']
1636
1636
  goods_amount: int
1637
1637
  goods_name: str
1638
1638
  sender_name: str
@@ -1661,12 +1661,11 @@ class ECPayCVSLogistics(ECPayLogistics):
1661
1661
  """
1662
1662
  ECPay CVS 超商物流服務
1663
1663
 
1664
- 支援超商類型:
1665
- - FAMI: FamilyMart 全家便利商店
1666
- - UNIMART: 7-ELEVEN 統一超商 (常溫)
1667
- - UNIMARTFREEZE: 7-ELEVEN 統一超商 (冷凍)
1668
- - HILIFE: Hi-Life 萊爾富便利商店
1669
- - OKMART: OK Mart OK 便利商店
1664
+ C2C 店到店子類型(B2C 合約改用 FAMI / UNIMART / UNIMARTFREEZE / HILIFE):
1665
+ - FAMIC2C: 全家店到店
1666
+ - UNIMARTC2C: 7-11 交貨便
1667
+ - HILIFEC2C: 萊爾富店到店
1668
+ - OKMARTC2C: OK 店到店(OK 只有 C2C)
1670
1669
 
1671
1670
  回傳碼:
1672
1671
  - 300: 訂單建立成功 (尚未寄貨)
@@ -1777,9 +1776,9 @@ class ECPayCVSLogistics(ECPayLogistics):
1777
1776
  if __name__ == '__main__':
1778
1777
  # 初始化物流服務 (使用測試環境)
1779
1778
  logistics = ECPayCVSLogistics(
1780
- merchant_id='2000132', # ECPay 測試商店代號
1781
- hash_key='5294y06JbISpM5x9', # ECPay 測試 HashKey
1782
- hash_iv='v77hoKGq4kWxNNIS', # ECPay 測試 HashIV
1779
+ merchant_id='2000933', # ECPay C2C 測試特店(B2C/宅配為 2000132)
1780
+ hash_key='XBERn1YOvpM9nfZc',
1781
+ hash_iv='h1ONHk4P4yqbl5LK',
1783
1782
  is_production=False, # 使用測試環境
1784
1783
  )
1785
1784
 
@@ -1825,7 +1824,7 @@ if __name__ == '__main__':
1825
1824
  ```typescript
1826
1825
  interface CreateHomeShipmentRequest {
1827
1826
  merTradeNo: string;
1828
- logisticsSubType: 'TCAT' | 'ECAN' | 'POST';
1827
+ logisticsSubType: 'TCAT' | 'POST';
1829
1828
  goodsAmount: number;
1830
1829
  goodsName: string;
1831
1830
  senderName: string;
@@ -2583,8 +2582,8 @@ SmilePay 透過 `Pay_zg` 矩陣編碼涵蓋 7-11/全家 + 黑貓三大配送:
2583
2582
  ## HCT 新竹物流(直連 carrier API)範例
2584
2583
 
2585
2584
  ⚠️ **先確認你需要的是直連還是 aggregator**:
2586
- - **透過 ECPay/PayNow/SmilePay** 走 HCT 配送 → 用 aggregator 的 `LogisticsType=HCT`,不需要本範例
2587
- - **直接打 HCT 自家系統**(大量出貨、自備站所對接)→ 用本範例,需向 HCT 申請
2585
+ - 本 skill 收錄的聚合商官方規格都沒有新竹物流選項,要用 HCT 只能直連
2586
+ - 直連需向 HCT 申請帳號與金鑰
2588
2587
 
2589
2588
  完整範例見 [`examples/hct-logistics-example.py`](examples/hct-logistics-example.py)。
2590
2589
 
@@ -3,17 +3,17 @@
3
3
  <h3 align="center">台灣物流 AI 開發技能包</h3>
4
4
 
5
5
  <p align="center">
6
- <strong>6 家物流 aggregator + HCT 新竹物流直連 carrier API</strong>
6
+ <strong>7 家物流 aggregator + HCT 新竹物流直連 + 3 家即時配送</strong>
7
7
  </p>
8
8
 
9
9
  <p align="center">
10
- ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · HCT 直連
10
+ ECPay · NewebPay · PAYUNi · SmilePay · PChomePay · PayNow · ezShip · HCT 直連 · Lalamove · pandago · Uber Direct
11
11
  </p>
12
12
 
13
13
  <p align="center">
14
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
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">
16
+ <img src="https://img.shields.io/badge/providers-11-success?style=flat-square" alt="11 Providers">
17
17
  <img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
18
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
19
  </p>
@@ -52,17 +52,21 @@ HCT 直連 API 傳入託運資料,逆物流單獨處理
52
52
 
53
53
  ---
54
54
 
55
- ## 7 家物流服務商
55
+ ## 物流服務商
56
56
 
57
57
  | 服務商 | 類型 | 加密 / 認證 | 特色 |
58
58
  |---|---|---|---|
59
- | **ECPay 綠界** | aggregator | MD5 CheckMacValue | 市佔率最高、SDK 完整、7-11/全家/萊爾富/OK/黑貓/宅配通/HCT |
60
- | **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11/全家/萊爾富/OK/黑貓 |
59
+ | **ECPay 綠界** | aggregator | MD5 CheckMacValue | B2C 7-11(含冷凍)/全家/萊爾富;C2C 四大超商;宅配黑貓/中華郵政 |
60
+ | **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | B2C 僅 7-11;C2C 四大超商;無宅配 |
61
61
  | **PAYUNi 統一** | aggregator | AES-256-GCM + SHA256 | 7-11 常溫/冷凍 + T-Cat 常溫/冷藏/冷凍(溫控配送最完整) |
62
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 大超商 |
63
+ | **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、7-11/全家/萊爾富取貨付款 |
64
64
  | **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
65
- | **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 直連 carrier API(vs 透過 aggregator) |
65
+ | **ezShip 台灣便利配** | aggregator | 無簽章(`su_id` 帳號綁定) | 全家/萊爾富/OK、宅配、店港澳;不含 7-11 |
66
+ | **HCT 新竹物流** | **direct carrier API** | 申請後提供金鑰 | 收錄的聚合商都沒有新竹物流選項,只能直連 |
67
+ | **Lalamove** | 即時配送 | HMAC-SHA256 自簽 | 先報價後下單(報價 5 分鐘效期) |
68
+ | **pandago** | 即時配送 | OAuth 2.0 + RSA 簽 JWT assertion | 同城即時配送 |
69
+ | **Uber Direct** | 即時配送 | OAuth 2.0 client_credentials | 台灣可用性未經官方確認 |
66
70
 
67
71
  ## 技能包內容
68
72
 
@@ -70,19 +74,23 @@ HCT 直連 API 傳入託運資料,逆物流單獨處理
70
74
  taiwan-logistics/
71
75
  ├── SKILL.md # AI 技能主文檔
72
76
  ├── EXAMPLES.md # 實戰範例集
73
- ├── references/ # 7 份 API 規格 (~10,300 行)
77
+ ├── references/ # 各服務商 API 規格
74
78
  │ ├── ecpay-logistics-api.md
75
79
  │ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
76
80
  │ ├── 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
+ │ ├── smilepay-logistics-api.md # Pay_zg 矩陣
82
+ │ ├── pchomepay-logistics-api.md # NDJSON 對帳 parser
83
+ │ ├── paynow-logistics-api.md # Logistic_service 產品線
84
+ │ ├── ezship-logistics-api.md
85
+ │ ├── hct-logistics-api.md # 直連 HCT
86
+ │ ├── lalamove-logistics-api.md
87
+ │ ├── ondemand-delivery.md # Lalamove / pandago / Uber Direct
88
+ │ └── carrier-direct-access.md # 無公開 API 的物流業者與替代路徑
81
89
  ├── examples/ # Python 範例
82
- └── data/ # 5 份 CSV
83
- ├── providers.csv # 7 服務商
84
- ├── operations.csv # 30+ API 操作
85
- ├── logistics-types.csv # CVS / Home / 溫控
90
+ └── data/ # search / recommend 使用的 CSV
91
+ ├── providers.csv # 可串接 + 僅供查詢
92
+ ├── operations.csv
93
+ ├── logistics-types.csv # 各家實際參數值(子類型/溫層/代收上限)
86
94
  ├── status-codes.csv # 跨服務商狀態碼
87
95
  └── field-mappings.csv # 欄位對照
88
96
  ```
@@ -99,26 +107,29 @@ taiwan-logistics init --global # 全域安裝
99
107
 
100
108
  ## 14 個 AI 平台支援
101
109
 
102
- Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
110
+ Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Cline · Gemini · Trae · OpenCode · Continue · CodeBuddy
103
111
 
104
112
  ## 物流類型支援矩陣
105
113
 
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 直連 | — | — | — | — | — | — | ✅(直連) |
114
+ 依各家官方規格整理,實際參數值見 `data/logistics-types.csv`。
115
+
116
+ | 服務商 | 7-11 | 全家 | 萊爾富 | OK | 黑貓 | 其他 |
117
+ |---|---|---|---|---|---|---|
118
+ | ECPay | B2C(含冷凍)+ C2C | B2C + C2C | B2C + C2C | C2C | 常溫/冷藏/冷凍 | 中華郵政 |
119
+ | NewebPay | B2C + C2C | C2C | C2C | C2C | — | — |
120
+ | PAYUNi | B2C + C2C(常溫/冷凍) | — | — | — | 常溫/冷凍/冷藏 | — |
121
+ | SmilePay | B2C + C2C | B2C + C2C | — | — | 含逆物流 | — |
122
+ | PChomePay | 取貨付款 | 取貨付款 | 取貨付款 | — | — | — |
123
+ | PayNow | B2C + C2C(含冷凍) | B2C + C2C(含冷凍) | C2C | C2C | 宅配、到店 | 7-11 海外 |
124
+ | ezShip | — | C2C | C2C | C2C | — | 宅配、店港澳 |
125
+ | HCT 直連 | — | — | — | — | — | 新竹物流 |
115
126
 
116
127
  ## 相關套件
117
128
 
118
129
  本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
119
130
 
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 家金流
131
+ - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 7 家電子發票加值中心 + 財政部大平台查詢
132
+ - [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) — 14 家金流
122
133
 
123
134
  ## 授權
124
135
 
@@ -1,12 +1,18 @@
1
+ ---
2
+ name: taiwan-logistics
3
+ description: Taiwan Logistics API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow and ezShip aggregators, HCT direct carrier API, and on-demand delivery (Lalamove, pandago, Uber Direct). Use when developing shipping flows, implementing CVS pickup (7-11/全家/萊爾富/OK), home delivery (黑貓/中華郵政), cold-chain, store-map selectors, COD orders, or shipment tracking. Handles encryption (MD5, AES-256-CBC, AES-256-GCM, 3DES), store maps, and provider field mappings.
4
+ user-invocable: true
5
+ ---
6
+
1
7
  # Taiwan Logistics Development Skill
2
8
 
3
- **Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow + HCT direct API)**
9
+ **Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow, ezShip + HCT direct API + on-demand delivery)**
4
10
 
5
11
  ---
6
12
 
7
13
  ## Supported Providers
8
14
 
9
- This skill covers **6 logistics aggregators** + **1 direct carrier API**:
15
+ This skill covers **7 logistics aggregators** + **1 direct carrier API** + **3 on-demand delivery services**:
10
16
 
11
17
  | Provider | 類型 | Reference |
12
18
  |---|---|---|
@@ -15,10 +21,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
15
21
  | **PAYUNi 統一** | aggregator | `references/payuni-logistics-api.md` |
16
22
  | **SmilePay 速買配** | aggregator (含 7-11/全家 + 黑貓 Pay_zg 矩陣) | `references/smilepay-logistics-api.md` |
17
23
  | **PChomePay 拍錢包** | aggregator (金物流二合一) | `references/pchomepay-logistics-api.md` |
18
- | **PayNow 立吉富** | aggregator (11 條產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
24
+ | **PayNow 立吉富** | aggregator (Logistic_service 產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
25
+ | **ezShip 台灣便利配** | aggregator (全家/萊爾富/OK、宅配、店港澳;不含 7-11) | `references/ezship-logistics-api.md` |
19
26
  | **HCT 新竹物流** | **直連 carrier API** | `references/hct-logistics-api.md` |
27
+ | **Lalamove** | 即時/同城配送 | `references/lalamove-logistics-api.md` |
28
+ | **pandago / Uber Direct** | 即時/同城配送 | `references/ondemand-delivery.md` |
20
29
 
21
- > 註:選用 `HCT 直連 API` 適合大量出貨企業;一般電商透過 aggregator (`LogisticsType=HCT`) 走 HCT 配送即可,不需自行串接。
30
+ 黑貓、宅配通、中華郵政、超商賣家平台等沒有對外商家 API,替代路徑見 `references/carrier-direct-access.md`。
31
+ 各家實際參數值(子類型、溫層、代收上限)見 `data/logistics-types.csv`。
32
+
33
+ > 註:本 skill 收錄的聚合商(ECPay、NewebPay、PAYUNi、SmilePay、PChomePay、PayNow、ezShip)官方規格都沒有新竹物流選項,要用 HCT 只能直連(需向 HCT 申請)。
22
34
 
23
35
  ---
24
36
 
@@ -85,9 +97,9 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
85
97
  **API Style**: Form POST with URL-encoded parameters
86
98
 
87
99
  **Supported Services:**
88
- - C2C Store-to-Store: 4 convenience stores (7-11, FamilyMart, Hi-Life, OK Mart)
89
- - C2C Frozen: 7-ELEVEN frozen goods
90
- - Home Delivery: T-Cat, HCT, Pelican Express
100
+ - B2C 超商取貨:7-11(常溫/冷凍)、全家、萊爾富
101
+ - C2C 店到店:7-11 交貨便、全家、萊爾富、OK
102
+ - 宅配:黑貓(常溫/冷藏/冷凍)、中華郵政(僅常溫)
91
103
 
92
104
  **Test Environment:**
93
105
  - Base URL: `https://logistics-stage.ecpay.com.tw`
@@ -99,19 +111,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
99
111
  **Production Environment:**
100
112
  - Base URL: `https://logistics.ecpay.com.tw`
101
113
 
102
- **Logistics SubTypes (CVS):**
103
- - `FAMI` - FamilyMart (全家)
104
- - `UNIMART` - 7-ELEVEN (常溫)
105
- - `UNIMARTFREEZE` - 7-ELEVEN (冷凍)
106
- - `HILIFE` - Hi-Life (萊爾富)
107
- - `OKMART` - OK Mart
114
+ **Logistics SubTypes (`LogisticsType=CVS`):**
115
+ - B2C:`FAMI` 全家、`UNIMART` 7-11、`UNIMARTFREEZE` 7-11 冷凍店取、`HILIFE` 萊爾富
116
+ - C2C:`FAMIC2C` 全家、`UNIMARTC2C` 7-11 交貨便、`HILIFEC2C` 萊爾富、`OKMARTC2C` OK
117
+ - B2C 合約只能用 B2C 代碼,C2C 合約只能用 C2C 代碼;OK 只有 C2C
108
118
 
109
- **Logistics SubTypes (Home Delivery):**
110
- - `TCAT` - T-Cat (黑貓宅急便)
111
- - `ECAN` - HCT (新竹物流)
112
- - `POST` - Pelican Express (宅配通)
119
+ **Logistics SubTypes (`LogisticsType=HOME`):**
120
+ - `TCAT` - 黑貓宅急便(代收貨款時商品金額上限 20,000)
121
+ - `POST` - 中華郵政(`Temperature` 只能 `0001`,不可代收)
113
122
 
114
- **Temperature Control (Home Delivery):**
123
+ **Temperature Control (Home Delivery, TCAT):**
115
124
  - `0001` - Normal temperature (常溫)
116
125
  - `0002` - Refrigerated (冷藏)
117
126
  - `0003` - Frozen (冷凍)
@@ -129,9 +138,8 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
129
138
  - `03` - Outlying islands
130
139
 
131
140
  **Test Credentials:**
132
- - MerchantID: `2000132`
133
- - HashKey: `5294y06JbISpM5x9`
134
- - HashIV: `v77hoKGq4kWxNNIS`
141
+ - B2C 及宅配:MerchantID `2000132`、HashKey `5294y06JbISpM5x9`、HashIV `v77hoKGq4kWxNNIS`
142
+ - C2C:MerchantID `2000933`、HashKey `XBERn1YOvpM9nfZc`、HashIV `h1ONHk4P4yqbl5LK`
135
143
 
136
144
  ---
137
145
 
@@ -1,31 +1,55 @@
1
1
  logistics_type,logistics_sub_type,name_zh,provider,type,collection_available,max_amount,size_limit,temperature,notes
2
- CVS,UNIMART,7-11 B2C,7-11,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
3
- CVS,UNIMARTC2C,7-11 店到店,7-11,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 交貨便
4
- CVS,FAMI,全家 B2C,全家,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
5
- CVS,FAMIC2C,全家店到店,全家,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
6
- CVS,HILIFE,萊爾富 B2C,萊爾富,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
7
- CVS,HILIFEC2C,萊爾富店到店,萊爾富,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
8
- CVS,OKMART,OK B2C,OK,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
9
- CVS,OKMARTC2C,OK 店到店,OK,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
10
- Home,TCAT,黑貓宅急便,黑貓,home,false,200000,150cm,常溫/冷藏/冷凍,宅配到府
11
- Home,ECAN,宅配通,宅配通,home,false,100000,120cm,常溫,常溫宅配
12
- CVS,UNIMART_NWP,7-11 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新7-11取貨
13
- CVS,UNIMARTC2C_NWP,7-11 店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新7-11 C2C
14
- CVS,FAMI_NWP,全家 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新全家取貨
15
- CVS,FAMIC2C_NWP,全家店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新全家 C2C
16
- CVS,HILIFE_NWP,萊爾富 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新萊爾富取貨
17
- CVS,HILIFEC2C_NWP,萊爾富店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新萊爾富 C2C
18
- CVS,OKMART_NWP,OK B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新OK取貨
19
- CVS,OKMARTC2C_NWP,OK 店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新OK C2C
20
- CVS,UNIMART_PAY,7-11 C2C 常溫 (PAYUNi),payuni,cvs_c2c,false,6000,45x30x30cm,常溫,統一7-11常溫
21
- CVS,UNIMART_FREEZE,7-11 C2C 冷凍 (PAYUNi),payuni,cvs_c2c,false,6000,45x30x30cm,冷凍,統一7-11冷凍
22
- CVS,UNIMART_B2C_PAY,7-11 B2C (PAYUNi),payuni,cvs_b2c,true,20000,45x30x30cm,常溫,統一7-11 B2C
23
- Home,TCAT_PAY,黑貓常溫 (PAYUNi),payuni,home,true,50000,150x150x150cm,常溫,統一T-Cat常溫
24
- Home,TCAT_FREEZE,黑貓冷凍 (PAYUNi),payuni,home,true,50000,100x100x100cm,冷凍,統一T-Cat冷凍
25
- Home,TCAT_COLD,黑貓冷藏 (PAYUNi),payuni,home,true,50000,100x100x100cm,冷藏,統一T-Cat冷藏
26
- CVS,EZSHIP_OK,OK 店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
27
- CVS,EZSHIP_HILIFE,萊爾富店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
28
- CVS,EZSHIP_FAMI,全家店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
29
- Ondemand,LALAMOVE,Lalamove 即時配送,lalamove,ondemand,false,依方案,依車型,常溫,先報價後下單;報價效期5分鐘;同城/當日;可換司機;非批次物流
30
- Ondemand,PANDAGO,pandago 即時配送,pandago,ondemand,false,依報價,34x34x36cm/20kg,常溫,費用與時間為兩支獨立端點;Sandbox僅新加坡;不需成為foodpanda餐廳夥伴
31
- Ondemand,UBER_DIRECT,Uber Direct 即時配送,uber_direct,ondemand,false,依報價,依方案,常溫,配送半徑約10英里;可預約最多30天;台灣可用性未經官方確認
2
+ CVS,LogisticsSubType=UNIMART,7-11 超商取貨(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
3
+ CVS,LogisticsSubType=UNIMARTFREEZE,7-11 冷凍店取(B2C),ecpay,cvs_b2c,true,20000,,冷凍,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
4
+ CVS,LogisticsSubType=FAMI,全家(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
5
+ CVS,LogisticsSubType=HILIFE,萊爾富(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
6
+ CVS,LogisticsSubType=UNIMARTC2C,7-11 交貨便(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
7
+ CVS,LogisticsSubType=FAMIC2C,全家店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
8
+ CVS,LogisticsSubType=HILIFEC2C,萊爾富店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
9
+ CVS,LogisticsSubType=OKMARTC2C,OK 店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收;OK 只有 C2C,沒有 OKMART
10
+ HOME,LogisticsSubType=TCAT,黑貓宅急便,ecpay,home,true,20000,,常溫/冷藏/冷凍,LogisticsType=HOME;Temperature 0001/0002/0003;代收時商品金額上限 20000
11
+ HOME,LogisticsSubType=POST,中華郵政,ecpay,home,false,,,常溫,LogisticsType=HOME;Temperature 只能 0001;不可代收
12
+ CVS,LgsType=B2C ShipType=1,7-11 大宗寄倉(B2C),newebpay,cvs_b2c,true,20000,,常溫,B2C 只有 7-11;TradeType 1 取貨付款/3 取貨不付款
13
+ CVS,LgsType=C2C ShipType=1,7-11 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
14
+ CVS,LgsType=C2C ShipType=2,全家 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
15
+ CVS,LgsType=C2C ShipType=3,萊爾富 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
16
+ CVS,LgsType=C2C ShipType=4,OK 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
17
+ CVS,LgsType=B2C ShipType=1 GoodsType=1,7-11 大宗寄倉(常溫),payuni,cvs_b2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
18
+ CVS,LgsType=B2C ShipType=1 GoodsType=2,7-11 大宗寄倉(冷凍),payuni,cvs_b2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
19
+ CVS,LgsType=C2C ShipType=1 GoodsType=1,7-11 店到店(常溫),payuni,cvs_c2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
20
+ CVS,LgsType=C2C ShipType=1 GoodsType=2,7-11 店到店(冷凍),payuni,cvs_c2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
21
+ HOME,LgsType=HOME ShipType=2 GoodsType=1/2/3,黑貓宅配,payuni,home,,,,常溫/冷凍/冷藏,GoodsType 1 常溫/2 冷凍/3 冷藏;ConsigneeAddress、DeliveryTimeTag 必填
22
+ CVS,Pay_zg=55/56 Pay_subzg=7NET,7-11 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
23
+ CVS,Pay_zg=55/56 Pay_subzg=FAMI,全家 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
24
+ CVS,Pay_zg=51/52 Pay_subzg=7NET,7-11 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
25
+ CVS,Pay_zg=51/52 Pay_subzg=FAMI,全家 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
26
+ HOME,Pay_zg=81/82 Pay_subzg=TCAT,黑貓宅配,smilepay,home,true,,,常溫/冷藏/冷凍,81 取貨付款/82 純取貨;溫層由 ezcatGetTrackNum.asp 的 temperature 0001/0002/0003 決定
27
+ HOME,Pay_zg=83 Pay_subzg=TCAT,黑貓逆物流(退貨),smilepay,return,false,,,常溫,退貨用
28
+ CVS,pay_type=IPL7,7-11 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
29
+ CVS,pay_type=IPLFM,全家 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
30
+ CVS,pay_type=IPLHL,萊爾富 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
31
+ CVS,Logistic_service=01,7-11 交貨便,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
32
+ CVS,Logistic_service=02,7-11 大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
33
+ CVS,Logistic_service=03,全家店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
34
+ CVS,Logistic_service=04,全家大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
35
+ CVS,Logistic_service=05,萊爾富店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
36
+ CVS,Logistic_service=10,OK 店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
37
+ CVS,Logistic_service=21,7-11 交貨便(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款;電子地圖用 Logistic_serviceID=22,建單固定 21
38
+ CVS,Logistic_service=22,7-11 大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
39
+ CVS,Logistic_service=23,全家店到店(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
40
+ CVS,Logistic_service=24,全家大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
41
+ HOME,Logistic_service=06,黑貓宅急便,paynow,home,true,100000,,常溫/冷藏/冷凍,DeliveryType 0001/0002/0003;長寬高合計 ≤ 150 cm
42
+ HOME,Logistic_service=36,黑貓宅急便(自動保險),paynow,home,false,100000,,常溫/冷藏/冷凍,保險單 DeliverMode 須為 02;總金額超過 20000 自動投保
43
+ CVS,Logistic_service=46,黑貓到店,paynow,cvs_c2c,true,20000,,常溫/冷藏/冷凍,取件門市;長寬高合計 ≤ 105 cm
44
+ CROSS_BORDER,Logistic_service=07,7-11 海外店配,paynow,cross_border,,,,常溫,需帶 Country
45
+ CROSS_BORDER,Logistic_service=08,7-11 海外宅配,paynow,cross_border,,,,常溫,需帶 Country
46
+ CVS,Logistic_service=12,7-11 大宗退貨便,paynow,return,false,,,常溫,退貨用
47
+ CVS,stCate=TFM,全家 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
48
+ CVS,stCate=TLF,萊爾富 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
49
+ CVS,stCate=TOK,OK 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
50
+ HOME,order_status=A05/A06,ezShip 宅配,ezship,home,true,8000,,常溫,order_type 1 取貨付款(代收 10–8000);rv_addr、rv_zip 必填
51
+ CROSS_BORDER,stCate=TSF,店港澳,ezship,cross_border,false,,,常溫,order_status A11/A12;無代收
52
+ HOME,eprdcl2=001/003/008,新竹物流(直連),hct_direct,home,true,,,常溫/冷凍/冷藏,eprdcl2 001 一般/003 冷凍/008 冷藏;eqmny 代收貨款
53
+ ONDEMAND,LALAMOVE,Lalamove 即時配送,lalamove,ondemand,false,依方案,依車型,常溫,先報價後下單;報價效期5分鐘;同城/當日;可換司機;非批次物流
54
+ ONDEMAND,PANDAGO,pandago 即時配送,pandago,ondemand,false,依報價,34x34x36cm/20kg,常溫,費用與時間為兩支獨立端點;Sandbox僅新加坡;不需成為foodpanda餐廳夥伴
55
+ ONDEMAND,UBER_DIRECT,Uber Direct 即時配送,uber_direct,ondemand,false,依報價,依方案,常溫,配送半徑約10英里;可預約最多30天;台灣可用性未經官方確認
@@ -1,6 +1,6 @@
1
1
  operation,operation_zh,ecpay_endpoint,newebpay_endpoint,payuni_endpoint,method,required_fields,optional_fields,notes
2
2
  create_cvs,建立超商取貨訂單,/Express/Create,/API/Logistic/createShipment,交易 API 內建立(/upp ShipTag=1;/atm、/cvs、/credit 等 ServiceType=3),POST,"MerchantID,MerchantTradeNo,LogisticsType,LogisticsSubType,GoodsAmount,GoodsName,SenderName,SenderPhone,ReceiverName,ReceiverPhone,ReceiverStoreID,ServerReplyURL","IsCollection,CollectionAmount,ReturnStoreID",LogisticsType=CVS
3
- create_home,建立宅配訂單,/Express/Create,/API/Logistic/createShipment,交易 API 內建立(LgsType=HOME、ShipType=2),POST,"MerchantID,MerchantTradeNo,LogisticsType,LogisticsSubType,GoodsAmount,GoodsName,SenderName,SenderPhone,SenderAddress,ReceiverName,ReceiverPhone,ReceiverAddress,ServerReplyURL","Temperature,Distance,Specification,ScheduledDeliveryTime",LogisticsType=Home
3
+ create_home,建立宅配訂單,/Express/Create,/API/Logistic/createShipment,交易 API 內建立(LgsType=HOME、ShipType=2),POST,"MerchantID,MerchantTradeNo,LogisticsType,LogisticsSubType,GoodsAmount,GoodsName,SenderName,SenderPhone,SenderAddress,ReceiverName,ReceiverPhone,ReceiverAddress,ServerReplyURL","Temperature,Distance,Specification,ScheduledDeliveryTime",LogisticsType=HOME
4
4
  map,超商電子地圖,/Express/map,/API/Logistic/storeMap,/logistics/ship_map,POST,"MerchantID,LogisticsType,LogisticsSubType,ServerReplyURL","IsCollection,ExtraData",開啟門市選擇頁面
5
5
  query,查詢物流訂單,/Helper/QueryLogisticsTradeInfo/V2,/API/Logistic/queryShipment,/logistics/query,POST,"MerchantID,TimeStamp","AllPayLogisticsID,MerchantTradeNo",二擇一
6
6
  print,列印託運單,/helper/printTradeDocument,/API/Logistic/printLabel,/logistics/print_label;黑貓 /home_delivery/get_obt_number_pdf,POST,"MerchantID,AllPayLogisticsID","LogisticsType,LogisticsSubType",需先建立訂單
@@ -149,9 +149,9 @@ class ECPayLogistics:
149
149
 
150
150
  def _test_client():
151
151
  return ECPayLogistics(
152
- merchant_id="2000132", # 測試商店代號
153
- hash_key="5294y06JbISpM5x9", # 測試 HashKey
154
- hash_iv="v77hoKGq4kWxNNIS", # 測試 HashIV
152
+ merchant_id="2000933", # C2C 測試特店(B2C/宅配為 2000132)
153
+ hash_key="XBERn1YOvpM9nfZc",
154
+ hash_iv="h1ONHk4P4yqbl5LK",
155
155
  test_mode=True,
156
156
  )
157
157
 
@@ -197,7 +197,7 @@ def example_verify_callback():
197
197
  print("\n=== 範例4: 驗證物流狀態通知 ===\n")
198
198
  client = _test_client()
199
199
  posted = {
200
- "MerchantID": "2000132", "MerchantTradeNo": "ORDER1758600000",
200
+ "MerchantID": "2000933", "MerchantTradeNo": "ORDER1758600000",
201
201
  "RtnCode": "300", "RtnMsg": "訂單處理中(已收到訂單資料)",
202
202
  "AllPayLogisticsID": "10001234567", "LogisticsType": "CVS",
203
203
  "LogisticsSubType": "UNIMARTC2C", "GoodsAmount": "100",