Shipping Integrations
Table of Contents
Section 1: Use Cases
Quick Links: Connect your own carrier contract account | Auto-route across accounts by weight
Scenario 1: You signed a logistics contract and want shipping labels generated automatically
Situation: You signed contracts with carriers like T-Cat and HCT and received a customer code and authorization code. Logging into each carrier's website to fill in forms and print labels for every shipment is slow and prone to wrong addresses once volume grows.
How to Do It: Under "Platform" → "Shipping Integrations", add a shipping account, select the carrier, fill in the contract credentials, and check the shipping types to enable (see Create & Edit).
Result: The enabled shipping types become selectable when creating orders, and on shipment the system automatically requests tracking numbers, generates labels, and tracks delivery status with your contract account — no more filling forms on the carrier website.
Scenario 2: One carrier with multiple contract accounts, routed automatically by weight
Situation: You signed more than one contract with the same carrier (e.g. separate rate accounts for large and small parcels), and want light parcels to use account A and heavy ones account B — without specifying it on every order.
How to Do It: Create multiple accounts for the same carrier and set a "Weight Threshold" on each. On shipment the system automatically picks the account matching the parcel's weight.
Result: Parcels automatically apply the right contract account by weight, saving per-order judgment and ensuring every parcel uses the correct rate contract.
Section 2: Features
Shipping Integrations lets you connect your own carrier contract accounts (T-Cat, HCT, Pelican, SF Express, ECPay, etc.) to the warehouse system. Once connected, the system automatically generates labels and reports delivery status using your contract account on shipment, with no manual operation on the carrier website. This list page is the management hub for all shipping accounts, with creation and editing done in an on-page dialog.

