Skip to content

Shipping Integrations ​


目錄 ​


一、使用情境 ​

快速連結:Connect a courier to print labels directly | Route heavy parcels to a dedicated account | Restrict an account to specific merchants

情境 1:Connect a courier so the system can print waybills directly ​

狀況:Your warehouse has signed a monthly-billing contract with HCT, and the courier gave you a customer code and password. When shipping, you no longer want to log into the courier's website and create labels one by one — you want a single click on the order to print a waybill that already has a tracking number.

用這個功能:Add a shipping account on this page, pick the carrier, and fill in the customer-code details the courier gave you (see 2.3 Add and edit a shipping account). Once connected, this account can be selected during fulfillment and the system will request tracking numbers and print labels automatically.

結果:When shipping, the system calls the courier to generate the waybill number directly — no more manually creating labels in the courier's portal, dramatically speeding up dispatch.


情境 2:Open two accounts with one courier so heavy parcels route to a dedicated account ​

狀況:You have signed both a "standard" and an "oversized" rate contract with T-Cat. Light parcels should use the cheaper standard rate and heavy parcels should use the oversized rate, but you don't want staff deciding which account to use on every shipment.

用這個功能:Create the two contracts as two separate shipping accounts. Leave the weight threshold blank on the standard account and enter a threshold weight (for example 5) on the oversized account. The system picks the matching account by parcel weight at shipping time.

結果:A 3 kg parcel automatically uses the standard account and an 8 kg parcel uses the oversized account — no manual sorting, and no overcharges from picking the wrong rate account.


情境 3:Make one account available only to a specific merchant ​

狀況:Your warehouse serves several merchants, and one of them has its own dedicated courier contract and customer code that the other merchants must not be able to use.

用這個功能:When adding the account, assign the authorized merchant in the merchant field. Only the selected merchant can use this account during fulfillment.

結果:Each merchant's courier contracts stay isolated, shipments only ever select the account a merchant is authorized for, and billing ownership stays clear.


二、功能介紹 ​

物流串接 (Shipping Accounts) is where you "connect" your warehouse to your courier companies. A shipping account records one set of contract details for talking to a courier (customer code, password, and so on). With it, the system can request waybill numbers and print labels directly from the courier when shipping, saving you from creating each label manually on the courier's website. This page is your entry point for managing every connected account: add new accounts, edit contract details, temporarily disable an account, or delete one you no longer use.

Shipping Integrations - Page overview

快速跳轉:Search and filter | List columns | Add and edit a shipping account | Disable, enable, and delete

  • Search:Enter a keyword to search an account's Display Name.
  • Provider:Filter by carrier, for example showing only HCT or T-Cat accounts; multiple selection is supported.
  • Merchant:Filter by authorized merchant to find the accounts a merchant can use; multiple selection is supported.

2.2 List columns ​

欄位名稱說明
Display NameThe name you gave this account, used to tell different contract accounts apart
ProviderThe carrier this account connects to, for example HCT, T-Cat, or ECPay
WarehouseThe warehouse the account belongs to; you only see accounts for your current warehouse
MerchantThe merchant authorized to use this account; "-" means no merchant has been assigned yet and it cannot be selected when shipping
EnabledShows whether the account is currently enabled or disabled; disabled accounts are not selected during fulfillment
Weight ThresholdThe minimum parcel weight (kg) this account applies to, used for weight-based routing; "-" means no threshold

2.3 Add and edit a shipping account ​

Click "New" at the top right to open the settings window; click "Edit" on a row to open the same window for an existing account. The window has two sides: the left holds general settings, and the right shows the connection fields specific to the carrier you selected.

標示 * 的欄位為必填項目

▸ Left side: general settings ​

欄位名稱如何填寫注意事項
*ProviderChoose the carrier to connect from the listCannot be changed after creation; to switch carriers, create a new account
*Display NameEnter an easy-to-recognize name, for example "HCT-Taipei warehouse" or "T-Cat-oversized"Up to 100 characters
Enable Shipping TypesCheck the shipping types this account opens up; appears after a carrier is selectedAll types allowed by the plan are checked by default and can be unchecked; on save the system automatically activates the checked types for the authorized merchants
MerchantSelect the merchants allowed to use this account; multiple selection is supportedLeave blank to mean no merchant is authorized yet; it will not be selected when shipping and must be filled in later
Weight ThresholdEnter the minimum parcel weight (kg) this account applies to, used to route by weight when one carrier has multiple accountsLeave blank to mean no threshold (standard account)

▸ Right side: carrier connection settings ​

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.

