Điểm khiến nhiều shop chọn nhà vận chuyển này không nằm ở tốc độ nội thành, mà ở chỗ đơn đi tỉnh xa vẫn tới nơi. Viettel Post dựa trên hạ tầng của tập đoàn Viettel nên mạng lưới bưu cục trải khắp 63 tỉnh thành, phủ gần như toàn bộ huyện xã, kể cả vùng nông thôn và hải đảo. Nếu khách của bạn rải đều cả nước chứ không chỉ Hà Nội với TP.HCM, đây là lý do đáng cân nhắc.
Bài viết này đi qua từng bước nối ViettelPost vào WooCommerce qua API (giao diện lập trình — cầu nối để hai hệ thống nói chuyện với nhau), từ khâu xin tài khoản đến lúc đơn tự đẩy sang hệ thống bưu cục.
Vì sao chọn Viettel Post cho shop phủ vùng xa
Theo công bố của doanh nghiệp, mạng lưới chuyển phát đã phủ 100% các huyện trên cả nước, kể cả huyện đảo, với gần 680 bưu cục và khoảng 300 đại lý nhận hàng. Con số này giải thích vì sao đơn đi Lai Châu, Hà Giang hay các xã miền núi thường giao được mà ít bị trả về vì “ngoài vùng phục vụ”.
Điều đó không có nghĩa nhà vận chuyển nào cũng giống nhau. Trước khi quyết, bạn nên đặt thử vài đơn tới chính những địa chỉ khó của khách mình rồi so phí và thời gian. Nếu muốn nhìn toàn cảnh ưu nhược của từng bên, bài so sánh các đơn vị vận chuyển và cổng thanh toán cho bạn một bảng tham chiếu để cân nhắc.
Chuẩn bị tài khoản và token API
Khác với việc tự đăng ký xong dùng ngay, API ViettelPost cấp cho đối tác qua kênh kinh doanh. Quy trình thực tế gồm:
- Liên hệ phòng kinh doanh hoặc chăm sóc khách hàng ViettelPost (hotline doanh nghiệp 0862 235 888, email [email protected]) để yêu cầu kết nối API và thống nhất điều khoản hợp tác.
- Được cấp tài khoản trên cổng Partner (partner.viettelpost.vn). Đây là nơi quản lý đơn, kho gửi và tạo token.
- Tạo token xác thực: vào mục token, đặt tên, hệ thống yêu cầu xác minh qua Email, SMS hoặc Mocha rồi cho bạn copy chuỗi token. Token này là “chìa khoá” để website gọi API thay bạn.
- Khai báo địa chỉ kho gửi (tỉnh/huyện/xã của shop). Phí ship được tính từ điểm này tới địa chỉ khách nên phải đúng.
ViettelPost có môi trường thử để bạn gọi API bằng công cụ như Postman trước khi đẩy lên website thật, tránh tạo nhầm vận đơn thật trong lúc test.
Hai cách đưa Viettel Post vào WooCommerce
Cách 1: Dùng plugin có sẵn
Phù hợp với shop không có lập trình viên. Trên thị trường có vài plugin tiếng Việt hỗ trợ ViettelPost (cả bản miễn phí lẫn bản trả phí khoảng 500 nghìn đến 1 triệu đồng/năm tuỳ nhà cung cấp). Các bản này thường lo sẵn ba việc chính: tính phí tại trang thanh toán, đẩy đơn sang ViettelPost và huỷ đơn. Bạn cài plugin, dán token, chọn kho gửi là chạy.
Lưu ý khi chọn plugin: ưu tiên bản còn được cập nhật theo thay đổi của API, và kiểm tra xem nó có tính phí riêng cho COD (thu hộ — ship thu tiền khi giao) so với đơn trả trước hay không, vì hai loại này phí khác nhau.
Cách 2: Tự gọi API
Nếu shop có người code, gọi thẳng API cho bạn toàn quyền kiểm soát luồng đơn. Ba nhóm endpoint hay dùng:
- Đăng nhập lấy token để xác thực mọi lần gọi sau.
- Tính phí: gửi điểm gửi, điểm nhận, khối lượng, dịch vụ và nhận lại mức cước, rồi đổ vào ô phí ship ở trang thanh toán.
- Tạo vận đơn: khi khách đặt xong, đẩy thông tin đơn sang để sinh mã vận đơn, kèm tra cứu trạng thái sau đó.
Hướng tự code đòi hỏi hiểu cấu trúc dữ liệu địa giới (mã tỉnh/huyện/xã của ViettelPost không trùng với mã hành chính chuẩn, phải lấy đúng từ API danh mục của họ). Đây là phần dễ sai nhất khi tự làm. Nếu bạn cần một bên lo trọn khâu này, dịch vụ WooCommerce của Web22 nhận dựng và đấu nối vận chuyển theo đúng API mới nhất.
Tính phí, tạo đơn và theo dõi trên thực tế
Khi tích hợp xong, luồng chuẩn của một đơn diễn ra thế này:
- Khách chọn tỉnh/huyện/xã ở trang thanh toán, hệ thống gọi API tính phí và hiện cước ngay.
- Khách đặt hàng, bạn (hoặc tự động) bấm đẩy đơn sang ViettelPost, nhận mã vận đơn.
- Bưu cục tới lấy hàng, đơn chuyển trạng thái và bạn tra được trên cổng Partner hoặc ngay trong trang quản trị WooCommerce nếu plugin có gắn mã tra cứu.
Để khách tự xem hàng đang ở đâu mà không phải nhắn hỏi, bạn nên gắn thêm trang theo dõi đơn hàng cho WooCommerce. Việc này giảm hẳn tin nhắn “đơn của em tới đâu rồi” và tăng độ tin cậy của shop.
Vài lưu ý để tránh lỗi vặt
- Khối lượng và kích thước: nhập sai sẽ lệch phí. Với hàng cồng kềnh, ViettelPost tính theo trọng lượng quy đổi thể tích, nên khai đúng kích thước hộp.
- COD và đơn trả trước: cấu hình rõ để phí và số tiền thu hộ không nhầm. Nếu shop có nhiều hình thức, xem thêm cách cấu hình COD trong WooCommerce.
- Đối soát: định kỳ khớp đơn trên cổng Partner với đơn trong website để không bỏ sót đơn chưa đẩy.
Câu hỏi thường gặp
Tích hợp Viettel Post có cần lập trình viên không?
Không bắt buộc. Nếu dùng plugin có sẵn, bạn chỉ cần token và địa chỉ kho là chạy. Chỉ khi muốn tuỳ biến sâu luồng đơn hoặc đồng bộ nhiều kho mới cần người code gọi API trực tiếp.
Phí API ViettelPost tính thế nào?
Bản thân việc kết nối API do ViettelPost cấp theo thoả thuận hợp tác, bạn nên hỏi trực tiếp phòng kinh doanh để rõ điều khoản. Phần chi phí bạn thấy hằng năm thường là phí bản quyền của plugin trung gian, không phải phí gọi API.
Viettel Post có giao được vùng sâu vùng xa hơn các bên khác không?
Theo công bố của doanh nghiệp, mạng lưới phủ 100% huyện cả nước kể cả huyện đảo. Tuy vậy, mỗi khu vực mỗi khác, bạn nên đặt thử đơn tới đúng địa chỉ khó của khách mình rồi so phí lẫn thời gian thực tế trước khi chọn cố định một bên.