taiwan-logistics-skill 1.4.2 → 1.4.3
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 +0 -3
- package/assets/taiwan-logistics/EXAMPLES.md +27 -49
- package/assets/taiwan-logistics/SKILL.md +41 -57
- package/assets/taiwan-logistics/data/operations.csv +11 -11
- package/assets/taiwan-logistics/data/status-codes.csv +496 -6
- package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +2 -2
- package/assets/taiwan-logistics/examples/ezship-logistics-example.py +17 -19
- package/assets/taiwan-logistics/examples/hct-logistics-example.py +5 -7
- package/assets/taiwan-logistics/examples/newebpay-logistics-cvs-example.py +0 -1
- package/assets/taiwan-logistics/examples/paynow-logistics-cvs-example.py +1 -1
- package/assets/taiwan-logistics/examples/payuni-logistics-cvs-example.py +110 -196
- package/assets/taiwan-logistics/examples/pchomepay-logistics-cvs-example.py +1 -2
- package/assets/taiwan-logistics/examples/smilepay-logistics-cvs-example.py +0 -1
- package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +1 -7
- package/assets/taiwan-logistics/references/carrier-direct-access.md +0 -1
- package/assets/taiwan-logistics/references/ecpay-logistics-api.md +1 -5
- package/assets/taiwan-logistics/references/ezship-logistics-api.md +2 -3
- package/assets/taiwan-logistics/references/hct-logistics-api.md +0 -3
- package/assets/taiwan-logistics/references/lalamove-logistics-api.md +1 -1
- package/assets/taiwan-logistics/references/ondemand-delivery.md +0 -1
- package/assets/taiwan-logistics/references/paynow-logistics-api.md +0 -3
- package/assets/taiwan-logistics/references/payuni-logistics-api.md +126 -212
- package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +0 -3
- package/assets/taiwan-logistics/references/smilepay-logistics-api.md +0 -3
- package/assets/taiwan-logistics/scripts/core.py +1 -2
- package/assets/templates/base/skill-content.md +41 -57
- package/package.json +1 -1
|
@@ -144,6 +144,3 @@ Never push directly to `main`. Always:
|
|
|
144
144
|
- **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow)
|
|
145
145
|
- **Taiwan Payment Skill** - Payment integration (14 providers: ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay, GoMyPay)
|
|
146
146
|
|
|
147
|
-
---
|
|
148
|
-
|
|
149
|
-
**Last Updated**: 2026-05-07 (Phase 4: +4 logistics providers — SmilePay, PChomePay, PayNow, HCT direct)
|
|
@@ -1267,12 +1267,8 @@ if __name__ == '__main__':
|
|
|
1267
1267
|
|
|
1268
1268
|
## PAYUNi Logistics Examples
|
|
1269
1269
|
|
|
1270
|
-
>
|
|
1271
|
-
>
|
|
1272
|
-
> 完整 Python 版見 `examples/payuni-logistics-cvs-example.py`。
|
|
1273
|
-
>
|
|
1274
|
-
> 舊版範例中的 `/logistics/create`、`LogisticsType`、`GoodsAmount`、`Receiver*`、`LogisticsID`
|
|
1275
|
-
> 皆不存在於 PAYUNi 物流 API,請勿沿用。
|
|
1270
|
+
> 依 PAYUNi 官方文件(docs.payuni.com.tw/web/#/7);加解密由 CI 以官方外掛與官方 PHP SDK 的標準答案驗證。
|
|
1271
|
+
> 規格見 `references/payuni-logistics-api.md`,Python 版見 `examples/payuni-logistics-cvs-example.py`。
|
|
1276
1272
|
|
|
1277
1273
|
### 1. Encryption Helper (TypeScript)
|
|
1278
1274
|
|
|
@@ -1299,49 +1295,47 @@ export function decryptPAYUNi(encryptInfo: string, hashKey: string, hashIV: stri
|
|
|
1299
1295
|
}
|
|
1300
1296
|
```
|
|
1301
1297
|
|
|
1302
|
-
### 2. Create Shipment
|
|
1298
|
+
### 2. Create Shipment(在交易 API 內建立)
|
|
1303
1299
|
|
|
1304
1300
|
```typescript
|
|
1305
1301
|
const BASE = 'https://sandbox-api.payuni.com.tw/api';
|
|
1306
1302
|
|
|
1307
|
-
async function payuniPost(path: string, info: Record<string, any>, version
|
|
1303
|
+
async function payuniPost(path: string, info: Record<string, any>, version: string) {
|
|
1308
1304
|
const { EncryptInfo, HashInfo } = encryptPAYUNi(info, HASH_KEY, HASH_IV);
|
|
1309
1305
|
const res = await fetch(`${BASE}${path}`, {
|
|
1310
1306
|
method: 'POST',
|
|
1311
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
1307
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded', 'User-Agent': 'payuni' },
|
|
1312
1308
|
body: new URLSearchParams({ MerID: MER_ID, Version: version, EncryptInfo, HashInfo }),
|
|
1313
1309
|
});
|
|
1314
1310
|
const body = await res.json();
|
|
1315
|
-
if (!body.EncryptInfo) return body;
|
|
1311
|
+
if (!body.EncryptInfo) return body;
|
|
1316
1312
|
const expected = crypto.createHash('sha256').update(HASH_KEY + body.EncryptInfo + HASH_IV).digest('hex').toUpperCase();
|
|
1317
1313
|
if (expected !== body.HashInfo) throw new Error('HashInfo 驗證失敗');
|
|
1318
1314
|
return decryptPAYUNi(body.EncryptInfo, HASH_KEY, HASH_IV);
|
|
1319
1315
|
}
|
|
1320
1316
|
|
|
1321
|
-
// 7-11
|
|
1322
|
-
const created = await payuniPost('/
|
|
1317
|
+
// 超商代碼幕後交易 + 7-11 店到店取貨不付款(StoreID 來自門市地圖)
|
|
1318
|
+
const created = await payuniPost('/cvs', {
|
|
1323
1319
|
MerID: MER_ID,
|
|
1320
|
+
MerTradeNo: `ORD${Date.now()}`,
|
|
1321
|
+
TradeAmt: 500,
|
|
1324
1322
|
Timestamp: Math.floor(Date.now() / 1000),
|
|
1325
|
-
|
|
1326
|
-
|
|
1327
|
-
|
|
1328
|
-
|
|
1329
|
-
|
|
1330
|
-
|
|
1331
|
-
StoreID: '123456',
|
|
1323
|
+
ProdDesc: '商品',
|
|
1324
|
+
UsrMail: 'buyer@example.com', // 有物流時必填,視為收件人信箱
|
|
1325
|
+
ServiceType: '3', // 幕後 API 只支援取貨不付款
|
|
1326
|
+
LgsType: 'C2C', // B2C / C2C / HOME
|
|
1327
|
+
ShipType: '1', // 1=7-ELEVEN 2=黑貓
|
|
1328
|
+
GoodsType: '1', // 1=常溫 2=冷凍 3=冷藏(僅黑貓)
|
|
1332
1329
|
Consignee: '王小明',
|
|
1333
|
-
ConsigneeMail: 'buyer@example.com',
|
|
1334
1330
|
ConsigneeMobile: '0987654321',
|
|
1335
|
-
|
|
1336
|
-
|
|
1337
|
-
|
|
1338
|
-
NotifyURL: 'https://your-site.com/payuni/shipping-notify',
|
|
1339
|
-
});
|
|
1340
|
-
// 黑貓宅配改呼叫 /home_delivery/trade,ShipType='2'、LgsType='HOME'、StoreID='',
|
|
1341
|
-
// 並加上 ConsigneeAddress、ProdDesc(≤20 字)、DeliveryTimeTag(01 / 02 / 04)
|
|
1331
|
+
StoreID: '916712',
|
|
1332
|
+
}, '1.3');
|
|
1333
|
+
// 黑貓改 LgsType='HOME'、ShipType='2',並帶 ConsigneeAddress、DeliveryTimeTag(01 / 02 / 04)
|
|
1342
1334
|
console.log(created.Status, created.ShipTradeNo); // ShipTradeNo 是後續查詢、列印、通知的鍵
|
|
1343
1335
|
```
|
|
1344
1336
|
|
|
1337
|
+
UPP 則在 EncryptInfo 帶 `ShipTag=1`(取貨付款另帶 `Ship=1`)及 `LgsType`、`ShipType`、`GoodsType`、`Consignee`、`ConsigneeMobile`,門市由消費者在支付頁選。
|
|
1338
|
+
|
|
1345
1339
|
### 3. Query Shipment
|
|
1346
1340
|
|
|
1347
1341
|
```typescript
|
|
@@ -1350,21 +1344,19 @@ const status = await payuniPost('/logistics/query', {
|
|
|
1350
1344
|
Timestamp: Math.floor(Date.now() / 1000),
|
|
1351
1345
|
LgsType: 'C2C',
|
|
1352
1346
|
ShipTradeNo: created.ShipTradeNo,
|
|
1353
|
-
});
|
|
1354
|
-
//
|
|
1347
|
+
}, '1.1');
|
|
1348
|
+
// ShipStatus 見官方貨態碼:91 未處理、21 待出貨、31 配送中、32 待取貨、11 已取貨、52 買家未取、81 門市關轉…
|
|
1355
1349
|
console.log(status.ShipStatus, status.ShipStatusDesc, status.Odno);
|
|
1356
1350
|
```
|
|
1357
1351
|
|
|
1358
1352
|
### 4. Status Notification Callback
|
|
1359
1353
|
|
|
1360
1354
|
```typescript
|
|
1355
|
+
// Notify URL 於 PAYUNi 後台「物流設定」填寫
|
|
1361
1356
|
app.post('/payuni/shipping-notify', express.urlencoded({ extended: false }), (req, res) => {
|
|
1362
1357
|
const { EncryptInfo, HashInfo } = req.body;
|
|
1363
|
-
|
|
1364
|
-
if (
|
|
1365
|
-
const expected = crypto.createHash('sha256').update(HASH_KEY + EncryptInfo + HASH_IV).digest('hex').toUpperCase();
|
|
1366
|
-
if (expected !== HashInfo) return res.status(400).end();
|
|
1367
|
-
}
|
|
1358
|
+
const expected = crypto.createHash('sha256').update(HASH_KEY + EncryptInfo + HASH_IV).digest('hex').toUpperCase();
|
|
1359
|
+
if (expected !== HashInfo) return res.status(400).end();
|
|
1368
1360
|
const info = decryptPAYUNi(EncryptInfo, HASH_KEY, HASH_IV);
|
|
1369
1361
|
if (info.Status === 'SUCCESS' && info.ApiType === 'ShipStatus') {
|
|
1370
1362
|
updateShipment(info.ShipTradeNo, info.ShipStatus, info.ShipStatusDesc, info.ShipStatusTime);
|
|
@@ -1626,11 +1618,7 @@ export { ECPayCVSLogistics };
|
|
|
1626
1618
|
|
|
1627
1619
|
```python
|
|
1628
1620
|
#!/usr/bin/env python3
|
|
1629
|
-
"""
|
|
1630
|
-
Create CVS C2C Shipment - ECPay Python Example
|
|
1631
|
-
|
|
1632
|
-
依照 taiwan-logistics-skill 嚴格規範撰寫
|
|
1633
|
-
"""
|
|
1621
|
+
"""Create CVS C2C Shipment - ECPay Python Example"""
|
|
1634
1622
|
|
|
1635
1623
|
import requests
|
|
1636
1624
|
import urllib.parse
|
|
@@ -2538,12 +2526,6 @@ try {
|
|
|
2538
2526
|
|
|
2539
2527
|
---
|
|
2540
2528
|
|
|
2541
|
-
**Total Lines**: 1400+
|
|
2542
|
-
|
|
2543
|
-
This comprehensive guide covers all major NewebPay Logistics integration scenarios with production-ready code examples.
|
|
2544
|
-
|
|
2545
|
-
---
|
|
2546
|
-
|
|
2547
2529
|
## SmilePay 速買配物流範例
|
|
2548
2530
|
|
|
2549
2531
|
SmilePay 透過 `Pay_zg` 矩陣編碼涵蓋 7-11/全家 + 黑貓三大配送:
|
|
@@ -2644,7 +2626,3 @@ SmilePay 透過 `Pay_zg` 矩陣編碼涵蓋 7-11/全家 + 黑貓三大配送:
|
|
|
2644
2626
|
### 門市代碼
|
|
2645
2627
|
|
|
2646
2628
|
可能四碼或五碼(如 `TFM9771`),且**與門市服務代號不一定相同**。直接把 ezShip 給的值原封回傳即可,不要自行轉換。
|
|
2647
|
-
|
|
2648
|
-
---
|
|
2649
|
-
|
|
2650
|
-
**更多範例持續更新中...**
|
|
@@ -140,31 +140,26 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
|
140
140
|
**Encryption**: AES-256-GCM + SHA256 (same as PAYUNi payment):
|
|
141
141
|
`EncryptInfo = hex(base64(ciphertext) + ":::" + base64(tag))`, `HashInfo = SHA256(HashKey + EncryptInfo + HashIV)`
|
|
142
142
|
|
|
143
|
-
**API Style**: form POST (`MerID`, `Version`, `EncryptInfo`, `HashInfo`), JSON response with an encrypted `EncryptInfo
|
|
143
|
+
**API Style**: form POST (`MerID`, `Version`, `EncryptInfo`, `HashInfo`), JSON response with an encrypted `EncryptInfo`.
|
|
144
|
+
Source: official docs docs.payuni.com.tw/web/#/7; details in `references/payuni-logistics-api.md`.
|
|
144
145
|
|
|
145
|
-
|
|
146
|
-
> crypto is verified byte-for-byte against the official PAYUNi plugin and PHP SDK.
|
|
147
|
-
> Full details: `references/payuni-logistics-api.md`.
|
|
148
|
-
|
|
149
|
-
**Supported Services:**
|
|
150
|
-
- C2C Store-to-Store: 7-ELEVEN (normal temperature + frozen)
|
|
151
|
-
- B2C Bulk Warehouse: 7-ELEVEN only
|
|
152
|
-
- Home Delivery: T-Cat (normal temperature, frozen, refrigerated)
|
|
146
|
+
**Supported Services:** 7-ELEVEN B2C bulk / C2C store-to-store / C2B return (normal + frozen); T-Cat home delivery (normal, frozen, refrigerated)
|
|
153
147
|
|
|
154
148
|
**Endpoints** (base `https://sandbox-api.payuni.com.tw/api` / `https://api.payuni.com.tw/api`):
|
|
155
149
|
|
|
156
150
|
| Purpose | Path | Version |
|
|
157
151
|
|---|---|---|
|
|
158
|
-
|
|
|
159
|
-
| Create 7-11 shipment | `/logistics/trade` | 1.1 |
|
|
160
|
-
| Create T-Cat shipment | `/home_delivery/trade` | 1.1 |
|
|
152
|
+
| Store map (browser form) | `/logistics/ship_map` | 1.1 |
|
|
161
153
|
| Query shipment | `/logistics/query` | 1.1 |
|
|
162
154
|
| Print 7-11 label (browser form) | `/logistics/print_label` | 1.0 |
|
|
155
|
+
| T-Cat label PDF (browser form) | `/home_delivery/get_obt_number_pdf` | 1.0 |
|
|
156
|
+
| T-Cat label re-download | `/home_delivery/download_pdf` | 1.0 |
|
|
163
157
|
|
|
164
|
-
|
|
165
|
-
|
|
158
|
+
Shipments are created inside a payment request: UPP with `ShipTag=1` (+ `Ship=1` for COD), or the backend
|
|
159
|
+
ATM / CVS / credit-token / LINE Pay / JKoPay / AFTEE APIs with `ServiceType=3` (no COD).
|
|
166
160
|
|
|
167
|
-
|
|
161
|
+
**Codes:** `ShipType` 1=7-ELEVEN 2=T-Cat · `LgsType` B2C / C2C / HOME / C2B · `GoodsType` 1=normal 2=frozen 3=refrigerated ·
|
|
162
|
+
`DeliveryTimeTag` 01 / 02 / 04(not set)
|
|
168
163
|
|
|
169
164
|
---
|
|
170
165
|
|
|
@@ -612,46 +607,45 @@ the status push (NPA-B58) uses the underscored names.
|
|
|
612
607
|
All requests: form POST `MerID`, `Version`, `EncryptInfo`, `HashInfo`. Verify `HashInfo` on every
|
|
613
608
|
response and notification before decrypting.
|
|
614
609
|
|
|
615
|
-
### 1. Create shipment
|
|
610
|
+
### 1. Create shipment (inside the payment request)
|
|
616
611
|
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
| EncryptInfo field | 7-11 | T-Cat | Notes |
|
|
612
|
+
| EncryptInfo field | UPP | Backend API | Notes |
|
|
620
613
|
|---|:-:|:-:|---|
|
|
621
|
-
|
|
|
622
|
-
|
|
|
623
|
-
|
|
|
624
|
-
|
|
|
625
|
-
|
|
|
626
|
-
| StoreID | ●
|
|
627
|
-
|
|
|
628
|
-
| SenderName / SenderMobile | ● | ● | |
|
|
629
|
-
| NotifyURL | ● | ● | status / print notifications |
|
|
630
|
-
| ConsigneeAddress / ProdDesc / DeliveryTimeTag | | ● | ProdDesc ≤ 20 chars |
|
|
631
|
-
|
|
632
|
-
Response (decrypted): `Status`, `Message`, **`ShipTradeNo`** (used for query / print / notifications), `TradeAmt`, `ServiceType`.
|
|
633
|
-
|
|
634
|
-
### 2. Query shipment
|
|
614
|
+
| ShipTag | 1 | | enable logistics |
|
|
615
|
+
| Ship | 1 = COD | | |
|
|
616
|
+
| ServiceType | | 3 | backend APIs support no-COD only |
|
|
617
|
+
| LgsType / ShipType / GoodsType | ● | ● | |
|
|
618
|
+
| Consignee / ConsigneeMobile | ● | ● | real name, 09xxxxxxxx |
|
|
619
|
+
| StoreID | | ● (7-11) | from the store map |
|
|
620
|
+
| ConsigneeAddress / DeliveryTimeTag | ○ | ● (T-Cat) | |
|
|
635
621
|
|
|
636
|
-
|
|
637
|
-
Response includes `Odno`, `PartnerId`, `ValidationNo` (C2C), `FileNo` (T-Cat), `ShipStatus`,
|
|
638
|
-
`ShipStatusDesc`, `ShipStatusTime` (`-` = not yet available).
|
|
622
|
+
The payment response includes **`ShipTradeNo`** (used for query / print / notifications).
|
|
639
623
|
|
|
640
|
-
|
|
624
|
+
### 2. Query shipment
|
|
641
625
|
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
|
649
|
-
|
|
626
|
+
`POST /api/logistics/query`, Version `1.1`, EncryptInfo: `MerID`, `Timestamp`, `LgsType`, and `ShipTradeNo`
|
|
627
|
+
or `ReturnOdno` (C2B). Response: `Odno`, `PartnerId`, `ValidationNo` (C2C), `FileNo` (T-Cat), `ShipStatus`,
|
|
628
|
+
`ShipStatusDesc`, `ShipStatusTime`, `PickupStoreType` (status 81).
|
|
629
|
+
|
|
630
|
+
**ShipStatus codes** (official page 120):
|
|
631
|
+
|
|
632
|
+
| Code | Meaning | Code | Meaning |
|
|
633
|
+
|---|---|---|---|
|
|
634
|
+
| 91 | Not processed | 11 | Picked up |
|
|
635
|
+
| 92 | Processing (CVS) | 41 | Cancelled |
|
|
636
|
+
| 98 | Processing, received (B2C) | 43 | Compensation |
|
|
637
|
+
| 21 | Waiting for shipment | 44 | Lost |
|
|
638
|
+
| 22 | Logistics-center check-in (CVS) | 46 | Discarded (C2C) |
|
|
639
|
+
| 31 | In delivery | 51 | Return |
|
|
640
|
+
| 32 | At pickup store (CVS) | 52 | Not collected by buyer |
|
|
641
|
+
| 33 | Exception | 53 | Returned to warehouse (CVS) |
|
|
642
|
+
| 81 | Store closed, reselect | 55 | Not collected by seller (C2C) |
|
|
643
|
+
| 82 | Awaiting home-delivery return (C2C) | 56 | Returned by home delivery (C2C) |
|
|
650
644
|
|
|
651
645
|
### 3. Notifications
|
|
652
646
|
|
|
653
|
-
PAYUNi
|
|
654
|
-
(
|
|
647
|
+
The notify URL is set in the PAYUNi back office (logistics settings). Decrypted `ApiType` is `ShipStatus`
|
|
648
|
+
(`ShipTradeNo`, `ShipStatus`, `ShipStatusDesc`, `ShipStatusTime`; T-Cat adds `OBTNumber`, `FileNo`)
|
|
655
649
|
or `Print` (label result). Match orders by `ShipTradeNo`.
|
|
656
650
|
|
|
657
651
|
---
|
|
@@ -707,13 +701,3 @@ or `Print` (label result). Match orders by `ShipTradeNo`.
|
|
|
707
701
|
### NewebPay Technical Support
|
|
708
702
|
- Phone: 02-2655-8938
|
|
709
703
|
- Official Documentation: https://www.newebpay.com
|
|
710
|
-
|
|
711
|
-
### API Version
|
|
712
|
-
Current Version: 1.0
|
|
713
|
-
|
|
714
|
-
### Last Updated
|
|
715
|
-
2026-01-29
|
|
716
|
-
|
|
717
|
-
---
|
|
718
|
-
|
|
719
|
-
**Total Lines**: 750+
|
|
@@ -1,30 +1,30 @@
|
|
|
1
1
|
operation,operation_zh,ecpay_endpoint,newebpay_endpoint,payuni_endpoint,method,required_fields,optional_fields,notes
|
|
2
|
-
create_cvs,建立超商取貨訂單,/Express/Create,/API/Logistic/createShipment
|
|
3
|
-
create_home,建立宅配訂單,/Express/Create,/API/Logistic/createShipment
|
|
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
|
|
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
|
-
print,列印託運單,/helper/printTradeDocument,/API/Logistic/printLabel,/logistics/print_label,POST,"MerchantID,AllPayLogisticsID","LogisticsType,LogisticsSubType",需先建立訂單
|
|
6
|
+
print,列印託運單,/helper/printTradeDocument,/API/Logistic/printLabel,/logistics/print_label;黑貓 /home_delivery/get_obt_number_pdf,POST,"MerchantID,AllPayLogisticsID","LogisticsType,LogisticsSubType",需先建立訂單
|
|
7
7
|
return,逆物流訂單,/Express/ReturnHome,/API/Logistic/returnShipment,,POST,"MerchantID,AllPayLogisticsID,ServerReplyURL","GoodsAmount,SenderName",退貨/換貨
|
|
8
|
-
update_store,更新門市,/Express/UpdateStoreInfo,/API/Logistic/modifyShipment
|
|
8
|
+
update_store,更新門市,/Express/UpdateStoreInfo,/API/Logistic/modifyShipment,/logistics/ship_map(Tag=4 取件門市、Tag=3/5 C2C 退貨門市),POST,"MerchantID,AllPayLogisticsID,ReceiverStoreID","CVSPaymentNo,CVSValidationNo",僅限超商取貨
|
|
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,取消物流訂單,,,,POST,"MerID,MerTradeNo",,PAYUNi專用
|
|
12
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
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
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,
|
|
15
|
+
sp_print_b2c,SmilePay B2C 列印託運單,,,,POST,PaymentNo[],,SmilePay /api/B2C_MultiplePrint.asp 多筆列印
|
|
16
16
|
pcp_logistic_batch,PChomePay 取號列印交寄單,,,,POST,"order_id,store_id,return_store_id,name,address",,/v1/logistic/batch
|
|
17
|
-
pcp_logistic_history,PChomePay 查詢物流歷程,,,,GET,
|
|
17
|
+
pcp_logistic_history,PChomePay 查詢物流歷程,,,,GET,order_id,,/v1/logistic/query/{order_id}/history
|
|
18
18
|
pcp_logistic_yet,PChomePay 查詢未出貨,,,,GET,,,/v1/logistic/yet
|
|
19
|
-
pcp_logistic_store_return,PChomePay 查詢未取貨,,,,GET,
|
|
20
|
-
pcp_logistic_accounting,PChomePay 物流手續費對帳,,,,GET,
|
|
21
|
-
pcp_logistic_compensation,PChomePay 賠款入帳查詢,,,,GET,
|
|
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
22
|
pn_logistic_create,PayNow 建立物流訂單,,,,POST,JsonOrder(Obj_Order JSON 以 3DES/ECB/Zero-Padding 加密後 Base64),,PayNow /api/Orderapi/Add_Order;Logistic_service 01/02/03/04/05/06/07/08/10/21-24;PassCode=SHA1(user_account+OrderNo+TotalAmount+apicode)
|
|
23
23
|
pn_logistic_emap,PayNow 電子地圖選店,,,,POST,"user_account,orderno,apicode(3DES),Logistic_serviceID,returnUrl",,PayNow /Member/Order/Choselogistics(瀏覽器表單)
|
|
24
|
-
pn_logistic_print,PayNow 列印託運單,,,,POST,
|
|
24
|
+
pn_logistic_print,PayNow 列印託運單,,,,POST,LogisticTradeNo,,PayNow 列印託運單
|
|
25
25
|
pn_logistic_status,PayNow 查詢貨況,,,,GET,"orderno,user_account,sno=1",,PayNow /api/Orderapi/Get_Order_Info_orderno
|
|
26
26
|
hct_query_url,HCT 查貨網頁串接,,,,GET,"加密字串,v",,HCT 直連 /phone/searchGoods_Main.aspx?no=加密字串&v=xx (URL 嵌入)
|
|
27
|
-
hct_query_xml,HCT 多筆貨號查詢,,,,POST
|
|
27
|
+
hct_query_xml,HCT 多筆貨號查詢,,,,POST,加密後XML,,HCT 直連 /phone/searchGoods_Main_Xml.ashx (XML POST)
|
|
28
28
|
hct_transdata,HCT 傳入託運資料,,,,POST,"esdate,epino,epdcl1,epdcl2,..",,HCT 直連 TransData (DataSet/JSON/XML 三種變體)
|
|
29
29
|
hct_upddata,HCT 修改重量,,,,POST,"esdate,epino,eqmny",,HCT UpdData
|
|
30
30
|
hct_transreport,HCT 列印託運總表,,,,POST,"esdate,epino[]",,HCT TransReport (18:00 前 must call)
|