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.
- package/README.md +39 -28
- package/assets/taiwan-logistics/CLAUDE.md +18 -17
- package/assets/taiwan-logistics/EXAMPLES.md +43 -66
- package/assets/taiwan-logistics/README.md +40 -29
- package/assets/taiwan-logistics/SKILL.md +70 -78
- package/assets/taiwan-logistics/data/logistics-types.csv +54 -30
- 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 +6 -6
- package/assets/taiwan-logistics/examples/ezship-logistics-example.py +52 -30
- package/assets/taiwan-logistics/examples/hct-logistics-example.py +6 -9
- 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/examples/store-map-integration-example.html +3 -3
- package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +1 -7
- package/assets/taiwan-logistics/references/carrier-direct-access.md +2 -3
- package/assets/taiwan-logistics/references/ecpay-logistics-api.md +18 -17
- package/assets/taiwan-logistics/references/ezship-logistics-api.md +20 -10
- package/assets/taiwan-logistics/references/hct-logistics-api.md +1 -4
- 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 +2 -5
- 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 +3 -4
- package/assets/taiwan-logistics/scripts/generate-logistics-service.py +70 -1231
- package/assets/taiwan-logistics/scripts/test_logistics.py +108 -262
- package/assets/templates/base/quick-reference.md +41 -33
- package/assets/templates/base/skill-content.md +64 -78
- package/assets/templates/platforms/agent.json +2 -2
- package/assets/templates/platforms/claude.json +2 -2
- package/assets/templates/platforms/cline.json +3 -3
- package/assets/templates/platforms/codebuddy.json +2 -2
- package/assets/templates/platforms/codex.json +2 -2
- package/assets/templates/platforms/continue.json +2 -2
- package/assets/templates/platforms/copilot.json +3 -3
- package/assets/templates/platforms/cursor.json +2 -2
- package/assets/templates/platforms/gemini.json +2 -2
- package/assets/templates/platforms/kiro.json +3 -3
- package/assets/templates/platforms/opencode.json +2 -2
- package/assets/templates/platforms/qoder.json +2 -2
- package/assets/templates/platforms/trae.json +2 -2
- package/assets/templates/platforms/windsurf.json +2 -2
- package/dist/index.js +20 -13
- package/package.json +2 -2
|
@@ -1,12 +1,18 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: taiwan-logistics
|
|
3
|
+
description: Taiwan Logistics API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow and ezShip aggregators, HCT direct carrier API, and on-demand delivery (Lalamove, pandago, Uber Direct). Use when developing shipping flows, implementing CVS pickup (7-11/全家/萊爾富/OK), home delivery (黑貓/中華郵政), cold-chain, store-map selectors, COD orders, or shipment tracking. Handles encryption (MD5, AES-256-CBC, AES-256-GCM, 3DES), store maps, and provider field mappings.
|
|
4
|
+
user-invocable: true
|
|
5
|
+
---
|
|
6
|
+
|
|
1
7
|
# Taiwan Logistics Development Skill
|
|
2
8
|
|
|
3
|
-
**Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow + HCT direct API)**
|
|
9
|
+
**Comprehensive guide for Taiwan Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow, ezShip + HCT direct API + on-demand delivery)**
|
|
4
10
|
|
|
5
11
|
---
|
|
6
12
|
|
|
7
13
|
## Supported Providers
|
|
8
14
|
|
|
9
|
-
This skill covers **
|
|
15
|
+
This skill covers **7 logistics aggregators** + **1 direct carrier API** + **3 on-demand delivery services**:
|
|
10
16
|
|
|
11
17
|
| Provider | 類型 | Reference |
|
|
12
18
|
|---|---|---|
|
|
@@ -15,10 +21,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
|
15
21
|
| **PAYUNi 統一** | aggregator | `references/payuni-logistics-api.md` |
|
|
16
22
|
| **SmilePay 速買配** | aggregator (含 7-11/全家 + 黑貓 Pay_zg 矩陣) | `references/smilepay-logistics-api.md` |
|
|
17
23
|
| **PChomePay 拍錢包** | aggregator (金物流二合一) | `references/pchomepay-logistics-api.md` |
|
|
18
|
-
| **PayNow 立吉富** | aggregator (
|
|
24
|
+
| **PayNow 立吉富** | aggregator (Logistic_service 產品線, 3DES/ECB/Zero-Padding) | `references/paynow-logistics-api.md` |
|
|
25
|
+
| **ezShip 台灣便利配** | aggregator (全家/萊爾富/OK、宅配、店港澳;不含 7-11) | `references/ezship-logistics-api.md` |
|
|
19
26
|
| **HCT 新竹物流** | **直連 carrier API** | `references/hct-logistics-api.md` |
|
|
27
|
+
| **Lalamove** | 即時/同城配送 | `references/lalamove-logistics-api.md` |
|
|
28
|
+
| **pandago / Uber Direct** | 即時/同城配送 | `references/ondemand-delivery.md` |
|
|
20
29
|
|
|
21
|
-
|
|
30
|
+
黑貓、宅配通、中華郵政、超商賣家平台等沒有對外商家 API,替代路徑見 `references/carrier-direct-access.md`。
|
|
31
|
+
各家實際參數值(子類型、溫層、代收上限)見 `data/logistics-types.csv`。
|
|
32
|
+
|
|
33
|
+
> 註:本 skill 收錄的聚合商(ECPay、NewebPay、PAYUNi、SmilePay、PChomePay、PayNow、ezShip)官方規格都沒有新竹物流選項,要用 HCT 只能直連(需向 HCT 申請)。
|
|
22
34
|
|
|
23
35
|
---
|
|
24
36
|
|
|
@@ -85,9 +97,9 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
|
85
97
|
**API Style**: Form POST with URL-encoded parameters
|
|
86
98
|
|
|
87
99
|
**Supported Services:**
|
|
88
|
-
-
|
|
89
|
-
- C2C
|
|
90
|
-
-
|
|
100
|
+
- B2C 超商取貨:7-11(常溫/冷凍)、全家、萊爾富
|
|
101
|
+
- C2C 店到店:7-11 交貨便、全家、萊爾富、OK
|
|
102
|
+
- 宅配:黑貓(常溫/冷藏/冷凍)、中華郵政(僅常溫)
|
|
91
103
|
|
|
92
104
|
**Test Environment:**
|
|
93
105
|
- Base URL: `https://logistics-stage.ecpay.com.tw`
|
|
@@ -99,19 +111,16 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
|
99
111
|
**Production Environment:**
|
|
100
112
|
- Base URL: `https://logistics.ecpay.com.tw`
|
|
101
113
|
|
|
102
|
-
**Logistics SubTypes (CVS):**
|
|
103
|
-
-
|
|
104
|
-
- `
|
|
105
|
-
-
|
|
106
|
-
- `HILIFE` - Hi-Life (萊爾富)
|
|
107
|
-
- `OKMART` - OK Mart
|
|
114
|
+
**Logistics SubTypes (`LogisticsType=CVS`):**
|
|
115
|
+
- B2C:`FAMI` 全家、`UNIMART` 7-11、`UNIMARTFREEZE` 7-11 冷凍店取、`HILIFE` 萊爾富
|
|
116
|
+
- C2C:`FAMIC2C` 全家、`UNIMARTC2C` 7-11 交貨便、`HILIFEC2C` 萊爾富、`OKMARTC2C` OK
|
|
117
|
+
- B2C 合約只能用 B2C 代碼,C2C 合約只能用 C2C 代碼;OK 只有 C2C
|
|
108
118
|
|
|
109
|
-
**Logistics SubTypes (
|
|
110
|
-
- `TCAT` -
|
|
111
|
-
- `
|
|
112
|
-
- `POST` - Pelican Express (宅配通)
|
|
119
|
+
**Logistics SubTypes (`LogisticsType=HOME`):**
|
|
120
|
+
- `TCAT` - 黑貓宅急便(代收貨款時商品金額上限 20,000)
|
|
121
|
+
- `POST` - 中華郵政(`Temperature` 只能 `0001`,不可代收)
|
|
113
122
|
|
|
114
|
-
**Temperature Control (Home Delivery):**
|
|
123
|
+
**Temperature Control (Home Delivery, TCAT):**
|
|
115
124
|
- `0001` - Normal temperature (常溫)
|
|
116
125
|
- `0002` - Refrigerated (冷藏)
|
|
117
126
|
- `0003` - Frozen (冷凍)
|
|
@@ -129,9 +138,8 @@ This skill covers **6 logistics aggregators** + **1 direct carrier API**:
|
|
|
129
138
|
- `03` - Outlying islands
|
|
130
139
|
|
|
131
140
|
**Test Credentials:**
|
|
132
|
-
- MerchantID
|
|
133
|
-
- HashKey
|
|
134
|
-
- HashIV: `v77hoKGq4kWxNNIS`
|
|
141
|
+
- B2C 及宅配:MerchantID `2000132`、HashKey `5294y06JbISpM5x9`、HashIV `v77hoKGq4kWxNNIS`
|
|
142
|
+
- C2C:MerchantID `2000933`、HashKey `XBERn1YOvpM9nfZc`、HashIV `h1ONHk4P4yqbl5LK`
|
|
135
143
|
|
|
136
144
|
---
|
|
137
145
|
|
|
@@ -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
|
-
|
|
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
|
-
|
|
|
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
|
-
|
|
165
|
-
|
|
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
|
-
|
|
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 |
|
|
620
|
+
| EncryptInfo field | UPP | Backend API | Notes |
|
|
620
621
|
|---|:-:|:-:|---|
|
|
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`.
|
|
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
|
-
|
|
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
|
-
|
|
632
|
+
### 2. Query shipment
|
|
641
633
|
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
|
649
|
-
|
|
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
|
|
654
|
-
(
|
|
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,
|
|
3
|
-
CVS,
|
|
4
|
-
CVS,FAMI
|
|
5
|
-
CVS,
|
|
6
|
-
CVS,
|
|
7
|
-
CVS,
|
|
8
|
-
CVS,
|
|
9
|
-
CVS,OKMARTC2C,OK
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
CVS,
|
|
13
|
-
CVS,
|
|
14
|
-
CVS,
|
|
15
|
-
CVS,
|
|
16
|
-
CVS,
|
|
17
|
-
CVS,
|
|
18
|
-
CVS,
|
|
19
|
-
CVS,
|
|
20
|
-
CVS,
|
|
21
|
-
|
|
22
|
-
CVS,
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
CVS,
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
2
|
+
CVS,LogisticsSubType=UNIMART,7-11 超商取貨(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
3
|
+
CVS,LogisticsSubType=UNIMARTFREEZE,7-11 冷凍店取(B2C),ecpay,cvs_b2c,true,20000,,冷凍,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
4
|
+
CVS,LogisticsSubType=FAMI,全家(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
5
|
+
CVS,LogisticsSubType=HILIFE,萊爾富(B2C),ecpay,cvs_b2c,true,20000,,常溫,B2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
6
|
+
CVS,LogisticsSubType=UNIMARTC2C,7-11 交貨便(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
7
|
+
CVS,LogisticsSubType=FAMIC2C,全家店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
8
|
+
CVS,LogisticsSubType=HILIFEC2C,萊爾富店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收
|
|
9
|
+
CVS,LogisticsSubType=OKMARTC2C,OK 店到店(C2C),ecpay,cvs_c2c,true,20000,,常溫,C2C 合約才能用;GoodsAmount 1–20000;IsCollection=Y 代收;OK 只有 C2C,沒有 OKMART
|
|
10
|
+
HOME,LogisticsSubType=TCAT,黑貓宅急便,ecpay,home,true,20000,,常溫/冷藏/冷凍,LogisticsType=HOME;Temperature 0001/0002/0003;代收時商品金額上限 20000
|
|
11
|
+
HOME,LogisticsSubType=POST,中華郵政,ecpay,home,false,,,常溫,LogisticsType=HOME;Temperature 只能 0001;不可代收
|
|
12
|
+
CVS,LgsType=B2C ShipType=1,7-11 大宗寄倉(B2C),newebpay,cvs_b2c,true,20000,,常溫,B2C 只有 7-11;TradeType 1 取貨付款/3 取貨不付款
|
|
13
|
+
CVS,LgsType=C2C ShipType=1,7-11 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
|
|
14
|
+
CVS,LgsType=C2C ShipType=2,全家 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
|
|
15
|
+
CVS,LgsType=C2C ShipType=3,萊爾富 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
|
|
16
|
+
CVS,LgsType=C2C ShipType=4,OK 店到店(C2C),newebpay,cvs_c2c,true,20000,,常溫,TradeType 1 取貨付款/3 取貨不付款;藍新物流無宅配
|
|
17
|
+
CVS,LgsType=B2C ShipType=1 GoodsType=1,7-11 大宗寄倉(常溫),payuni,cvs_b2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
|
|
18
|
+
CVS,LgsType=B2C ShipType=1 GoodsType=2,7-11 大宗寄倉(冷凍),payuni,cvs_b2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
|
|
19
|
+
CVS,LgsType=C2C ShipType=1 GoodsType=1,7-11 店到店(常溫),payuni,cvs_c2c,true,,,常溫,Ship=1 取貨付款、ShipTag=1 啟用物流
|
|
20
|
+
CVS,LgsType=C2C ShipType=1 GoodsType=2,7-11 店到店(冷凍),payuni,cvs_c2c,true,,,冷凍,Ship=1 取貨付款、ShipTag=1 啟用物流;冷凍門市地圖 MapType 固定 2
|
|
21
|
+
HOME,LgsType=HOME ShipType=2 GoodsType=1/2/3,黑貓宅配,payuni,home,,,,常溫/冷凍/冷藏,GoodsType 1 常溫/2 冷凍/3 冷藏;ConsigneeAddress、DeliveryTimeTag 必填
|
|
22
|
+
CVS,Pay_zg=55/56 Pay_subzg=7NET,7-11 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
|
|
23
|
+
CVS,Pay_zg=55/56 Pay_subzg=FAMI,全家 大宗寄倉(B2C),smilepay,cvs_b2c,true,,,常溫,55 取貨付款/56 純取貨
|
|
24
|
+
CVS,Pay_zg=51/52 Pay_subzg=7NET,7-11 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
|
|
25
|
+
CVS,Pay_zg=51/52 Pay_subzg=FAMI,全家 店到店(C2C),smilepay,cvs_c2c,true,,,常溫,51 取貨付款/52 純取貨
|
|
26
|
+
HOME,Pay_zg=81/82 Pay_subzg=TCAT,黑貓宅配,smilepay,home,true,,,常溫/冷藏/冷凍,81 取貨付款/82 純取貨;溫層由 ezcatGetTrackNum.asp 的 temperature 0001/0002/0003 決定
|
|
27
|
+
HOME,Pay_zg=83 Pay_subzg=TCAT,黑貓逆物流(退貨),smilepay,return,false,,,常溫,退貨用
|
|
28
|
+
CVS,pay_type=IPL7,7-11 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
|
|
29
|
+
CVS,pay_type=IPLFM,全家 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
|
|
30
|
+
CVS,pay_type=IPLHL,萊爾富 超商取貨付款,pchomepay,cvs_c2c,true,20000,,常溫,金額 65–20000;物流單由金流訂單派生;不提供 OK/宅配
|
|
31
|
+
CVS,Logistic_service=01,7-11 交貨便,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
32
|
+
CVS,Logistic_service=02,7-11 大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
33
|
+
CVS,Logistic_service=03,全家店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
34
|
+
CVS,Logistic_service=04,全家大宗物流,paynow,cvs_b2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
35
|
+
CVS,Logistic_service=05,萊爾富店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
36
|
+
CVS,Logistic_service=10,OK 店到店,paynow,cvs_c2c,true,20000,,常溫,DeliverMode 01 取貨付款/02 取貨不付款
|
|
37
|
+
CVS,Logistic_service=21,7-11 交貨便(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款;電子地圖用 Logistic_serviceID=22,建單固定 21
|
|
38
|
+
CVS,Logistic_service=22,7-11 大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
|
|
39
|
+
CVS,Logistic_service=23,全家店到店(冷凍),paynow,cvs_c2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
|
|
40
|
+
CVS,Logistic_service=24,全家大宗物流(冷凍),paynow,cvs_b2c,true,20000,,冷凍,DeliverMode 01 取貨付款/02 取貨不付款
|
|
41
|
+
HOME,Logistic_service=06,黑貓宅急便,paynow,home,true,100000,,常溫/冷藏/冷凍,DeliveryType 0001/0002/0003;長寬高合計 ≤ 150 cm
|
|
42
|
+
HOME,Logistic_service=36,黑貓宅急便(自動保險),paynow,home,false,100000,,常溫/冷藏/冷凍,保險單 DeliverMode 須為 02;總金額超過 20000 自動投保
|
|
43
|
+
CVS,Logistic_service=46,黑貓到店,paynow,cvs_c2c,true,20000,,常溫/冷藏/冷凍,取件門市;長寬高合計 ≤ 105 cm
|
|
44
|
+
CROSS_BORDER,Logistic_service=07,7-11 海外店配,paynow,cross_border,,,,常溫,需帶 Country
|
|
45
|
+
CROSS_BORDER,Logistic_service=08,7-11 海外宅配,paynow,cross_border,,,,常溫,需帶 Country
|
|
46
|
+
CVS,Logistic_service=12,7-11 大宗退貨便,paynow,return,false,,,常溫,退貨用
|
|
47
|
+
CVS,stCate=TFM,全家 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
|
|
48
|
+
CVS,stCate=TLF,萊爾富 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
|
|
49
|
+
CVS,stCate=TOK,OK 店到店,ezship,cvs_c2c,true,10000,,常溫,order_status A01–A04;order_type 1 取貨付款(代收 10–10000)/3 取貨不付款;不含 7-11
|
|
50
|
+
HOME,order_status=A05/A06,ezShip 宅配,ezship,home,true,8000,,常溫,order_type 1 取貨付款(代收 10–8000);rv_addr、rv_zip 必填
|
|
51
|
+
CROSS_BORDER,stCate=TSF,店港澳,ezship,cross_border,false,,,常溫,order_status A11/A12;無代收
|
|
52
|
+
HOME,eprdcl2=001/003/008,新竹物流(直連),hct_direct,home,true,,,常溫/冷凍/冷藏,eprdcl2 001 一般/003 冷凍/008 冷藏;eqmny 代收貨款
|
|
53
|
+
ONDEMAND,LALAMOVE,Lalamove 即時配送,lalamove,ondemand,false,依方案,依車型,常溫,先報價後下單;報價效期5分鐘;同城/當日;可換司機;非批次物流
|
|
54
|
+
ONDEMAND,PANDAGO,pandago 即時配送,pandago,ondemand,false,依報價,34x34x36cm/20kg,常溫,費用與時間為兩支獨立端點;Sandbox僅新加坡;不需成為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
|
|
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)
|