taiwan-logistics-skill 1.4.2 → 1.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.md +39 -28
  2. package/assets/taiwan-logistics/CLAUDE.md +18 -17
  3. package/assets/taiwan-logistics/EXAMPLES.md +43 -66
  4. package/assets/taiwan-logistics/README.md +40 -29
  5. package/assets/taiwan-logistics/SKILL.md +70 -78
  6. package/assets/taiwan-logistics/data/logistics-types.csv +54 -30
  7. package/assets/taiwan-logistics/data/operations.csv +11 -11
  8. package/assets/taiwan-logistics/data/status-codes.csv +496 -6
  9. package/assets/taiwan-logistics/examples/ecpay-logistics-cvs-example.py +6 -6
  10. package/assets/taiwan-logistics/examples/ezship-logistics-example.py +52 -30
  11. package/assets/taiwan-logistics/examples/hct-logistics-example.py +6 -9
  12. package/assets/taiwan-logistics/examples/newebpay-logistics-cvs-example.py +0 -1
  13. package/assets/taiwan-logistics/examples/paynow-logistics-cvs-example.py +1 -1
  14. package/assets/taiwan-logistics/examples/payuni-logistics-cvs-example.py +110 -196
  15. package/assets/taiwan-logistics/examples/pchomepay-logistics-cvs-example.py +1 -2
  16. package/assets/taiwan-logistics/examples/smilepay-logistics-cvs-example.py +0 -1
  17. package/assets/taiwan-logistics/examples/store-map-integration-example.html +3 -3
  18. package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +1 -7
  19. package/assets/taiwan-logistics/references/carrier-direct-access.md +2 -3
  20. package/assets/taiwan-logistics/references/ecpay-logistics-api.md +18 -17
  21. package/assets/taiwan-logistics/references/ezship-logistics-api.md +20 -10
  22. package/assets/taiwan-logistics/references/hct-logistics-api.md +1 -4
  23. package/assets/taiwan-logistics/references/lalamove-logistics-api.md +1 -1
  24. package/assets/taiwan-logistics/references/ondemand-delivery.md +0 -1
  25. package/assets/taiwan-logistics/references/paynow-logistics-api.md +2 -5
  26. package/assets/taiwan-logistics/references/payuni-logistics-api.md +126 -212
  27. package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +0 -3
  28. package/assets/taiwan-logistics/references/smilepay-logistics-api.md +0 -3
  29. package/assets/taiwan-logistics/scripts/core.py +3 -4
  30. package/assets/taiwan-logistics/scripts/generate-logistics-service.py +70 -1231
  31. package/assets/taiwan-logistics/scripts/test_logistics.py +108 -262
  32. package/assets/templates/base/quick-reference.md +41 -33
  33. package/assets/templates/base/skill-content.md +64 -78
  34. package/assets/templates/platforms/agent.json +2 -2
  35. package/assets/templates/platforms/claude.json +2 -2
  36. package/assets/templates/platforms/cline.json +3 -3
  37. package/assets/templates/platforms/codebuddy.json +2 -2
  38. package/assets/templates/platforms/codex.json +2 -2
  39. package/assets/templates/platforms/continue.json +2 -2
  40. package/assets/templates/platforms/copilot.json +3 -3
  41. package/assets/templates/platforms/cursor.json +2 -2
  42. package/assets/templates/platforms/gemini.json +2 -2
  43. package/assets/templates/platforms/kiro.json +3 -3
  44. package/assets/templates/platforms/opencode.json +2 -2
  45. package/assets/templates/platforms/qoder.json +2 -2
  46. package/assets/templates/platforms/trae.json +2 -2
  47. package/assets/templates/platforms/windsurf.json +2 -2
  48. package/dist/index.js +20 -13
  49. package/package.json +2 -2