Quick Jump: Search & Filter | List Columns | Create & Edit | Enable, Disable & Delete
2.1 Search & Filter
The search box at the top finds accounts by "Display Name". Expand filters to add a "Provider" condition to show only a specific carrier's accounts (handy when one carrier has several accounts).
2.2 List Columns
| Column | Description |
|---|---|
| Display Name | The name you gave the account, used to tell multiple accounts of one carrier apart |
| Provider | The carrier this account connects to |
| Enabled | Whether enabled; disabled accounts are not used for shipping |
| Weight Threshold | The minimum parcel weight this account applies to; used to route across multiple accounts of one carrier |
| Warehouse allows own accounts | Whether the warehouse lets the shipping types this account covers use your accounts for labels: "Allowed" means all of them use your accounts; "Not allowed" means all of them use the warehouse's accounts and this account is never used; "Partially allowed" means only some do — hover over the tag to see which are opened and which are not. Only shipping types enabled for you count; shows "-" when the account covers none of them |
When the warehouse has not opened a shipping type your accounts cover (only shipping types currently enabled for you count), a notice at the top of the page lists those shipping types. The warehouse decides whether to open a shipping type; you can only view it here. If the warehouse cannot open a shipping type under the current plan (for example, every shipping type on the Standard plan), the notice instead explains that labels for it always use the warehouse's accounts under the current plan, and does not ask you to contact the warehouse.
2.3 Create & Edit
Click "New" in the top right or "Edit" on a row to open a dialog with two columns:
Fields marked with * are required
| Field | How to Fill | Notes |
|---|---|---|
| *Provider | Select the carrier | Cannot be changed after creation |
| *Display Name | Give the account an easily recognizable name | Up to 100 characters |
| Enable Shipping Types | Check the shipping types this account provides | Only checked types become selectable when creating orders |
| Weight Threshold | Set the minimum parcel weight this account applies to | Leave empty for no threshold; used to route by weight across multiple accounts of one carrier |
| Carrier Integration Settings | Fill in the contract credentials the carrier provided | Fields vary by carrier; fill per your contract details |
After selecting a carrier, the right column shows that carrier's credential fields (e.g. T-Cat's customer code and authorization code, ECPay's merchant ID and keys). Some carriers also have extra settings like "Default Product Name" and "Accept Credit Card". Click save to finish.
When editing an existing account, passwords, keys, and authorization codes appear as ********; their original values cannot be viewed. Leave the masked value unchanged to keep the current credential, or enter the complete new value to replace it. Changing the name or other settings does not clear existing credentials.
After you change "Number Start", the next shipment starts from the new start number; changing only "Number End" (extending or shortening it) continues from the current number. If you shorten the end below a number that has already been used, no tracking numbers can be issued; set a new start number instead. After you change the SF Express "App Key" or "App Secret" and save, the system automatically obtains a new connection token with the new keys.
For HCT, uncheck "Enable proof-of-delivery (POD)" and save to clear the proof-of-delivery connection credentials. You must enter them again to re-enable this feature. For SF Express, clear "Export Customs Declaration Type" or "Import Customs Declaration Type" and save to use the carrier’s default behavior for that setting.
2.4 Enable, Disable & Delete
Each account's actions column offers enable/disable and delete:
| Action | Conditions & Effect |
|---|---|
| Disable | Turns "Enabled" off; the account is no longer used for shipping; can be re-enabled when allowed by your plan |
| Enable | Reopens a disabled account, restoring it for shipping |
| Delete | Only accounts never used by any shipment can be deleted; the delete button is disabled for used accounts to protect historical records |
Section 3: FAQ
3.1 FAQ
▪ Why are some carriers unavailable on the HCT partner plan?
HCT Advanced does not allow T-Cat, E-Can, Kerry TJ or Tongying home delivery, including services provided through ECPay, PAYUNi and other logistics gateways. Only services allowed by your plan are selected by default. Restricted services cannot be newly selected or re-enabled. If an existing account includes restricted services, deselect them before saving, or disable the account to keep its contract details.
HCT, convenience-store delivery and ecommerce-platform logistics (such as momo T-Cat) remain available. ECPay and PAYUNi accounts can still enable their convenience-store services.
▪ What do I need to apply for a shipping account?
You must first sign a contract with the carrier to obtain the corresponding credentials (e.g. T-Cat's customer code and authorization code, HCT's customer number and password). Each carrier requires different fields; after selecting a carrier, the dialog lists the fields it needs.
▪ Why can't I select a shipping type when creating an order?
Confirm three things: (1) you've added an account for the matching carrier; (2) you checked that shipping type under the account's "Enable Shipping Types"; (3) the account is "Enabled".
▪ How do I set the "Weight Threshold"?
With a single account you can leave it empty (no threshold). With multiple accounts for one carrier, set a different weight threshold on each, and the system picks the matching account by parcel weight on shipment. If a parcel is lighter than every threshold, the account with the lowest threshold is used.
▪ I created an account — why are labels still using the warehouse's account?
The warehouse decides per shipping type whether labels use its accounts or yours, so ambient, frozen and cold-chain of the same carrier may differ. Shipping types the warehouse has not opened always use the warehouse's accounts, and yours are never used; when "Warehouse allows own accounts" shows "Partially allowed", hover over the tag to see which shipping types are not opened. Contact the warehouse if you need it to use your accounts; shipping types the warehouse cannot open under the current plan (on Standard, labels always use the warehouse's accounts) are called out separately in the notice at the top of the page.
▪ After the warehouse opened a shipping type, label generation fails saying my account does not include the shipping type or is not enabled. What should I do?
Once opened, only your accounts are used — it never falls back to the warehouse's account. For The merchant's own shipping account does not include this shipping type, edit the account and include that shipping type. For The merchant's own shipping account is not enabled or has not been created, all your accounts for that carrier are disabled or missing — enable or create one.
▪ What's the difference between disabling and deleting an account?
Disabling just temporarily stops the account from being used for shipping; it can be re-enabled when allowed by your plan, and historical records are unaffected. Deleting is permanent, and only accounts never used by any shipment can be deleted. Accounts that have shipped can only be disabled, not deleted.
▪ I picked the wrong "Provider" — can I change it?
The carrier cannot be changed after creation. If wrong, delete it (if the account is unused) or disable it and create a new account with the correct carrier.
▪ Is there more detailed guidance for T-Cat Express?
Yes. For T-Cat's contract credentials, cash on delivery, declared value, and delivery tracking details, see the T-Cat Express page.
▪ What product data does SF Express need for EU shipments?
When the recipient country is one of the 27 EU member states, SF Express requires product identifiers for every item, and the system fills them in from the product's "Barcode" and "SKU" (the SKU must be 18 characters or fewer). The system does not check these in advance: if a product has no Barcode, no SKU, or a SKU longer than 18 characters, SF Express rejects the label request and the error shown is SF Express's own message. Complete the product data and request the label again. Non-EU countries such as the UK, Switzerland, and Norway are not affected.
3.2 Notes
⚠️ Important
- Before disabling an account, confirm no pending orders still need it
- The carrier (Provider) cannot be changed after creation
- Wrong contract credentials cause label generation to fail on shipment
- Once the warehouse opens a shipping type, its orders only use your accounts for labels; if you disable all of them or none includes that shipping type, label generation fails instead of falling back to the warehouse's account
💡 Tip: When one carrier has multiple rate contracts, use "Weight Threshold" to let the system route by weight automatically, avoiding per-order account selection.
Section 4: Related Features
| Feature | Description | Link |
|---|---|---|
| 黑貓宅急便(T-Cat) | T-Cat Express contract setup, cash on delivery, and delivery tracking details | Go |
| Shipment List | View tracking numbers, label statuses, and real-time delivery status | Go |
| Platform API Logs | View success/failure records of integration calls like label generation and tracking | Go |