T-Cat Express
Table of Contents
- Section 1: Use Cases — 3 common scenarios
- Section 2: Features — Account Setup / Shipping Label Generation / COD & Declared Value / Delivery Tracking
- Section 3: FAQ — 9 questions + Notes
- Section 4: Related Features
Section 1: Use Cases
Quick Links: First-Time Account Setup | Cash on Delivery Orders | Checking Delivery Progress
Scenario 1: Connecting your T-Cat account for the first time
Situation: You have signed a contract with T-Cat Express and want future orders to automatically generate shipping labels using your T-Cat account, without filling in forms on the T-Cat website.
How to Do It:
- Prepare the "Contract Customer Code" and "Authorization Code" provided by T-Cat Express (issued by your T-Cat sales representative when signing the contract; for questions, call T-Cat customer service at 412-8888)
- Go to "Platform" → "Shipping Integrations" and click "New"
- For "Provider", select "黑貓宅急便(T-Cat)", then fill in a "Display Name" for easy identification
- Under "Enable Shipping Types", check the temperature zones you need: 黑貓宅急便(T-Cat) (room temperature), 黑貓宅急便(T-Cat)冷鏈 (chilled), 黑貓宅急便(T-Cat)冷凍 (frozen)
- Enter the "Contract Customer Code" and "Authorization Code", then click "Save"
Result: The checked shipping types become available when creating orders. From then on, when orders ship, the system automatically requests tracking numbers from T-Cat and generates shipping labels with this account.
Scenario 2: Customer requests cash on delivery
Situation: A customer wants to pay only when the package arrives, so you need the T-Cat driver to collect payment on delivery.
How to Do It:
- When creating the order, select the T-Cat shipping type with the appropriate temperature zone for "Shipping Type"
- Check "COD" — the system fills in the order total as the "COD Amount"; lower it if you only need partial collection
- Confirm the COD amount does not exceed NT$100,000, then finish creating the order
Result: The shipping label will carry the COD amount, and the T-Cat driver collects payment from the recipient on delivery. If the COD amount exceeds NT$20,000, the system automatically declares the package value so you can claim compensation from T-Cat for loss or damage.
Scenario 3: Customer asks where their package is
Situation: A customer calls asking "Where is my package?" and you need the latest delivery status to respond.
How to Do It:
- Go to "Shipments" → "Shipment List"
- Enter the order number or "Tracking Number" in the search box
- Check the "Status" column for delivery progress
Result: You can respond based on the status — "In Transit" means the package is on its way, "Received" means the customer has it; if it shows "Problem" (e.g., unknown address, refused), contact T-Cat customer service at 412-8888 for details.
Section 2: Features
The T-Cat Express integration connects your own T-Cat contract account to the system: when orders ship, tracking numbers are requested and shipping labels are generated automatically, and delivery statuses update automatically in the shipment list. You never need to fill in forms on the T-Cat website, and you can monitor every package's delivery progress in real time with fewer manual errors.
Quick Links: Account Setup | Automatic Label Generation | COD & Declared Value | Delivery Tracking
2.1 Setting Up Your T-Cat Account
Go to "Platform" → "Shipping Integrations", click "New", select "黑貓宅急便(T-Cat)" as the "Provider", then fill in:
Fields marked with * are required
| Field | How to Fill | Notes |
|---|---|---|
| *Provider | Select "黑貓宅急便(T-Cat)" | Cannot be changed after creation |
| *Display Name | A custom name for easy identification, e.g., "T-Cat Room Temp" | Max 100 characters |
| Enable Shipping Types | Check the temperature zones this account supports | Only checked shipping types become selectable on orders |
| Weight Threshold | Set the minimum package weight for this account | Leave empty for no threshold; with multiple accounts for the same carrier, the system picks the account by package weight |
| *Contract Customer Code | Enter the contract customer code provided by T-Cat | See your T-Cat contract |
| *Authorization Code | Enter the authorization code provided by T-Cat | See your T-Cat contract |
| Default Product Name | The product name to print on shipping labels, e.g., "Clothing & Accessories" | If empty, the label uses the first product name on the fulfillment |
| Accept Credit Card | When enabled, recipients can pay COD by credit card | Confirm with T-Cat that your contract supports card payment |
▸ Temperature Zone Follows the Shipping Type
| Shipping Type | Temperature Zone |
|---|---|
| 黑貓宅急便(T-Cat) | Room temperature |
| 黑貓宅急便(T-Cat)冷鏈 | Chilled |
| 黑貓宅急便(T-Cat)冷凍 | Frozen |
📌 Note: The temperature zone is not a separate field chosen at shipping time — it follows the order's "Shipping Type". This way the temperature zone is fixed when the order is created, so the warehouse never has to judge it manually, preventing room-temperature packages from being shipped frozen (or vice versa) and causing wasted freight or spoiled goods.
2.2 Automatic Label Generation
Once the account is set up, shipping labels are generated automatically during the shipping process — no manual steps needed:
- When creating the order, select the T-Cat shipping type with the appropriate temperature zone for "Shipping Type"
- When the warehouse finishes picking, packing, and shipping, the system automatically requests a tracking number from T-Cat and generates the label
- Go to "Shipments" → "Shipment List" to check the "Tracking Number" and "Label Status" — "Generated" means the label was created successfully
Label information is filled in automatically:
| Label Information | Source |
|---|---|
| Recipient name, phone, address | The order's recipient details |
| Sender information | Automatically derived from your merchant profile or the shipping warehouse; contact your warehouse to adjust |
| Product name | The account's "Default Product Name"; if not set, the first product name on the fulfillment |
| Delivery Time | The order's "Delivery Time" — "Morning" maps to before 13:00, "Afternoon" maps to 14:00–18:00; unspecified if left empty |
| Delivery Date | The order's "Delivery Date"; automatically moved to the next available day if it falls on a Sunday or holiday |
📌 Note: If the order has "Delivery with Pickup" checked, the label is annotated accordingly.
2.3 COD & Declared Value
- Check "COD" on the order and fill in the "COD Amount" — the T-Cat driver collects payment from the recipient on delivery
- The COD amount must be greater than 0, cannot exceed the order total, and is capped at NT$100,000
- When the COD amount exceeds NT$20,000, the system automatically declares the value to T-Cat (declared value = COD amount), so you can claim compensation for loss or damage
- When the account has "Accept Credit Card" enabled, recipients can pay COD by credit card
📌 Note: T-Cat does not offer declared value for COD amounts of NT$20,000 or less; for high-value COD packages above NT$20,000, automatic declaration ensures compensation coverage is never missed — no per-order setup needed. Also, when one fulfillment is split into multiple packages, multiple tracking numbers are issued but the COD amount is attached only to the first label, so the recipient is never charged twice.
2.4 Delivery Tracking
After labels are generated, the system automatically polls T-Cat for delivery progress (about once an hour) and updates the "Status" column in the "Shipment List":
| Status | Meaning | Suggested Action |
|---|---|---|
| In Transit | T-Cat has collected the package; it is in transfer or out for delivery | — |
| Arrived at Destination | Package handed over to a store or pickup point | Wait for the customer to collect it |
| Received | Delivery complete; the customer has the package | — |
| Return in Transit | Package is on its way back | Check whether the customer refused it or the address was wrong |
| Returned to Sender | The returned package has been delivered back to the sender | Confirm follow-up handling with your warehouse |
| Problem | Delivery exception (unknown address, refused, damaged, lost, etc.) | Contact T-Cat customer service at 412-8888 |
Once the status reaches "Received", it no longer changes.
Section 3: FAQ
3.1 FAQ
▪ What do I need to apply for a T-Cat account?
You need to sign a contract with T-Cat Express first to obtain a "Contract Customer Code" and "Authorization Code". If you haven't signed yet or lost your credentials, contact T-Cat customer service at 412-8888.
▪ Why can't I select a T-Cat shipping type when creating an order?
Check the following in order:
- A T-Cat Express account has been added under "Platform" → "Shipping Integrations"
- The corresponding "Enable Shipping Types" boxes are checked on the account (room temperature, chilled, and frozen are checked separately)
- The account is "Enabled"
▪ What are the COD amount limits?
- Must be greater than 0
- Cannot exceed the order total
- Capped at NT$100,000
Orders exceeding these limits cannot ship — adjust the COD amount.
▪ What is declared value? When is it applied automatically?
Declared value insures valuable packages — you can claim compensation from T-Cat for loss or damage. The system handles it based on the COD amount:
- COD amount NT$20,000 or less: T-Cat does not offer declared value
- COD amount above NT$20,000: the system declares automatically, with declared value = COD amount
Example: a customer pays NT$30,000 on delivery — the system automatically declares NT$30,000.
▪ The label status shows "Print Failed" — what should I do?
- Go to "Shipping Integrations" and verify the "Contract Customer Code" and "Authorization Code"
- Confirm the order's recipient name, phone, and address are complete
- After fixing, contact your warehouse to regenerate the shipping label
▪ How often does the delivery status update?
The system automatically queries T-Cat about once an hour — no manual checking needed. Once the status reaches "Received", it no longer changes.
▪ Why is the actual delivery date different from what I set on the order?
T-Cat does not deliver on Sundays or holidays, so the shipping and delivery dates automatically move to the next available day. Also, the delivery date cannot be on or before the actual shipping date; if the order's "Delivery Date" is no longer feasible, the system automatically uses the next available day after the shipping date.
▪ How are shipping labels counted when one order splits into multiple packages?
Each package gets its own tracking number, trackable separately in the "Shipment List". For COD orders, the COD amount is attached only to the first label — the driver collects payment once, never charging the recipient twice.
▪ Can I use T-Cat for convenience store pickup, or arrange a driver to collect returns from customers?
The T-Cat Express integration currently supports home delivery shipping (room temperature, chilled, frozen) and automatic delivery tracking only. Convenience store pickup and door-to-door return collection are not part of the integration; for those needs, contact your warehouse to discuss other shipping options.
3.2 Notes
⚠️ Amount Limits
- COD is capped at NT$100,000 and cannot exceed the order total
- COD amounts above NT$20,000 are automatically declared (declared value = COD amount)
⚠️ Delivery Dates
- T-Cat does not deliver on Sundays or holidays; shipping and delivery dates move automatically
- If the order's "Delivery Date" is earlier than the actual shipping date, the system adjusts it automatically
⚠️ Account Maintenance
- An incorrect contract customer code or authorization code causes label generation to fail (label status shows "Print Failed")
- A disabled account is no longer used for shipping; before disabling, confirm no pending orders still need this account
Section 4: Related Features
| Feature | Description | Link |
|---|---|---|
| Order List | Create and manage orders, select shipping types, and set up COD | Go |
| Shipment List | View tracking numbers, label statuses, and real-time delivery statuses | Go |