@@ -1,12 +1,18 @@
1
+ ---
2
+ name: taiwan-logistics
3
+ description: Taiwan Logistics API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow and ezShip aggregators, HCT direct carrier API, and on-demand delivery (Lalamove, pandago, Uber Direct). Use when developing shipping flows, implementing CVS pickup (7-11/全家/萊爾富/OK), home delivery (黑貓/中華郵政), cold-chain, store-map selectors, COD orders, or shipment tracking. Handles encryption (MD5, AES-256-CBC, AES-256-GCM, 3DES), store maps, and provider field mappings.
4
+ user-invocable: true
5
+ ---
6
+
1
7
  # Taiwan Logistics Development Skill
2
8
 
3
- **Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow + HCT direct API)**
9
+ **Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow, ezShip + HCT direct API + on-demand delivery)**
4
10
 
5
11
  ---
6
12
 
7
13
  ## Supported Providers
8
14
 
9
- This skill covers **6 logistics aggregators** + **1 direct carrier API**:
15
+ This skill covers **7 logistics aggregators** + **1 direct carrier API** + **3 on-demand delivery services**:
10
16
 
11
17
  | Provider | 類型 | Reference |
12
18
  |---|---|---|
@@ -15,10 +21,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
15
21
  | **PAYUNi 統一** | aggregator | `references/payuni-logistics-api.md` |
16
22
  | **SmilePay 速買配** | aggregator (含 7-11/全家 + 黑貓 Pay_zg 矩陣) | `references/smilepay-logistics-api.md` |
17
23
  | **PChomePay 拍錢包** | aggregator (金物流二合一) | `references/pchomepay-logistics-api.md` |
