Odoo 香港順豐速運連接器
在香港從 Odoo 庫存揀貨直接產生順豐速運（SF Express）運單標籤並追蹤包裹 - 使用您自己的順豐豐橋開放平台憑證（BYOK）
直接從 Odoo 以順豐速運出貨
本模組將任何 Odoo 出貨送貨單轉為香港的順豐速運包裹：下單、取得順豐 運單號、列印可掃描的運單標籤，並持續同步送貨狀態。這是一個 自帶金鑰（BYOK）連接器 - 您貼上由順豐速運開放平台（豐橋 / Fengqiao）發給您的合作夥伴 ID 與校驗碼，每個請求皆以 您自己的密鑰簽署，並直接送往您所設定的順豐端點。沒有中介層，沒有第三方轉送。
包裹下單
一鍵從庫存揀貨下單順豐包裹。連接器組建
EXP_RECE_CREATE_ORDER 負載（寄件人、收件人、貨物、包裹度量、
快遞類型與付款方式）並向順豐登記，將分配到的運單號儲存在送貨單與標準的
物流追蹤參考上。
可列印運單標籤
每筆下單皆產生一份自足的 HTML 運單 - 寄件人／收件人地址區塊、包裹度量， 以及以內嵌 SVG 繪製的運單號 Code128 可掃描條碼。可直接列印； 無需任何外部標籤服務。
即時包裹追蹤
可隨時或透過內建排程動作查詢順豐路由歷史
（EXP_RECE_SEARCH_ROUTES），並將最新掃描狀態與時間保留在
每張送貨單上。一鍵追蹤連結可開啟順豐香港的公開追蹤頁面。
取件前取消
取消尚未收件的已下單包裹（EXP_RECE_UPDATE_ORDER）。送貨單上的
運單號與追蹤參考會被清除，並在 API 日誌中記錄該動作。
為香港而設計
香港沒有郵遞區號制度；順豐以區與地域路由包裹。本連接器反映此特性：絕不 捏造香港郵遞區號，而是改送區／地域文字；當目的地為中國內地或其他使用郵遞 區號的經濟體時，仍會驗證數字郵遞區號。
計費重量取實測重量與體積重量（長 × 寬 × 高，公分除以 5000） 的較大者，即標準空運快遞的體積重量規則，因此標籤始終顯示順豐將據以計費的重量。
功能摘要
| 功能 | 細節 |
|---|---|
| 下單 | 從庫存揀貨建立順豐訂單；分配並儲存運單號。 |
| 簽署請求 | 對訊息主體、時間戳與您的校驗碼計算 MD5 + Base64 msgDigest - 順豐開放平台所載明的簽署機制。 |
| 標籤 | 含內嵌 Code128（ISO/IEC 15417）運單號條碼的可列印 HTML 運單。 |
| 追蹤 | 隨選與排程路由查詢；最新掃描狀態與時間保留於送貨單；公開追蹤連結。 |
| 取消 | 取件前取消已下單包裹；清除運單號與追蹤參考。 |
| 快遞類型 | 順豐標快、順豐特惠、順豐冷運。 |
| 付款方式 | 寄付月結、到付、第三方付。 |
| 稽核日誌 | 每次呼叫均記錄操作、服務碼、運單、狀態、耗時與錯誤摘要。 |
| BYOK | 您自己的順豐合作夥伴 ID 與校驗碼；可編輯閘道網址（沙箱或正式）；無第三方轉送。 |
運作方式
- 安裝模組並開啟 庫存 > 設定 > 送貨方式。
- 建立（或編輯）一個供應商為 順豐速運（香港） 的物流商。
- 貼上您的順豐開放平台合作夥伴 ID、校驗碼與月結卡號，然後按 測試順豐連線。
- 在出貨送貨單上設定此物流商並確認；包裹即下單，運單號隨即儲存。
- 使用 順豐標籤 按鈕預覽／列印運單，或以追蹤連結追蹤包裹。
需求
- Odoo 18.0 或 19.0（Community 或 Enterprise）。
delivery與stock_delivery應用程式（作為相依套件自動安裝）。- 具備合作夥伴 ID 與校驗碼的有效順豐開放平台帳號。
本模組為連接器，組建順豐格式並以您自己的憑證傳輸。與順豐速運無從屬關係， 亦不主張獲其認證。
In English
Hong Kong SF Express Connector for Odoo
SF Express (順豐速運) parcel label generation and shipment tracking for Hong Kong - using your own SF Open Platform credentials (BYOK)
Turns any outgoing Odoo delivery into an SF Express parcel for Hong Kong: it books the shipment, receives the SF waybill number (運單號), prints a scannable Code128 waybill label, tracks routes on demand or by cron, and cancels before pickup. A bring-your-own-key connector - paste the SF Open Platform (豐橋) partner ID and checkword; every request is signed with your own secret (MD5 + Base64 msgDigest) and sent straight to your configured SF endpoint. No middleware, no third-party relay.
Built for Hong Kong
HK has no postal codes; the connector sends district/region text and never fabricates a code, while validating numeric codes for the mainland. Chargeable weight is the greater of actual and volumetric (L×W×H/5000) weight. Express types: Standard, Economy, Cold Chain. Payment: shipper monthly, consignee, third party.
Requirements
Odoo 18.0 or 19.0 (Community/Enterprise), the delivery and stock_delivery apps, and an active SF Open Platform account with partner ID and checkword. A connector that builds the SF format and transmits with your own credentials; not affiliated with or certified by SF Express.
Screenshots
Api Log
Settings
Update date: 2026-07-02