Mỗi đơn hàng phải gõ lại địa chỉ vào trang GHTK, copy phí ship rồi báo khách là cách làm tốn thời gian và dễ sai. Khi shop nối thẳng WooCommerce với GHTK qua API (giao diện lập trình — cách hai phần mềm tự nói chuyện với nhau), website tự tính cước theo địa chỉ người mua và tạo vận đơn ngay trong trang quản trị. Bài này đi qua ba việc lõi: lấy API token, cấu hình tính phí, và tạo đơn tự động.
Chuẩn bị tài khoản và lấy API token GHTK
Trước khi đụng tới website, bạn cần một tài khoản GHTK đã duyệt và biết nơi lấy token. Theo tài liệu OpenAPI chính thức của GHTK, mọi yêu cầu gửi lên đều phải kèm ba thông tin trong header (phần đầu của yêu cầu gửi đi): Token (chính là API token của bạn), X-Client-Source (mã đối tác) và Content-Type.
Các bước lấy token:
- Đăng nhập tài khoản GHTK trên web khachhang.ghtk.vn.
- Vào màn hình quản lý API token (mục dành cho tích hợp / kết nối hệ thống).
- Tạo token mới: đặt tên, chọn ngày hết hạn và tích các quyền cần dùng — thường là tạo đơn, tính phí ship và tra trạng thái đơn.
- Copy chuỗi token và lưu lại an toàn. Đây là chìa khoá truy cập tài khoản, không dán công khai.
GHTK có hai môi trường: staging (services-staging.ghtklab.com) để chạy thử và production (services.giaohangtietkiem.vn) cho đơn thật. Nên thử ở staging trước rồi mới chuyển sang môi trường thật.
Chọn cách nối GHTK với WooCommerce
Có hai hướng. Hướng phổ biến nhất với shop Việt là dùng plugin GHTK for WooCommerce (có cả bản miễn phí trên kho WordPress lẫn bản trả phí từ các nhà phát triển trong nước). Plugin lo sẵn việc đăng đơn qua API, tính phí ship theo API GHTK, in vận đơn và tra trạng thái ngay trên website — bạn chỉ cần dán token vào.
Hướng thứ hai là tự gọi API nếu shop có nhu cầu đặc thù (gộp nhiều kho, logic phí riêng). Cách này linh hoạt hơn nhưng cần lập trình và bảo trì khi GHTK đổi tham số. Phần lớn shop nhỏ và vừa không cần đi xa tới đó.
Sau khi cài plugin, bạn vào phần cài đặt của nó, dán API token và mã đối tác, khai báo địa chỉ kho lấy hàng. Địa chỉ kho phải khớp với địa chỉ đã đăng ký trên GHTK, vì hệ thống dựa vào đó để tính tuyến và cử shipper tới lấy.
Cấu hình tính phí ship cho khách ở trang đặt hàng
Khi đã nối xong, bật tính phí tự động để khách thấy cước ngay ở trang thanh toán. Mỗi lần khách nhập tỉnh/quận, website gọi API tính phí của GHTK dựa trên địa chỉ kho, địa chỉ nhận và khối lượng đơn, rồi hiển thị số tiền ship.
Lưu ý quan trọng về khối lượng: bạn phải nhập đúng cân nặng cho từng sản phẩm trong WooCommerce. GHTK tính theo khối lượng thực và khối lượng quy đổi (theo kích thước), lấy số nào lớn hơn — nên hàng cồng kềnh nhẹ ký vẫn bị tính cước cao. Bỏ trống cân nặng là nguyên nhân số một khiến phí tính ra sai hoặc bằng 0.
Nhiều shop chọn cách hiển thị phí GHTK thật cho khách tự thấy; số khác gộp một mức phí phẳng và tự bù chênh lệch. Cả hai đều làm được — quyết định dựa trên cách bạn muốn trình bày giá. Nếu trang thanh toán đang dài dòng làm khách bỏ giỏ, có thể tham khảo cách gom checkout về một trang để bước nhập địa chỉ và xem phí ship gọn lại.
Tạo vận đơn và tra trạng thái tự động
Đây là phần tiết kiệm công nhất. Với mỗi đơn trong WooCommerce, bạn bấm nút đẩy đơn sang GHTK ngay trong màn hình chi tiết đơn. Plugin gửi thông tin người nhận, sản phẩm và khối lượng qua endpoint (điểm cuối API) tạo đơn của GHTK; hệ thống trả về mã vận đơn để bạn in tem giao hàng.
GHTK cũng hỗ trợ webhook (cơ chế GHTK chủ động báo ngược về website mỗi khi trạng thái đơn đổi). Khi bật webhook, trạng thái như “đã lấy hàng”, “đang giao”, “giao thành công” cập nhật thẳng vào đơn WooCommerce mà bạn không phải vào app GHTK kiểm tra. Nếu muốn cho khách tự theo dõi, bạn có thể kết hợp với một trang tra cứu hành trình đơn ngay trên website.
Khi nào GHTK hợp hơn GHN
GHTK và GHN cùng là hai hãng vận chuyển lớn nhất cho shop online Việt, nhưng thế mạnh khác nhau. Theo so sánh từ các nguồn trong nước, mỗi bên mạnh một mảng:
| Tình huống | Xu hướng phù hợp |
|---|---|
| Hàng nặng, cồng kềnh (dịch vụ giao hàng nặng BBS) | GHTK có dải dịch vụ riêng cho hàng nặng |
| Tuyến nội tỉnh, đơn nhỏ gọn gần kho | GHN thường có mức phí cạnh tranh |
| Giao xa, tuyến tỉnh lẻ | Cước cả hai đều tăng — cần so từng tuyến cụ thể |
Điểm cần nhớ: cước ship thay đổi theo bảng giá từng thời điểm và từng tuyến, nên đừng chốt cứng “hãng nào rẻ hơn”. Cách an toàn là bật tính phí tự động cho cả hai (nếu tích hợp song song) rồi để con số thật quyết định. Cấu hình GHTK gần như giống GHN về luồng làm việc, nên nếu bạn đã từng nối GHN vào WooCommerce, các bước ở đây sẽ rất quen.
Câu hỏi thường gặp
API token GHTK có hết hạn không?
Có. Khi tạo token bạn chọn ngày hết hạn, nên đặt lịch nhắc gia hạn trước khi token cũ hết để shop không bị gián đoạn đẩy đơn.
Phí ship hiện ra sai hoặc bằng 0 thì sửa ở đâu?
Nguyên nhân hay gặp nhất là sản phẩm chưa khai cân nặng, hoặc địa chỉ kho lấy hàng không khớp với địa chỉ đã đăng ký trên GHTK. Kiểm tra hai chỗ này trước.
Có cần lập trình mới tích hợp được không?
Không bắt buộc. Phần lớn shop dùng plugin GHTK for WooCommerce, dán token là chạy. Chỉ khi cần logic phí đặc thù hoặc nhiều kho mới phải tự gọi API.
Nếu bạn muốn nối GHTK, tính phí và đồng bộ trạng thái đơn cho đúng ngay từ đầu, đội dịch vụ WooCommerce của Web22 có thể hỗ trợ phần kỹ thuật này.