18
- | **PayNow 立吉富** | aggregator (11 條產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
24
+ | **PayNow 立吉富** | aggregator (Logistic_service 產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
25
+ | **ezShip 台灣便利配** | aggregator (全家/萊爾富/OK、宅配、店港澳;不含 7-11) | `references/ezship-logistics-api.md` |
19
26
  | **HCT 新竹物流** | **直連 carrier API** | `references/hct-logistics-api.md` |
27
+ | **Lalamove** | 即時/同城配送 | `references/lalamove-logistics-api.md` |
28
+ | **pandago / Uber Direct** | 即時/同城配送 | `references/ondemand-delivery.md` |
20
29
 
21
- > 註:選用 `HCT 直連 API` 適合大量出貨企業;一般電商透過 aggregator (`LogisticsType=HCT`) 走 HCT 配送即可,不需自行串接。
30
+ 黑貓、宅配通、中華郵政、超商賣家平台等沒有對外商家 API,替代路徑見 `references/carrier-direct-access.md`。
31
+ 各家實際參數值(子類型、溫層、代收上限)見 `data/logistics-types.csv`。
32
+
33
+ > 註:本 skill 收錄的聚合商(ECPay、NewebPay、PAYUNi、SmilePay、PChomePay、PayNow、ezShip)官方規格都沒有新竹物流選項,要用 HCT 只能直連(需向 HCT 申請)。
22
34
 
23
35
  ---
24
36
 
@@ -85,9 +97,9 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
85
97
  **API Style**: Form POST with URL-encoded parameters
86
98
 
87
99
  **Supported Services:**
88
- - C2C Store-to-Store: 4 convenience stores (7-11, FamilyMart, Hi-Life, OK Mart)
89
- - C2C Frozen: 7-ELEVEN frozen goods
90
- - Home Delivery: T-Cat, HCT, Pelican Express
100
+ - B2C 超商取貨:7-11(常溫/冷凍)、全家、萊爾富
101
+ - C2C 店到店:7-11 交貨便、全家、萊爾富、OK
102
+ - 宅配:黑貓(常溫/冷藏/冷凍)、中華郵政(僅常溫)
91
103
 
92
104
  **Test Environment:**
93
105
  - Base URL: `https://logistics-stage.ecpay.com.tw`
@@ -99,19 +111,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
99
111
  **Production Environment:**
100
112
  - Base URL: `https://logistics.ecpay.com.tw`
101
113
 
102
- **Logistics SubTypes (CVS):**
103
- - `FAMI` - FamilyMart (全家)
104
- - `UNIMART` - 7-ELEVEN (常溫)
105
- - `UNIMARTFREEZE` - 7-ELEVEN (冷凍)
106
- - `HILIFE` - Hi-Life (萊爾富)
107
- - `OKMART` - OK Mart
114
+ **Logistics SubTypes (`LogisticsType=CVS`):**
115
+ - B2C:`FAMI` 全家、`UNIMART` 7-11、`UNIMARTFREEZE` 7-11 冷凍店取、`HILIFE` 萊爾富
116
+ - C2C:`FAMIC2C` 全家、`UNIMARTC2C` 7-11 交貨便、`HILIFEC2C` 萊爾富、`OKMARTC2C` OK
117
+ - B2C 合約只能用 B2C 代碼,C2C 合約只能用 C2C 代碼;OK 只有 C2C
108
118
 
109
- **Logistics SubTypes (Home Delivery):**
110
- - `TCAT` - T-Cat (黑貓宅急便)
111
- - `ECAN` - HCT (新竹物流)
112
- - `POST` - Pelican Express (宅配通)
119
+ **Logistics SubTypes (`LogisticsType=HOME`):**
120
+ - `TCAT` - 黑貓宅急便(代收貨款時商品金額上限 20,000)
121
+ - `POST` - 中華郵政(`Temperature` 只能 `0001`,不可代收)
113
122
 
114
- **Temperature Control (Home Delivery):**
123
+ **Temperature Control (Home Delivery, TCAT):**
115
124
  - `0001` - Normal temperature (常溫)
116
125
  - `0002` - Refrigerated (冷藏)
117
126
  - `0003` - Frozen (冷凍)
@@ -129,9 +138,8 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
129
138
  - `03` - Outlying islands
130
139
 
131
140
  **Test Credentials:**
132
- - MerchantID: `2000132`
133
- - HashKey: `5294y06JbISpM5x9`
134
- - HashIV: `v77hoKGq4kWxNNIS`
141
+ - B2C 及宅配:MerchantID `2000132`、HashKey `5294y06JbISpM5x9`、HashIV `v77hoKGq4kWxNNIS`
142
+ - C2C:MerchantID `2000933`、HashKey `XBERn1YOvpM9nfZc`、HashIV `h1ONHk4P4yqbl5LK`
135
143
 
136
144
  ---
137
145
 
@@ -140,31 +148,26 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
140
148
  **Encryption**: AES-256-GCM + SHA256 (same as PAYUNi payment):
141
149
  `EncryptInfo = hex(base64(ciphertext) + ":::" + base64(tag))`, `HashInfo = SHA256(HashKey + EncryptInfo + HashIV)`
142
150
 
143
- **API Style**: form POST (`MerID`, `Version`, `EncryptInfo`, `HashInfo`), JSON response with an encrypted `EncryptInfo`
151
+ **API Style**: form POST (`MerID`, `Version`, `EncryptInfo`, `HashInfo`), JSON response with an encrypted `EncryptInfo`.
152
+ Source: official docs docs.payuni.com.tw/web/#/7; details in `references/payuni-logistics-api.md`.
144
153
 
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)
154
+ **Supported Services:** 7-ELEVEN B2C bulk / C2C store-to-store / C2B return (normal + frozen); T-Cat home delivery (normal, frozen, refrigerated)
153
155
 
154
156
  **Endpoints** (base `https://sandbox-api.payuni.com.tw/api` / `https://api.payuni.com.tw/api`):
155
157
 
156
158
  | Purpose | Path | Version |
157
159
  |---|---|---|
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 |
160
+ | Store map (browser form) | `/logistics/ship_map` | 1.1 |
161
161
  | Query shipment | `/logistics/query` | 1.1 |
162
162
  | Print 7-11 label (browser form) | `/logistics/print_label` | 1.0 |
163
+ | T-Cat label PDF (browser form) | `/home_delivery/get_obt_number_pdf` | 1.0 |
164
+ | T-Cat label re-download | `/home_delivery/download_pdf` | 1.0 |
163
165
 
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)
166
+ Shipments are created inside a payment request: UPP with `ShipTag=1` (+ `Ship=1` for COD), or the backend
167
+ ATM / CVS / credit-token / LINE Pay / JKoPay / AFTEE APIs with `ServiceType=3` (no COD).
166
168
 
