taiwan-logistics-skill 1.1.5 → 1.2.0
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/assets/taiwan-logistics/CLAUDE.md +49 -209
- package/assets/taiwan-logistics/README.md +1 -1
- package/assets/taiwan-logistics/SKILL.md +19 -1
- package/assets/taiwan-logistics/data/operations.csv +21 -0
- package/assets/taiwan-logistics/data/providers.csv +4 -0
- package/assets/taiwan-logistics/references/hct-logistics-api.md +1102 -0
- package/assets/taiwan-logistics/references/paynow-logistics-api.md +1670 -0
- package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +1154 -0
- package/assets/taiwan-logistics/references/smilepay-logistics-api.md +1332 -0
- package/assets/templates/base/quick-reference.md +74 -74
- package/assets/templates/base/skill-content.md +18 -2
- package/assets/templates/platforms/agent.json +2 -2
- package/assets/templates/platforms/claude.json +2 -2
- 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 +2 -2
- package/assets/templates/platforms/cursor.json +2 -2
- package/assets/templates/platforms/gemini.json +2 -2
- package/assets/templates/platforms/kiro.json +2 -2
- package/assets/templates/platforms/opencode.json +2 -2
- package/assets/templates/platforms/qoder.json +2 -2
- package/assets/templates/platforms/roocode.json +2 -2
- package/assets/templates/platforms/trae.json +2 -2
- package/assets/templates/platforms/windsurf.json +2 -2
- package/package.json +9 -2
|
@@ -4,12 +4,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|
|
4
4
|
|
|
5
5
|
## Project Overview
|
|
6
6
|
|
|
7
|
-
Taiwan Logistics Skill is an AI-powered toolkit for Taiwan
|
|
7
|
+
Taiwan Logistics Skill is an AI-powered toolkit for Taiwan logistics integration, providing API documentation, code examples, and scripts for major logistics platforms. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
|
|
8
|
+
|
|
9
|
+
**Supported Providers:** `ecpay`, `newebpay`, `payuni`, `smilepay`, `pchomepay`, `paynow`, `hct_direct`
|
|
8
10
|
|
|
9
11
|
## Available Scripts
|
|
10
12
|
|
|
11
13
|
```bash
|
|
12
|
-
# Search API documentation
|
|
14
|
+
# Search API documentation (BM25)
|
|
13
15
|
python3 taiwan-logistics/scripts/search.py "<query>" [--domain <domain>]
|
|
14
16
|
|
|
15
17
|
# Recommend logistics provider
|
|
@@ -17,47 +19,44 @@ python3 taiwan-logistics/scripts/recommend.py "<requirements>"
|
|
|
17
19
|
|
|
18
20
|
# Test API connectivity
|
|
19
21
|
python3 taiwan-logistics/scripts/test_logistics.py [--platform <platform>]
|
|
20
|
-
```
|
|
21
22
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
23
|
+
# Generate logistics service code
|
|
24
|
+
python3 taiwan-logistics/scripts/generate-logistics-service.py <Platform> --output <ts|py>
|
|
25
|
+
```
|
|
25
26
|
|
|
26
27
|
## Architecture
|
|
27
28
|
|
|
28
29
|
```
|
|
29
|
-
taiwan-logistics/
|
|
30
|
-
├── SKILL.md
|
|
31
|
-
├── EXAMPLES.md
|
|
32
|
-
├── references/
|
|
30
|
+
taiwan-logistics/ # Source of Truth
|
|
31
|
+
├── SKILL.md # Main skill documentation
|
|
32
|
+
├── EXAMPLES.md # Code examples and patterns
|
|
33
|
+
├── references/ # API documentation
|
|
33
34
|
│ ├── ecpay-logistics-api.md
|
|
34
35
|
│ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
|
|
35
|
-
│
|
|
36
|
-
├──
|
|
37
|
-
│ ├──
|
|
38
|
-
│ ├──
|
|
39
|
-
│
|
|
40
|
-
|
|
41
|
-
└── data/
|
|
42
|
-
├── providers.csv
|
|
43
|
-
├── operations.csv
|
|
44
|
-
├── logistics-types.csv
|
|
45
|
-
├── status-codes.csv
|
|
46
|
-
└── field-mappings.csv
|
|
47
|
-
|
|
48
|
-
cli/
|
|
36
|
+
│ ├── payuni-logistics-api.md
|
|
37
|
+
│ ├── smilepay-logistics-api.md # NEW (Phase 4): Pay_zg matrix
|
|
38
|
+
│ ├── pchomepay-logistics-api.md # NEW (Phase 4): 金物流二合一
|
|
39
|
+
│ ├── paynow-logistics-api.md # NEW (Phase 4): 11 product lines, 3DES/ECB
|
|
40
|
+
│ └── hct-logistics-api.md # NEW (Phase 4): HCT 直連 carrier API
|
|
41
|
+
├── examples/ # Python examples per provider
|
|
42
|
+
└── data/ # Data-driven CSVs
|
|
43
|
+
├── providers.csv # 7+ providers/carriers
|
|
44
|
+
├── operations.csv # cross-provider API operations
|
|
45
|
+
├── logistics-types.csv # CVS/Home/temp variants
|
|
46
|
+
├── status-codes.csv # vendor-specific status codes
|
|
47
|
+
└── field-mappings.csv # cross-provider field mapping
|
|
48
|
+
|
|
49
|
+
logistics-cli/ # CLI installer (taiwan-logistics-skill on npm)
|
|
49
50
|
├── src/
|
|
50
|
-
│ ├── commands/init.ts
|
|
51
|
-
│ ├── utils/template.ts
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
└── assets/ # Bundled assets
|
|
55
|
-
├── taiwan-logistics/ # Copy of taiwan-logistics/
|
|
51
|
+
│ ├── commands/init.ts # Install command with template generation
|
|
52
|
+
│ ├── utils/template.ts # Template rendering engine
|
|
53
|
+
└── assets/ # Bundled assets
|
|
54
|
+
├── taiwan-logistics/ # Copy of taiwan-logistics/
|
|
56
55
|
└── templates/
|
|
57
|
-
├── base/
|
|
58
|
-
└── platforms/
|
|
56
|
+
├── base/ # Base templates (skill-content.md, quick-reference.md)
|
|
57
|
+
└── platforms/ # Platform configs (14 platforms)
|
|
59
58
|
|
|
60
|
-
.claude/skills/taiwan-logistics/
|
|
59
|
+
.claude/skills/taiwan-logistics/ # Claude Code skill (generated by CLI)
|
|
61
60
|
```
|
|
62
61
|
|
|
63
62
|
## Sync Rules
|
|
@@ -73,18 +72,16 @@ When modifying files:
|
|
|
73
72
|
- `scripts/*.py` - Utility scripts
|
|
74
73
|
- `data/*.csv` - Data files
|
|
75
74
|
|
|
76
|
-
2. **Templates** - Edit in `cli/assets/templates/`:
|
|
75
|
+
2. **Templates** - Edit in `logistics-cli/assets/templates/`:
|
|
77
76
|
- `base/skill-content.md` - Common skill content
|
|
78
77
|
- `base/quick-reference.md` - Quick reference (Claude only)
|
|
79
78
|
- `platforms/*.json` - Platform-specific configs (14 platforms)
|
|
80
79
|
|
|
81
80
|
3. **CLI Assets** - Run sync before publishing:
|
|
82
81
|
```bash
|
|
83
|
-
cp -r taiwan-logistics/* cli/assets/taiwan-logistics/
|
|
82
|
+
cp -r taiwan-logistics/* logistics-cli/assets/taiwan-logistics/
|
|
84
83
|
```
|
|
85
84
|
|
|
86
|
-
4. **Reference Folders** - No manual sync needed. The CLI generates these from templates during `taiwan-logistics init`.
|
|
87
|
-
|
|
88
85
|
## Supported AI Platforms
|
|
89
86
|
|
|
90
87
|
| Platform | Folder | Install Type |
|
|
@@ -109,6 +106,18 @@ When modifying files:
|
|
|
109
106
|
- Node.js 18+ (for CLI)
|
|
110
107
|
- Python 3.x (for scripts, no external dependencies)
|
|
111
108
|
|
|
109
|
+
## Encryption Methods
|
|
110
|
+
|
|
111
|
+
| Provider | Encryption | Notes |
|
|
112
|
+
|---|---|---|
|
|
113
|
+
| ECPay 綠界 | MD5 CheckMacValue | Sort params + HashKey/HashIV |
|
|
114
|
+
| NewebPay 藍新 | AES-256-CBC + SHA256 | Same as MPG payment |
|
|
115
|
+
| PAYUNi 統一 | AES-256-GCM + SHA256 | Append 16-byte tag |
|
|
116
|
+
| SmilePay 速買配 | Verify_key + Mid_smilepay 加權檢核碼 | No AES; shared secret |
|
|
117
|
+
| PChomePay 拍錢包 | HTTP Basic Auth → 8h pcpay-token | Same as payment side |
|
|
118
|
+
| PayNow 立吉富 | **3DES (TripleDES) / ECB / Zero-Padding** | 24-byte Key + 8-byte IV; **不同於金流端的動態 AES-256** |
|
|
119
|
+
| HCT 直連 | 自訂加密(金鑰申請後提供) | C# sample code only |
|
|
120
|
+
|
|
112
121
|
## Git Workflow
|
|
113
122
|
|
|
114
123
|
Never push directly to `main`. Always:
|
|
@@ -118,180 +127,11 @@ Never push directly to `main`. Always:
|
|
|
118
127
|
3. Push branch: `git push -u origin <branch>`
|
|
119
128
|
4. Create PR: `gh pr create`
|
|
120
129
|
|
|
121
|
-
## Development Guidelines
|
|
122
|
-
|
|
123
|
-
### When Working with Logistics Integration
|
|
124
|
-
|
|
125
|
-
1. **Always verify CheckMacValue / TradeSha / HashInfo** - Sign every callback before processing
|
|
126
|
-
2. **Use test accounts** - Never use production credentials in examples
|
|
127
|
-
3. **Handle errors gracefully** - CVS store closures and pickup failures are common
|
|
128
|
-
4. **HTTPS only** - All ServerReplyURL and notify URLs must use HTTPS
|
|
129
|
-
5. **Idempotency** - Re-handle duplicate notify as no-op (don't double-update orders)
|
|
130
|
-
6. **Amount limits** - CVS C2C usually capped at NT$6,000; B2C at NT$20,000
|
|
131
|
-
|
|
132
|
-
### Common Pitfalls
|
|
133
|
-
|
|
134
|
-
1. **Store-map (LogisticsMap) integration**:
|
|
135
|
-
- `tempvar` round-trips session state through the iframe redirect
|
|
136
|
-
- Selected store ID format differs per provider — verify shape on callback
|
|
137
|
-
- Some providers offer separate MOBILE / WEB endpoints; pick by user-agent
|
|
138
|
-
|
|
139
|
-
2. **B2C vs C2C confusion**:
|
|
140
|
-
- B2C (大宗寄倉): merchant ships to logistics center, then distributed to stores
|
|
141
|
-
- C2C (店到店): merchant drops package at any CVS, transferred to pickup CVS
|
|
142
|
-
- Different APIs, different field sets, different amount caps
|
|
143
|
-
|
|
144
|
-
3. **Cold-chain routing**:
|
|
145
|
-
- 黑貓宅急便 has separate API channels for 常溫 / 冷藏 / 冷凍
|
|
146
|
-
- SmilePay logistics also routes 黑貓 + 7-11/全家 with their own type codes
|
|
147
|
-
- Don't mix them — temperature is part of the shipment-method ID
|
|
148
|
-
|
|
149
|
-
4. **Status callbacks**:
|
|
150
|
-
- Status codes are numeric (e.g., 21 待出貨, 31 配送中, 11 已取貨)
|
|
151
|
-
- Code 81 (門市關轉) means pickup store closed — customer must re-pick a store
|
|
152
|
-
- Code 51/52/53 are different return reasons — handle each appropriately
|
|
153
|
-
|
|
154
|
-
### Code Review Checklist
|
|
155
|
-
|
|
156
|
-
- [ ] Sensitive data (HashKey/HashIV) not exposed in frontend
|
|
157
|
-
- [ ] CheckMacValue/TradeSha/HashInfo properly calculated and verified
|
|
158
|
-
- [ ] HTTPS used for all callback URLs
|
|
159
|
-
- [ ] Proper error handling for shipment failures
|
|
160
|
-
- [ ] Unique merchant trade numbers generated
|
|
161
|
-
- [ ] Test accounts used in examples
|
|
162
|
-
- [ ] Amount limits enforced (CVS C2C / B2C / home delivery)
|
|
163
|
-
- [ ] Cold-chain routing uses correct shipment method code
|
|
164
|
-
- [ ] CSV data validated and consistent
|
|
165
|
-
|
|
166
|
-
## Smart Tools Usage
|
|
167
|
-
|
|
168
|
-
### BM25 Search
|
|
169
|
-
|
|
170
|
-
Use when user asks about:
|
|
171
|
-
- "What does logistics status code 81 mean?"
|
|
172
|
-
- "How to map StoreID field across providers?"
|
|
173
|
-
- "Which providers support cold-chain shipping?"
|
|
174
|
-
|
|
175
|
-
```bash
|
|
176
|
-
python3 scripts/search.py "<query>" [--domain <domain>] [--format json]
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
### Recommendation System
|
|
180
|
-
|
|
181
|
-
Use when user asks:
|
|
182
|
-
- "Which logistics provider should I use for cold-chain?"
|
|
183
|
-
- "Best aggregator for high-volume CVS pickup?"
|
|
184
|
-
- "Need overseas shipping integration"
|
|
185
|
-
|
|
186
|
-
```bash
|
|
187
|
-
python3 scripts/recommend.py "<requirements>" [--format ascii|json|simple]
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
### Connection Testing
|
|
191
|
-
|
|
192
|
-
Use when user wants to:
|
|
193
|
-
- Test API connectivity
|
|
194
|
-
- Verify encryption implementation
|
|
195
|
-
- Check test credentials
|
|
196
|
-
|
|
197
|
-
```bash
|
|
198
|
-
python3 scripts/test_logistics.py [--platform ecpay|newebpay|payuni]
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
## Data-Driven Architecture
|
|
202
|
-
|
|
203
|
-
All core logic is in CSV files:
|
|
204
|
-
|
|
205
|
-
- **providers.csv** - Provider details (encryption, API endpoints, test accounts, coverage)
|
|
206
|
-
- **operations.csv** - API operations (create, query, cancel, print, store-map)
|
|
207
|
-
- **logistics-types.csv** - 25+ logistics type combos (CVS B2C/C2C × 4 carriers, Home, Cold-chain)
|
|
208
|
-
- **status-codes.csv** - Shipment status code lookup
|
|
209
|
-
- **field-mappings.csv** - Field name mappings across providers
|
|
210
|
-
|
|
211
|
-
To add new data, edit CSV files directly. No code changes needed.
|
|
212
|
-
|
|
213
|
-
## Encryption Methods
|
|
214
|
-
|
|
215
|
-
### ECPay - SHA256 CheckMacValue
|
|
216
|
-
|
|
217
|
-
```python
|
|
218
|
-
def generate_check_mac_value(params, hash_key, hash_iv):
|
|
219
|
-
sorted_params = sorted(params.items())
|
|
220
|
-
param_str = '&'.join(f'{k}={v}' for k, v in sorted_params)
|
|
221
|
-
raw = f'HashKey={hash_key}&{param_str}&HashIV={hash_iv}'
|
|
222
|
-
encoded = urllib.parse.quote_plus(raw).lower()
|
|
223
|
-
return hashlib.sha256(encoded.encode('utf-8')).hexdigest().upper()
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
### NewebPay - AES-256-CBC + SHA256
|
|
227
|
-
|
|
228
|
-
```python
|
|
229
|
-
def generate_trade_info(params, hash_key, hash_iv):
|
|
230
|
-
query_string = urllib.parse.urlencode(params)
|
|
231
|
-
cipher = AES.new(hash_key.encode(), AES.MODE_CBC, hash_iv.encode())
|
|
232
|
-
padded = pad(query_string.encode(), AES.block_size)
|
|
233
|
-
return cipher.encrypt(padded).hex()
|
|
234
|
-
|
|
235
|
-
def generate_trade_sha(trade_info, hash_key, hash_iv):
|
|
236
|
-
raw = f'HashKey={hash_key}&{trade_info}&HashIV={hash_iv}'
|
|
237
|
-
return hashlib.sha256(raw.encode()).hexdigest().upper()
|
|
238
|
-
```
|
|
239
|
-
|
|
240
|
-
### PAYUNi - AES-256-GCM + SHA256
|
|
241
|
-
|
|
242
|
-
```python
|
|
243
|
-
def generate_encrypt_info(params, hash_key, hash_iv):
|
|
244
|
-
query_string = urllib.parse.urlencode(params)
|
|
245
|
-
cipher = AES.new(hash_key.encode(), AES.MODE_GCM, nonce=hash_iv.encode())
|
|
246
|
-
encrypted, tag = cipher.encrypt_and_digest(query_string.encode())
|
|
247
|
-
return (encrypted + tag).hex() # Must append tag!
|
|
248
|
-
|
|
249
|
-
def generate_hash_info(encrypt_info, hash_key, hash_iv):
|
|
250
|
-
raw = encrypt_info + hash_key + hash_iv
|
|
251
|
-
return hashlib.sha256(raw.encode()).hexdigest().upper()
|
|
252
|
-
```
|
|
253
|
-
|
|
254
|
-
## Test Accounts
|
|
255
|
-
|
|
256
|
-
### ECPay
|
|
257
|
-
```
|
|
258
|
-
商店代號: 2000132
|
|
259
|
-
HashKey: 5294y06JbISpM5x9
|
|
260
|
-
HashIV: v77hoKGq4kWxNNIS
|
|
261
|
-
測試網址: https://logistics-stage.ecpay.com.tw
|
|
262
|
-
```
|
|
263
|
-
|
|
264
|
-
### NewebPay
|
|
265
|
-
```
|
|
266
|
-
商店代號: 請至後台申請
|
|
267
|
-
HashKey: 請至後台申請
|
|
268
|
-
HashIV: 請至後台申請
|
|
269
|
-
測試網址: https://ccore.newebpay.com/API/Logistic
|
|
270
|
-
```
|
|
271
|
-
|
|
272
|
-
### PAYUNi
|
|
273
|
-
```
|
|
274
|
-
商店代號: 請至後台申請
|
|
275
|
-
HashKey: 請至後台申請
|
|
276
|
-
HashIV: 請至後台申請
|
|
277
|
-
測試網址: https://sandbox-api.payuni.com.tw/api/logistics
|
|
278
|
-
```
|
|
279
|
-
|
|
280
|
-
## Publishing Workflow
|
|
281
|
-
|
|
282
|
-
Before publishing to npm:
|
|
283
|
-
|
|
284
|
-
1. Update version in `cli/package.json`
|
|
285
|
-
2. Sync assets: `cp -r taiwan-logistics/* cli/assets/taiwan-logistics/`
|
|
286
|
-
3. Build CLI: `cd cli && npm run build`
|
|
287
|
-
4. Test locally: `npm test`
|
|
288
|
-
5. Publish: `npm publish`
|
|
289
|
-
|
|
290
130
|
## Related Projects
|
|
291
131
|
|
|
292
|
-
- **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego)
|
|
293
|
-
- **Taiwan Payment Skill** - Payment
|
|
132
|
+
- **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow)
|
|
133
|
+
- **Taiwan Payment Skill** - Payment integration (10 providers including ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, TapPay)
|
|
294
134
|
|
|
295
135
|
---
|
|
296
136
|
|
|
297
|
-
**Last Updated**: 2026-05-07
|
|
137
|
+
**Last Updated**: 2026-05-07 (Phase 4: +4 logistics providers — SmilePay, PChomePay, PayNow, HCT direct)
|
|
@@ -341,7 +341,7 @@ taiwan-logistics/
|
|
|
341
341
|
<details>
|
|
342
342
|
<summary><b>是否需要申請物流服務商憑證?</b></summary>
|
|
343
343
|
|
|
344
|
-
是的。需向選定的物流服務商申請商店代號 (Merchant ID) 與 API 金鑰 (Hash Key/IV)
|
|
344
|
+
是的。需向選定的物流服務商申請商店代號 (Merchant ID) 與 API 金鑰 (Hash Key/IV)。七家物流服務商皆提供測試環境與測試帳號供開發使用。
|
|
345
345
|
|
|
346
346
|
</details>
|
|
347
347
|
|
|
@@ -1,6 +1,24 @@
|
|
|
1
1
|
# Taiwan Logistics Development Skill
|
|
2
2
|
|
|
3
|
-
**Comprehensive guide for Taiwan Logistics integration (NewebPay,
|
|
3
|
+
**Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow + HCT direct API)**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Supported Providers
|
|
8
|
+
|
|
9
|
+
This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
10
|
+
|
|
11
|
+
| Provider | 類型 | Reference |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| **ECPay 綠界** | aggregator | `references/ecpay-logistics-api.md` |
|
|
14
|
+
| **NewebPay 藍新** | aggregator | `references/NEWEBPAY_LOGISTICS_REFERENCE.md` |
|
|
15
|
+
| **PAYUNi 統一** | aggregator | `references/payuni-logistics-api.md` |
|
|
16
|
+
| **SmilePay 速買配** | aggregator (含 7-11/全家 + 黑貓 Pay_zg 矩陣) | `references/smilepay-logistics-api.md` |
|
|
17
|
+
| **PChomePay 拍錢包** | aggregator (金物流二合一) | `references/pchomepay-logistics-api.md` |
|
|
18
|
+
| **PayNow 立吉富** | aggregator (11 條產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
|
|
19
|
+
| **HCT 新竹物流** | **直連 carrier API** | `references/hct-logistics-api.md` |
|
|
20
|
+
|
|
21
|
+
> 註:選用 `HCT 直連 API` 適合大量出貨企業;一般電商透過 aggregator (`LogisticsType=HCT`) 走 HCT 配送即可,不需自行串接。
|
|
4
22
|
|
|
5
23
|
---
|
|
6
24
|
|
|
@@ -9,3 +9,24 @@ update_store,更新門市,/Express/UpdateStoreInfo,/API/Logistic/modifyShipment,
|
|
|
9
9
|
get_shipment_no,取得託運單號,,/API/Logistic/getShipmentNo,,POST,"MerchantID,LogisticsID",,NewebPay專用
|
|
10
10
|
trace,追蹤物流,,/API/Logistic/trace,,POST,"MerchantID,LogisticsID",,NewebPay專用
|
|
11
11
|
cancel,取消物流訂單,,,/logistics/cancel,POST,"MerID,MerTradeNo",,PAYUNi專用
|
|
12
|
+
sp_cvs_get,SmilePay 超商取號,,,,POST,"Dcvc,Verify_key,Pay_zg,Pay_subzg,Data_id,Amount,Pur_name,Pur_telno,Roturl",,SmilePay /api/C2CPayment.asp 或 /api/B2CPayment.asp
|
|
13
|
+
sp_tcat_get,SmilePay 黑貓取號,,,,POST,"Dcvc,Verify_key,Pay_zg=81/82/83,Data_id,Amount,Pur_name,Address",,SmilePay /api/ezcatGetTrackNum.asp (Pay_zg=81 COD, =82 PICKUP, =83 逆物流)
|
|
14
|
+
sp_emap,SmilePay 電子地圖選店,,,,GET,"Dcvc,TypesServer,TypesInterface,RtURL",,SmilePay /api/LogisticsEmap.asp; TypesServer=711C2C/FAMIC2C/711B2C/FAMIB2C × MOBILE/WEB
|
|
15
|
+
sp_print_b2c,SmilePay B2C 列印託運單,,,,POST,"PaymentNo[]",,SmilePay /api/B2C_MultiplePrint.asp 多筆列印
|
|
16
|
+
pcp_logistic_batch,PChomePay 取號列印交寄單,,,,POST,"order_id,store_id,return_store_id,name,address",,/v1/logistic/batch
|
|
17
|
+
pcp_logistic_history,PChomePay 查詢物流歷程,,,,GET,"order_id",,/v1/logistic/query/{order_id}/history
|
|
18
|
+
pcp_logistic_yet,PChomePay 查詢未出貨,,,,GET,,,/v1/logistic/yet
|
|
19
|
+
pcp_logistic_store_return,PChomePay 查詢未取貨,,,,GET,"date YYYYMMDD",,/v1/logistic/store_return/{date}
|
|
20
|
+
pcp_logistic_accounting,PChomePay 物流手續費對帳,,,,GET,"date YYYYMMDD",,/v1/logistic/accounting/{date} 回應為 NDJSON
|
|
21
|
+
pcp_logistic_compensation,PChomePay 賠款入帳查詢,,,,GET,"date YYYYMM",,/v1/logistic/compensation/{date}
|
|
22
|
+
pn_logistic_create,PayNow 建立物流訂單,,,,POST,"ServiceID,GoodsName,Amount,Receiver*,Sender*",,PayNow /service/sevp_logistic.aspx; 11 條產品線各有不同 ServiceID
|
|
23
|
+
pn_logistic_emap,PayNow 電子地圖選店,,,,GET,"merID,LogisticServiceID,ReturnURL",,PayNow 物流選店頁面導轉
|
|
24
|
+
pn_logistic_print,PayNow 列印託運單,,,,POST,"LogisticTradeNo",,PayNow 列印託運單
|
|
25
|
+
pn_logistic_status,PayNow 查詢貨況,,,,POST,"LogisticTradeNo",,PayNow 查詢物流狀態
|
|
26
|
+
hct_query_url,HCT 查貨網頁串接,,,,GET,"加密字串,v",,HCT 直連 /phone/searchGoods_Main.aspx?no=加密字串&v=xx (URL 嵌入)
|
|
27
|
+
hct_query_xml,HCT 多筆貨號查詢,,,,POST,"加密後XML",,HCT 直連 /phone/searchGoods_Main_Xml.ashx (XML POST)
|
|
28
|
+
hct_transdata,HCT 傳入託運資料,,,,POST,"esdate,epino,epdcl1,epdcl2,..",,HCT 直連 TransData (DataSet/JSON/XML 三種變體)
|
|
29
|
+
hct_upddata,HCT 修改重量,,,,POST,"esdate,epino,eqmny",,HCT UpdData
|
|
30
|
+
hct_transreport,HCT 列印託運總表,,,,POST,"esdate,epino[]",,HCT TransReport (18:00 前 must call)
|
|
31
|
+
hct_query_edelno,HCT 查詢貨號,,,,POST,"esdate,epino",,HCT QueryEDELNO
|
|
32
|
+
hct_r_transdata,HCT 逆物流託運,,,,POST,"esdate,epino,...",,HCT R_TransData (JSON-only)
|
|
@@ -9,3 +9,7 @@ hct,新竹物流,HCT,home,true,,,,https://www.hct.com.tw,https://www.hct.com.tw,
|
|
|
9
9
|
pelican,宅配通,Pelican Express,home,true,,,,https://www.pelican.com.tw,https://www.pelican.com.tw,常溫,全台
|
|
10
10
|
newebpay,藍新物流,NewebPay Logistics,payment_aggregator,true,請至後台申請,請至後台申請,請至後台申請,https://ccore.newebpay.com/API/Logistic,https://core.newebpay.com/API/Logistic,"7-11,全家,萊爾富,OK,黑貓,AES-256-CBC加密",全台
|
|
11
11
|
payuni,統一物流,PAYUNi Logistics,payment_aggregator,true,請至後台申請,請至後台申請,請至後台申請,https://sandbox-api.payuni.com.tw/api/logistics,https://api.payuni.com.tw/api/logistics,"7-11常溫/冷凍,T-Cat宅配,AES-256-GCM加密",全台
|
|
12
|
+
smilepay,速買配物流,SmilePay Logistics,payment_aggregator,true,1111,174A02F97A95F72CE301137B3F98D128,,https://ssl.smse.com.tw/api,https://ssl.smse.com.tw/api,"7-11/全家 C2C+B2C,黑貓 COD/PICKUP/逆物流,Pay_zg矩陣 51/52/55/56/81/82/83",全台
|
|
13
|
+
pchomepay,拍錢包物流,PChomePay Logistics,payment_aggregator,true,請至後台申請,請至後台申請,,https://sandbox-api.pchomepay.com.tw,https://api.pchomepay.com.tw,"金物流二合一,7-11/全家/萊爾富/OK,Notify IP白名單113.196.231.190",全台
|
|
14
|
+
paynow,立吉富物流,PayNow Logistics,payment_aggregator,true,請至後台申請,請至後台申請,12345678,https://test.paynow.com.tw/service/etopm.aspx,https://www.paynow.com.tw/service/etopm.aspx,"11產品線(7-11/全家/黑貓/海外),3DES/ECB/Zero-Padding加密",全台
|
|
15
|
+
hct_direct,新竹物流(直連),HCT Direct API,carrier,true,test,,,https://hctapiweb.hct.com.tw,https://hctapiweb.hct.com.tw,"查貨服務+出貨API,XML/JSON/DataSet,加密金鑰申請後提供",全台
|