After you pick a carrier, the right side shows the connection fields that carrier requires (for example customer code, password, HashKey). These fields are all required; fill them in from the contract or documentation your courier provided. Different carriers need different fields:

  • HCT:Customer code, account ID, password, customer-code type (billing method).
  • T-Cat:Contract customer code, contract authorization code; you can also set a default product name and whether credit cards are accepted.
  • Pelican (ecan):Customer code; you can also set whether credit cards are accepted.
  • Kerry TJ:Customer number, account ID, password, label number range (start and end).
  • Tong-Ying:Customer code.
  • ECPay:Merchant ID, HashKey, HashIV, logistic type (B2C / C2C); you can also set a default product name.
  • Presco:Parent code, sub-vendor code, label number range, and FTP connection details.
  • Reyi:Parent code, sub-vendor code, public and private keys, shipper code, COD code, return cycle and method, label number range, and FTP details.
  • SF Express:Customer number, App Key, App Secret, AES Key, monthly card number; sign key is optional (status updates are not synced if left blank). Shipments to the EU require a Barcode and SKU on each product — see the FAQ.
  • DHL:Account Number, API Username, API Password.

After filling everything in, click "Save" to finish connecting.

2.4 Disable, enable, and delete ​

Every row has three actions on the right: "Edit", "Disable / Enable", and "Delete".

操作作用是否可逆
DisableTemporarily turns the account off so fulfillment no longer selects it, while keeping all contract detailsReversible; click "Enable" any time to bring it back
EnableRe-opens a disabled account so it can be selected for shipping againReversible
DeletePermanently removes the account from the listIrreversible; cannot be undone

"Delete" is only available when the account has never produced any waybill; if it has ever been used to ship (even for soft-deleted records), the delete button is greyed out to prevent breaking the link to historical shipping and billing records. In that case, use "Disable" instead.


三、常見問題 ​

快速跳轉: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.

For partner organizations, the pricing page shows only HCT Advanced and does not display the plan comparison table. To change or upgrade your plan, please contact customer support.

▪ Which carriers can I connect? ​

Currently supported: HCT, T-Cat, Pelican (ecan), Kerry TJ, Tong-Ying, ECPay, Presco, Reyi, SF Express, and DHL. Each requires different connection fields — see 2.3 Right side: carrier connection settings.

▪ Why can't I change the carrier after creation? ​

The carrier determines the format and connection method of the entire set of fields; switching midway is effectively a completely different contract. To use a different carrier, create a new account, then disable or delete the old one.

▪ Where do I get the connection fields (customer code, password, and so on)? ​

The courier provides this information when you sign the contract — refer to the carrier's contract or API documentation. The system does not generate these codes for you; you must obtain them from the courier and enter them.

▪ Why does the "Merchant" column show "-" for an account? ​

It means no merchant has been authorized for this account yet. Until then fulfillment will not select it; edit the account and add the authorized merchant in the merchant field.

▪ Why is the "Delete" button greyed out on some accounts? ​

Because the account has already been used to ship. To preserve the history of shipping and billing records, an account that has been used cannot be deleted — use "Disable" instead, see 2.4 Disable, enable, and delete.

▪ Can I create multiple accounts with the same carrier? ​

Yes. A common approach is to create separate "standard" and "oversized" accounts with the same carrier and let the system route by parcel weight using the weight threshold, see 情境 2.

▪ Why can't I see some shipping accounts other people created? ​

This page only shows shipping accounts for your current warehouse. Accounts in other warehouses, or accounts created by merchants in their own back office, do not appear here.

▪ The merchant also created an account for the same carrier — which one is used for labels? ​

The warehouse decides per merchant and shipping type in Merchant Shipping Types (for example, HCT ambient can use the merchant's account while HCT frozen uses the warehouse's); for one shipping type the two sides are never mixed:

  • Warehouse (default): only the accounts created on this page for the merchant are used, selected by weight threshold; if no threshold matches, label generation fails. The merchant's own accounts are never used; with no usable warehouse account it shows Shipping account not configured, and when all warehouse accounts are disabled it shows Shipping account is not enabled..
  • Merchant: only the merchant's own accounts that are enabled and include the shipping type are used, selected by weight threshold; if no threshold matches, the one with the lowest threshold is used. Accounts on this page are not used. If the merchant's accounts do not include the shipping type or none is enabled, label generation fails instead of falling back to this page's accounts.

Accounts created in other warehouses are never selected. The Standard plan has no such setting; labels always use the warehouse accounts on this 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 注意事項 ​

⚠️ 重要提醒 ​

  • "Delete" permanently removes the account and cannot be undone; accounts that have been used to ship cannot be deleted and can only be disabled.
  • The Provider cannot be changed after creation — confirm you picked the right carrier before adding.
  • Fill in the customer code, password, and other connection fields from the contract your courier provided; incorrect values will prevent the system from getting tracking numbers when shipping.

💡 提示:If you only want to temporarily stop an account from being selected for shipping, use "Disable" — all contract details are kept and you can re-enable it any time, with no need to delete and recreate.


功能說明連結
Shipping TypesManage the shipping types your warehouse offers; types activated by a shipping account appear here前往
Shipping Rate CardsConfigure how shipping fees are calculated for each shipping type前往
Shipment ListView the waybills and shipping status produced from shipping accounts前往

Last updated 2026-11-16 19:57