167
- > Strings like `PAYUNi_Logistic_711` are WooCommerce shipping-method IDs of the official plugin, **not** API values.
169
+ **Codes:** `ShipType` 1=7-ELEVEN 2=T-Cat · `LgsType` B2C / C2C / HOME / C2B · `GoodsType` 1=normal 2=frozen 3=refrigerated ·
170
+ `DeliveryTimeTag` 01 / 02 / 04(not set)
168
171
 
169
172
  ---
170
173
 
@@ -612,46 +615,45 @@ the status push (NPA-B58) uses the underscored names.
612
615
  All requests: form POST `MerID`, `Version`, `EncryptInfo`, `HashInfo`. Verify `HashInfo` on every
613
616
  response and notification before decrypting.
614
617
 
615
- ### 1. Create shipment
616
-
617
- `POST /api/logistics/trade` (7-11) or `POST /api/home_delivery/trade` (T-Cat), Version `1.1`.
618
+ ### 1. Create shipment (inside the payment request)
618
619
 
619
- | EncryptInfo field | 7-11 | T-Cat | Notes |
620
+ | EncryptInfo field | UPP | Backend API | Notes |
620
621
  |---|:-:|:-:|---|
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`.
622
+ | ShipTag | 1 | | enable logistics |
623
+ | Ship | 1 = COD | | |
624
+ | ServiceType | | 3 | backend APIs support no-COD only |
625
+ | LgsType / ShipType / GoodsType | ● | ● | |
626
+ | Consignee / ConsigneeMobile | ● | ● | real name, 09xxxxxxxx |
627
+ | StoreID | | ● (7-11) | from the store map |
628
+ | ConsigneeAddress / DeliveryTimeTag | ○ | ● (T-Cat) | |
633
629
 
634
- ### 2. Query shipment
635
-
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).
630
+ The payment response includes **`ShipTradeNo`** (used for query / print / notifications).
639
631
 
640
- **ShipStatus codes** (plugin `Utils/ShippingStatus.php`):
632
+ ### 2. Query shipment
641
633
 
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 |
634
+ `POST /api/logistics/query`, Version `1.1`, EncryptInfo: `MerID`, `Timestamp`, `LgsType`, and `ShipTradeNo`
635
+ or `ReturnOdno` (C2B). Response: `Odno`, `PartnerId`, `ValidationNo` (C2C), `FileNo` (T-Cat), `ShipStatus`,
636
+ `ShipStatusDesc`, `ShipStatusTime`, `PickupStoreType` (status 81).
637
+
638
+ **ShipStatus codes** (official page 120):
639
+
640
+ | Code | Meaning | Code | Meaning |
641
+ |---|---|---|---|
642
+ | 91 | Not processed | 11 | Picked up |
643
+ | 92 | Processing (CVS) | 41 | Cancelled |
644
+ | 98 | Processing, received (B2C) | 43 | Compensation |
645
+ | 21 | Waiting for shipment | 44 | Lost |
646
+ | 22 | Logistics-center check-in (CVS) | 46 | Discarded (C2C) |
647
+ | 31 | In delivery | 51 | Return |
648
+ | 32 | At pickup store (CVS) | 52 | Not collected by buyer |
649
+ | 33 | Exception | 53 | Returned to warehouse (CVS) |
650
+ | 81 | Store closed, reselect | 55 | Not collected by seller (C2C) |
651
+ | 82 | Awaiting home-delivery return (C2C) | 56 | Returned by home delivery (C2C) |
650
652
 
651
653
  ### 3. Notifications
652
654
 
653
- PAYUNi POSTs `EncryptInfo` (+ `HashInfo`) to `NotifyURL`. Decrypted `ApiType` is `ShipStatus`
654
- (status update: `ShipTradeNo`, `ShipStatus`, `ShipStatusDesc`, `ShipStatusTime`; T-Cat adds `OBTNumber`, `FileNo`)
655
+ The notify URL is set in the PAYUNi back office (logistics settings). Decrypted `ApiType` is `ShipStatus`
656
+ (`ShipTradeNo`, `ShipStatus`, `ShipStatusDesc`, `ShipStatusTime`; T-Cat adds `OBTNumber`, `FileNo`)
655
657
  or `Print` (label result). Match orders by `ShipTradeNo`.
656
658
 
657
659
  ---
@@ -707,13 +709,3 @@ or `Print` (label result). Match orders by `ShipTradeNo`.
707
709
  ### NewebPay Technical Support
708
710
  - Phone: 02-2655-8938
709
711
  - 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,31 +1,55 @@
1
1
  logistics_type,logistics_sub_type,name_zh,provider,type,collection_available,max_amount,size_limit,temperature,notes
2
- CVS,UNIMART,7-11 B2C,7-11,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
3
- CVS,UNIMARTC2C,7-11 店到店,7-11,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 交貨便
4
- CVS,FAMI,全家 B2C,全家,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
5
- CVS,FAMIC2C,全家店到店,全家,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
6
- CVS,HILIFE,萊爾富 B2C,萊爾富,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
7
- CVS,HILIFEC2C,萊爾富店到店,萊爾富,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
8
- CVS,OKMART,OK B2C,OK,cvs_b2c,true,20000,45x30x30cm,常溫,大宗寄倉
9
- CVS,OKMARTC2C,OK 店到店,OK,cvs_c2c,true,20000,45x30x30cm,常溫,C2C 店到店
10
- Home,TCAT,黑貓宅急便,黑貓,home,false,200000,150cm,常溫/冷藏/冷凍,宅配到府
11
- Home,ECAN,宅配通,宅配通,home,false,100000,120cm,常溫,常溫宅配
12
- CVS,UNIMART_NWP,7-11 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新7-11取貨
13
- CVS,UNIMARTC2C_NWP,7-11 店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新7-11 C2C
14
- CVS,FAMI_NWP,全家 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新全家取貨
15
- CVS,FAMIC2C_NWP,全家店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新全家 C2C
16
- CVS,HILIFE_NWP,萊爾富 B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新萊爾富取貨
17
- CVS,HILIFEC2C_NWP,萊爾富店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新萊爾富 C2C
18
- CVS,OKMART_NWP,OK B2C (NewebPay),newebpay,cvs_b2c,true,20000,45x30x30cm,常溫,藍新OK取貨
19
- CVS,OKMARTC2C_NWP,OK 店到店 (NewebPay),newebpay,cvs_c2c,true,6000,45x30x30cm,常溫,藍新OK C2C
20
- CVS,UNIMART_PAY,7-11 C2C 常溫 (PAYUNi),payuni,cvs_c2c,false,6000,45x30x30cm,常溫,統一7-11常溫
21
- CVS,UNIMART_FREEZE,7-11 C2C 冷凍 (PAYUNi),payuni,cvs_c2c,false,6000,45x30x30cm,冷凍,統一7-11冷凍
22
- CVS,UNIMART_B2C_PAY,7-11 B2C (PAYUNi),payuni,cvs_b2c,true,20000,45x30x30cm,常溫,統一7-11 B2C
23
- Home,TCAT_PAY,黑貓常溫 (PAYUNi),payuni,home,true,50000,150x150x150cm,常溫,統一T-Cat常溫
24
- Home,TCAT_FREEZE,黑貓冷凍 (PAYUNi),payuni,home,true,50000,100x100x100cm,冷凍,統一T-Cat冷凍
25
- Home,TCAT_COLD,黑貓冷藏 (PAYUNi),payuni,home,true,50000,100x100x100cm,冷藏,統一T-Cat冷藏
26
- CVS,EZSHIP_OK,OK 店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
27
- CVS,EZSHIP_HILIFE,萊爾富店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
28
- CVS,EZSHIP_FAMI,全家店到店 (ezShip),ezship,cvs_c2c,true,20000,45x30x30cm,常溫,ezShip 不含 7-11
29
- Ondemand,LALAMOVE,Lalamove 即時配送,lalamove,ondemand,false,依方案,依車型,常溫,先報價後下單;報價效期5分鐘;同城/當日;可換司機;非批次物流
30
- Ondemand,PANDAGO,pandago 即時配送,pandago,ondemand,false,依報價,34x34x36cm/20kg,常溫,費用與時間為兩支獨立端點;Sandbox僅新加坡;不需成為foodpanda餐廳夥伴
31
- Ondemand,UBER_DIRECT,Uber Direct 即時配送,uber_direct,ondemand,false,依報價,依方案,常溫,配送半徑約10英里;可預約最多30天;台灣可用性未經官方確認
2
+ CVS,LogisticsSubType=UNIMART,7-11 超商取貨(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
3
+ CVS,LogisticsSubType=UNIMARTFREEZE,7-11 冷凍店取(B2C),ecpay,cvs_b2c,true,20000,,冷凍,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
4
+ CVS,LogisticsSubType=FAMI,全家(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
5
+ CVS,LogisticsSubType=HILIFE,萊爾富(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
6
+ CVS,LogisticsSubType=UNIMARTC2C,7-11 交貨便(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
7
+ CVS,LogisticsSubType=FAMIC2C,全家店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
8
+ CVS,LogisticsSubType=HILIFEC2C,萊爾富店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
9
+ CVS,LogisticsSubType=OKMARTC2C,OK 店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收;OK 只有 C2C,沒有 OKMART
10
+ HOME,LogisticsSubType=TCAT,黑貓宅急便,ecpay,home,true,20000,,常溫/冷藏/冷凍,LogisticsType=HOME;Temperature 0001/0002/0003;代收時商品金額上限 20000
11
+ HOME,LogisticsSubType=POST,中華郵政,ecpay,home,false,,,常溫,LogisticsType=HOME;Temperature 只能 0001;不可代收
12
+ CVS,LgsType=B2C ShipType=1,7-11 大宗寄倉(B2C),newebpay,cvs_b2c,true,20000,,常溫,B2C 只有 7-11;TradeType 1 取貨付款/3 取貨不付款
13
+ CVS,LgsType=C2C ShipType=1,7-11 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
14
+ CVS,LgsType=C2C ShipType=2,全家 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
15
+ CVS,LgsType=C2C ShipType=3,萊爾富 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
16
+ CVS,LgsType=C2C ShipType=4,OK 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
17
+ CVS,LgsType=B2C ShipType=1 GoodsType=1,7-11 大宗寄倉(常溫),payuni,cvs_b2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
18
+ CVS,LgsType=B2C ShipType=1 GoodsType=2,7-11 大宗寄倉(冷凍),payuni,cvs_b2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
19
+ CVS,LgsType=C2C ShipType=1 GoodsType=1,7-11 店到店(常溫),payuni,cvs_c2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
20
+ CVS,LgsType=C2C ShipType=1 GoodsType=2,7-11 店到店(冷凍),payuni,cvs_c2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
21
+ HOME,LgsType=HOME ShipType=2 GoodsType=1/2/3,黑貓宅配,payuni,home,,,,常溫/冷凍/冷藏,GoodsType 1 常溫/2 冷凍/3 冷藏;ConsigneeAddress、DeliveryTimeTag 必填
22
+ CVS,Pay_zg=55/56 Pay_subzg=7NET,7-11 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
23
+ CVS,Pay_zg=55/56 Pay_subzg=FAMI,全家 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
24
+ CVS,Pay_zg=51/52 Pay_subzg=7NET,7-11 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
25
+ CVS,Pay_zg=51/52 Pay_subzg=FAMI,全家 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
26
+ HOME,Pay_zg=81/82 Pay_subzg=TCAT,黑貓宅配,smilepay,home,true,,,常溫/冷藏/冷凍,81 取貨付款/82 純取貨;溫層由 ezcatGetTrackNum.asp 的 temperature 0001/0002/0003 決定
27
+ HOME,Pay_zg=83 Pay_subzg=TCAT,黑貓逆物流(退貨),smilepay,return,false,,,常溫,退貨用
28
+ CVS,pay_type=IPL7,7-11 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
29
+ CVS,pay_type=IPLFM,全家 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
30
+ CVS,pay_type=IPLHL,萊爾富 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
31
+ CVS,Logistic_service=01,7-11 交貨便,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
32
+ CVS,Logistic_service=02,7-11 大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
33
+ CVS,Logistic_service=03,全家店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
34
+ CVS,Logistic_service=04,全家大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
35
+ CVS,Logistic_service=05,萊爾富店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
36
+ CVS,Logistic_service=10,OK 店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
37
+ CVS,Logistic_service=21,7-11 交貨便(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款;電子地圖用 Logistic_serviceID=22,建單固定 21
38
+ CVS,Logistic_service=22,7-11 大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
39
+ CVS,Logistic_service=23,全家店到店(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
40
+ CVS,Logistic_service=24,全家大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
41
+ HOME,Logistic_service=06,黑貓宅急便,paynow,home,true,100000,,常溫/冷藏/冷凍,DeliveryType 0001/0002/0003;長寬高合計 ≤ 150 cm
42
+ HOME,Logistic_service=36,黑貓宅急便(自動保險),paynow,home,false,100000,,常溫/冷藏/冷凍,保險單 DeliverMode 須為 02;總金額超過 20000 自動投保
43
+ CVS,Logistic_service=46,黑貓到店,paynow,cvs_c2c,true,20000,,常溫/冷藏/冷凍,取件門市;長寬高合計 ≤ 105 cm
44
+ CROSS_BORDER,Logistic_service=07,7-11 海外店配,paynow,cross_border,,,,常溫,需帶 Country
45
+ CROSS_BORDER,Logistic_service=08,7-11 海外宅配,paynow,cross_border,,,,常溫,需帶 Country
46
+ CVS,Logistic_service=12,7-11 大宗退貨便,paynow,return,false,,,常溫,退貨用
47
+ CVS,stCate=TFM,全家 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
48
+ CVS,stCate=TLF,萊爾富 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
49
+ CVS,stCate=TOK,OK 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
50
+ HOME,order_status=A05/A06,ezShip 宅配,ezship,home,true,8000,,常溫,order_type 1 取貨付款(代收 10–8000);rv_addr、rv_zip 必填
51
+ CROSS_BORDER,stCate=TSF,店港澳,ezship,cross_border,false,,,常溫,order_status A11/A12;無代收
52
+ HOME,eprdcl2=001/003/008,新竹物流(直連),hct_direct,home,true,,,常溫/冷凍/冷藏,eprdcl2 001 一般/003 冷凍/008 冷藏;eqmny 代收貨款
53
+ ONDEMAND,LALAMOVE,Lalamove 即時配送,lalamove,ondemand,false,依方案,依車型,常溫,先報價後下單;報價效期5分鐘;同城/當日;可換司機;非批次物流
54
+ ONDEMAND,PANDAGO,pandago 即時配送,pandago,ondemand,false,依報價,34x34x36cm/20kg,常溫,費用與時間為兩支獨立端點;Sandbox僅新加坡;不需成為foodpanda餐廳夥伴
55
+ ONDEMAND,UBER_DIRECT,Uber Direct 即時配送,uber_direct,ondemand,false,依報價,依方案,常溫,配送半徑約10英里;可預約最多30天;台灣可用性未經官方確認
@@ -1,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)