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.
Files changed (27) hide show
  1. package/assets/taiwan-logistics/CLAUDE.md +0 -3
  2. package/assets/taiwan-logistics/EXAMPLES.md +27 -49
  3. package/assets/taiwan-logistics/SKILL.md +41 -57
  4. package/assets/taiwan-logistics/data/operations.csv +11 -11
  5. package/assets/taiwan-logistics/data/status-codes.csv +496 -6
  6. package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +2 -2
  7. package/assets/taiwan-logistics/examples/ezship-logistics-example.py +17 -19
  8. package/assets/taiwan-logistics/examples/hct-logistics-example.py +5 -7
  9. package/assets/taiwan-logistics/examples/newebpay-logistics-cvs-example.py +0 -1
  10. package/assets/taiwan-logistics/examples/paynow-logistics-cvs-example.py +1 -1
  11. package/assets/taiwan-logistics/examples/payuni-logistics-cvs-example.py +110 -196
  12. package/assets/taiwan-logistics/examples/pchomepay-logistics-cvs-example.py +1 -2
  13. package/assets/taiwan-logistics/examples/smilepay-logistics-cvs-example.py +0 -1
  14. package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +1 -7
  15. package/assets/taiwan-logistics/references/carrier-direct-access.md +0 -1
  16. package/assets/taiwan-logistics/references/ecpay-logistics-api.md +1 -5
  17. package/assets/taiwan-logistics/references/ezship-logistics-api.md +2 -3
  18. package/assets/taiwan-logistics/references/hct-logistics-api.md +0 -3
  19. package/assets/taiwan-logistics/references/lalamove-logistics-api.md +1 -1
  20. package/assets/taiwan-logistics/references/ondemand-delivery.md +0 -1
  21. package/assets/taiwan-logistics/references/paynow-logistics-api.md +0 -3
  22. package/assets/taiwan-logistics/references/payuni-logistics-api.md +126 -212
  23. package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +0 -3
  24. package/assets/taiwan-logistics/references/smilepay-logistics-api.md +0 -3
  25. package/assets/taiwan-logistics/scripts/core.py +1 -2
  26. package/assets/templates/base/skill-content.md +41 -57
  27. 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
- > 端點、欄位、代碼依 wpbr-payuni-shipping 1.6.4(正式上架外掛);加解密由 CI 以統一金流官方外掛與
1271
- > 官方 PHP SDK 產生的標準答案驗證。規格細節見 `references/payuni-logistics-api.md`,
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 = '1.1') {
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; // 外層錯誤(例如 API00003)
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 店到店,取貨不付款(StoreID 來自門市地圖 /logistics/ship_map 的回傳)
1322
- const created = await payuniPost('/logistics/trade', {
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
- MerTradeNo: `LOG${Date.now()}`,
1326
- GoodsType: '1', // 1=常溫 2=冷凍
1327
- LgsType: 'C2C', // C2C / B2C
1328
- ShipType: '1', // 1=7-ELEVEN
1329
- TradeAmt: 500, // 取貨不付款時為報值金額
1330
- ServiceType: '3', // 1=取貨付款 3=取貨不付款
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
- RefundStoreID: '',
1336
- SenderName: '測試商家',
1337
- SenderMobile: '0912345678',
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
- // status.ShipStatus: 21 待出貨 / 22 物流中心驗收 / 92 寄件門市已收件 / 31 配送中 / 32 待取貨 / 11 已取貨
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
- // 先驗 HashInfo(官方外掛沒驗,這是疏漏,不要照抄)
1364
- if (HashInfo !== undefined) {
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
- > Endpoints, fields and codes below follow the production plugin wpbr-payuni-shipping 1.6.4;
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
- | 7-11 store map (browser form) | `/logistics/ship_map` | 1.1 |
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
- **Codes:** `ShipType` 1=7-ELEVEN 2=T-Cat · `LgsType` C2C / B2C / HOME · `GoodsType` 1=normal 2=frozen 3=refrigerated ·
165
- `ServiceType` 1=COD 3=no COD · `DeliveryTimeTag` 01 / 02 / 04(not set)
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
- > Strings like `PAYUNi_Logistic_711` are WooCommerce shipping-method IDs of the official plugin, **not** API values.
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
- `POST /api/logistics/trade` (7-11) or `POST /api/home_delivery/trade` (T-Cat), Version `1.1`.
618
-
619
- | EncryptInfo field | 7-11 | T-Cat | Notes |
612
+ | EncryptInfo field | UPP | Backend API | Notes |
620
613
  |---|:-:|:-:|---|
621
- | MerID, Timestamp | ● | ● | |
622
- | MerTradeNo | ● | ● | |
623
- | GoodsType / LgsType / ShipType | ● | ● | see codes above |
624
- | TradeAmt | ● | ● | COD amount, or declared value when not COD |
625
- | ServiceType | ● | ● | 1 = COD, 3 = no COD |
626
- | StoreID | ● | empty | from the store map |
627
- | Consignee / ConsigneeMail / ConsigneeMobile | ● | ● | |
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
- `POST /api/logistics/query`, Version `1.1`, EncryptInfo: `MerID`, `Timestamp`, `LgsType`, `ShipTradeNo`.
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
- **ShipStatus codes** (plugin `Utils/ShippingStatus.php`):
624
+ ### 2. Query shipment
641
625
 
642
- | Code | Meaning |
643
- |---|---|
644
- | 21 | Waiting for shipment |
645
- | 22 | Checked in at logistics center (CVS only) |
646
- | 92 | Processing / received at sender store (C2C) |
647
- | 31 | In delivery |
648
- | 32 | Arrived at pickup store |
649
- | 11 | Picked up |
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 POSTs `EncryptInfo` (+ `HashInfo`) to `NotifyURL`. Decrypted `ApiType` is `ShipStatus`
654
- (status update: `ShipTradeNo`, `ShipStatus`, `ShipStatusDesc`, `ShipStatusTime`; T-Cat adds `OBTNumber`, `FileNo`)
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,/logistics/trade,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,/home_delivery/trade,POST,"MerchantID,MerchantTradeNo,LogisticsType,LogisticsSubType,GoodsAmount,GoodsName,SenderName,SenderPhone,SenderAddress,ReceiverName,ReceiverPhone,ReceiverAddress,ServerReplyURL","Temperature,Distance,Specification,ScheduledDeliveryTime",LogisticsType=Home
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,,POST,"MerchantID,AllPayLogisticsID,ReceiverStoreID","CVSPaymentNo,CVSValidationNo",僅限超商取貨
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,"PaymentNo[]",,SmilePay /api/B2C_MultiplePrint.asp 多筆列印
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,"order_id",,/v1/logistic/query/{order_id}/history
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,"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}
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,"LogisticTradeNo",,PayNow 列印託運單
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,"加密後XML",,HCT 直連 /phone/searchGoods_Main_Xml.ashx (XML 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)