Skip to Content

Hong Kong SF Express

by
Odoo

$ 139.00

v 18.0 Third Party
Live Preview
Versions 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Inventory (stock)
• Invoicing (account)
• Discuss (mail)
Lines of code 1342
Technical Name carrier_hk_sf_express
LicenseOPL-1
Websitehttps://pokutsoft.com/
Versions 18.0 19.0

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 與校驗碼；可編輯閘道網址（沙箱或正式）；無第三方轉送。

運作方式

  1. 安裝模組並開啟 庫存 > 設定 > 送貨方式。
  2. 建立（或編輯）一個供應商為 順豐速運（香港） 的物流商。
  3. 貼上您的順豐開放平台合作夥伴 ID、校驗碼與月結卡號，然後按 測試順豐連線。
  4. 在出貨送貨單上設定此物流商並確認；包裹即下單，運單號隨即儲存。
  5. 使用 順豐標籤 按鈕預覽／列印運單，或以追蹤連結追蹤包裹。

需求

  • 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

Api Log

Settings

Settings

Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Inventory (stock)
• Invoicing (account)
• Discuss (mail)
Lines of code 1342
Technical Name carrier_hk_sf_express
LicenseOPL-1
Websitehttps://pokutsoft.com/ 
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.