taiwan-logistics-skill 1.4.3 → 1.4.5
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 +39 -28
- package/assets/taiwan-logistics/CLAUDE.md +18 -14
- package/assets/taiwan-logistics/EXAMPLES.md +16 -17
- package/assets/taiwan-logistics/README.md +40 -29
- package/assets/taiwan-logistics/SKILL.md +29 -21
- package/assets/taiwan-logistics/data/logistics-types.csv +54 -30
- package/assets/taiwan-logistics/data/operations.csv +1 -1
- package/assets/taiwan-logistics/data/status-codes.csv +36 -11
- package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +4 -4
- package/assets/taiwan-logistics/examples/ezship-logistics-example.py +74 -13
- package/assets/taiwan-logistics/examples/hct-logistics-example.py +1 -2
- package/assets/taiwan-logistics/examples/store-map-integration-example.html +3 -3
- package/assets/taiwan-logistics/references/carrier-direct-access.md +2 -2
- package/assets/taiwan-logistics/references/ecpay-logistics-api.md +17 -12
- package/assets/taiwan-logistics/references/ezship-logistics-api.md +112 -24
- package/assets/taiwan-logistics/references/hct-logistics-api.md +1 -1
- package/assets/taiwan-logistics/references/ondemand-delivery.md +169 -43
- package/assets/taiwan-logistics/references/paynow-logistics-api.md +2 -2
- package/assets/taiwan-logistics/scripts/core.py +2 -2
- package/assets/taiwan-logistics/scripts/generate-logistics-service.py +70 -1231
- package/assets/taiwan-logistics/scripts/test_logistics.py +108 -262
- package/assets/templates/base/quick-reference.md +41 -33
- package/assets/templates/base/skill-content.md +23 -21
- package/assets/templates/platforms/agent.json +2 -2
- package/assets/templates/platforms/claude.json +2 -2
- package/assets/templates/platforms/cline.json +3 -3
- package/assets/templates/platforms/codebuddy.json +2 -2
- package/assets/templates/platforms/codex.json +2 -2
- package/assets/templates/platforms/continue.json +2 -2
- package/assets/templates/platforms/copilot.json +3 -3
- package/assets/templates/platforms/cursor.json +2 -2
- package/assets/templates/platforms/gemini.json +2 -2
- package/assets/templates/platforms/kiro.json +3 -3
- package/assets/templates/platforms/opencode.json +2 -2
- package/assets/templates/platforms/qoder.json +2 -2
- package/assets/templates/platforms/trae.json +2 -2
- package/assets/templates/platforms/windsurf.json +2 -2
- package/dist/index.js +20 -13
- 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
|
+
<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-
|
|
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
|
-
##
|
|
55
|
+
## 物流服務商
|
|
56
56
|
|
|
57
57
|
| 服務商 | 類型 | 加密 / 認證 | 特色 |
|
|
58
58
|
|---|---|---|---|
|
|
59
|
-
| **ECPay 綠界** | aggregator | MD5 CheckMacValue |
|
|
60
|
-
| **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11
|
|
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 | 金物流二合一、
|
|
63
|
+
| **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、7-11/全家/萊爾富取貨付款 |
|
|
64
64
|
| **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
|
|
65
|
-
| **
|
|
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/ #
|
|
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 #
|
|
78
|
-
│ ├── pchomepay-logistics-api.md #
|
|
79
|
-
│ ├── paynow-logistics-api.md #
|
|
80
|
-
│
|
|
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/ #
|
|
83
|
-
├── providers.csv #
|
|
84
|
-
├── operations.csv
|
|
85
|
-
├── logistics-types.csv #
|
|
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
|
-
|
|
107
|
-
|
|
108
|
-
|
|
|
109
|
-
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
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) —
|
|
121
|
-
- [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) —
|
|
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
|
-
#
|
|
25
|
-
python3 taiwan-logistics/scripts/test_logistics.py [
|
|
24
|
+
# 簽章已知答案 + 測試環境連線(ecpay 另可 --create / --query)
|
|
25
|
+
python3 taiwan-logistics/scripts/test_logistics.py [ecpay|newebpay|payuni]
|
|
26
26
|
|
|
27
|
-
#
|
|
28
|
-
python3 taiwan-logistics/scripts/generate-logistics-service.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 #
|
|
42
|
-
│ ├── pchomepay-logistics-api.md #
|
|
43
|
-
│ ├── paynow-logistics-api.md #
|
|
44
|
-
│
|
|
45
|
-
├──
|
|
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 #
|
|
51
|
+
├── providers.csv # 11 可串接 + 10 僅供查詢(含 doc_access 分級)
|
|
48
52
|
├── operations.csv # cross-provider API operations
|
|
49
|
-
├── logistics-types.csv #
|
|
53
|
+
├── logistics-types.csv # 各家實際參數值(子類型/溫層/代收上限)
|
|
50
54
|
├── status-codes.csv # vendor-specific status codes
|
|
51
|
-
└── field-mappings.csv #
|
|
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
|
-
│
|
|
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: '
|
|
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: '
|
|
1592
|
-
hashKey: '
|
|
1593
|
-
hashIV: '
|
|
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['
|
|
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
|
-
-
|
|
1666
|
-
-
|
|
1667
|
-
-
|
|
1668
|
-
-
|
|
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='
|
|
1781
|
-
hash_key='
|
|
1782
|
-
hash_iv='
|
|
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' | '
|
|
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
|
-
-
|
|
2587
|
-
-
|
|
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
|
+
<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-
|
|
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
|
-
##
|
|
55
|
+
## 物流服務商
|
|
56
56
|
|
|
57
57
|
| 服務商 | 類型 | 加密 / 認證 | 特色 |
|
|
58
58
|
|---|---|---|---|
|
|
59
|
-
| **ECPay 綠界** | aggregator | MD5 CheckMacValue |
|
|
60
|
-
| **NewebPay 藍新** | aggregator | AES-256-CBC + SHA256 | 7-11
|
|
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 | 金物流二合一、
|
|
63
|
+
| **PChomePay 拍錢包** | aggregator | HTTP Basic Auth → token | 金物流二合一、7-11/全家/萊爾富取貨付款 |
|
|
64
64
|
| **PayNow 立吉富** | aggregator | **3DES/ECB/Zero-Padding** | 11 條產品線(含海外配送);不同於金流端 AES |
|
|
65
|
-
| **
|
|
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/ #
|
|
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 #
|
|
78
|
-
│ ├── pchomepay-logistics-api.md #
|
|
79
|
-
│ ├── paynow-logistics-api.md #
|
|
80
|
-
│
|
|
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/ #
|
|
83
|
-
├── providers.csv #
|
|
84
|
-
├── operations.csv
|
|
85
|
-
├── logistics-types.csv #
|
|
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 ·
|
|
110
|
+
Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Cline · Gemini · Trae · OpenCode · Continue · CodeBuddy
|
|
103
111
|
|
|
104
112
|
## 物流類型支援矩陣
|
|
105
113
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
|
109
|
-
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
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) —
|
|
121
|
-
- [taiwan-payment-skill](https://www.npmjs.com/package/taiwan-payment-skill) —
|
|
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 **
|
|
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 (
|
|
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
|
-
|
|
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
|
-
-
|
|
89
|
-
- C2C
|
|
90
|
-
-
|
|
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
|
-
-
|
|
104
|
-
- `
|
|
105
|
-
-
|
|
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 (
|
|
110
|
-
- `TCAT` -
|
|
111
|
-
- `
|
|
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
|
|
133
|
-
- HashKey
|
|
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,
|
|
3
|
-
CVS,
|
|
4
|
-
CVS,FAMI
|
|
5
|
-
CVS,
|
|
6
|
-
CVS,
|
|
7
|
-
CVS,
|
|
8
|
-
CVS,
|
|
9
|
-
CVS,OKMARTC2C,OK
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
CVS,
|
|
13
|
-
CVS,
|
|
14
|
-
CVS,
|
|
15
|
-
CVS,
|
|
16
|
-
CVS,
|
|
17
|
-
CVS,
|
|
18
|
-
CVS,
|
|
19
|
-
CVS,
|
|
20
|
-
CVS,
|
|
21
|
-
|
|
22
|
-
CVS,
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
CVS,
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
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僅新加坡(台灣另有Stage環境);不需成為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=
|
|
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",需先建立訂單
|