Giải đáp thắc mắc

Những câu hỏi hay gặp nhất khi dùng plugin VNPost. Không thấy tình huống của bạn ở đây thì nhắn Zalo 0965 419 096.

Hỗ trợ Cập nhật 06.09.2026

Cài đặt và đăng nhập

Mở tab nào cũng bị đá về tab License

Chưa kích hoạt bản quyền. Dán mã vào tab License rồi bấm Active License.

Đăng nhập VNPost thất bại dù gõ đúng

Nguyên nhân số một là sai hệ thống hoặc sai môi trường. Ở mục Cài đặt chung chọn Hệ thống mới trên my.vnpost.vn, và ở mục Đăng nhập chọn đúng Sandbox hay Production — tài khoản của hai môi trường là hai cái khác nhau. Xem bài đăng nhập.

Mã khách hàng lấy ở đâu, khác gì tên đăng nhập

Mã khách hàng (Mã đơn vị) do VNPost cấp khi ký hợp đồng, không phải tên đăng nhập. Hỏi nhân viên VNPost phụ trách hợp đồng của bạn.

Không có Mã hợp đồng thì sao

Để trống ô đó. Plugin vẫn chạy bình thường, chỉ là đơn không gắn với hợp đồng CMS.

Cài chung với GHTK, GHN, ViettelPost trên một website được không

Được, đó là cách thiết kế. Các plugin vận chuyển DevVN dùng chung một module trang thanh toán: bản nạp trước chạy, các bản sau tự nhường.

Phí ship không hiện

Trang thanh toán không hiện gói VNPost nào

Kiểm theo đúng thứ tự này:

  1. Sản phẩm trong giỏ đã khai khối lượng chưa.
  2. Đã tích ít nhất một gói ở mục Cấu hình chưa.
  3. Đã khai kho lấy hàng và có kho chính chưa; kho có đủ Phường/Xã không.
  4. Ô Kích hoạt ở WooCommerce → Cài đặt → Vận chuyển → Bưu điện Việt Nam (VNPost) có đang bật không. Lưu ý: VNPost không cần thêm vào khu vực giao hàng, phí tự hiện.
  5. Khách đã chọn đủ Tỉnh/Quận/Phường chưa — VNPost bắt buộc cần Phường/Xã.
  6. Phiên đăng nhập VNPost còn hiệu lực không.
Hiện chữ "Phí vận chuyển sẽ báo sau"

VNPost không trả được giá cho tuyến đó. Bật Ghi log (debug) ở mục Cài đặt chung rồi xem WooCommerce → Trạng thái → Nhật ký, nguồn devvn-vnpost, để biết VNPost nói gì.

Cước cao hơn bảng giá VNPost

Kiểm hai ô ở mục Cấu hình: dịch vụ báo phát và khai giá sản phẩm đều làm cước tăng. Tắt bớt rồi so lại.

Đang chạy tốt bỗng mất phí ship

Phiên VNPost hết hạn, hoặc bạn vừa đổi mật khẩu bên VNPost. Vào mục Đăng nhập đăng nhập lại là xong.

Đăng và huỷ đơn

Không thấy ô Đăng đơn VNPost trong trang đơn hàng

Ô đang bị ẩn. Mở Tuỳ chọn hiển thị ở góc trên bên phải trang sửa đơn và tích lại. Cũng kiểm tra plugin còn kích hoạt và license còn hạn.

Đăng đơn báo lỗi địa chỉ

Nếu báo về người nhận: địa chỉ khách thiếu Phường/Xã hoặc không khớp dữ liệu VNPost. Nếu báo về lấy hàng: kho gửi khai thiếu Phường/Xã, xem Kho lấy hàng. Nhớ chọn Tỉnh/Quận/Phường từ danh sách chứ đừng gõ tay vào ô địa chỉ.

Bấm huỷ đơn mà đơn vẫn còn trên VNPost

Đúng như thiết kế. VNPost nhận yêu cầu huỷ rồi mới duyệt. Ô sẽ hiện "Đã yêu cầu Huỷ đơn hàng. Chờ VNPost xử lý" kèm nút Kiểm tra trạng thái Huỷ — bấm lại sau một lúc. Bưu tá đã lấy hàng thì phải liên hệ VNPost.

Đơn tạo ra chỉ là nháp, không thành đơn thật

Trạng thái tạo đơn ở mục đăng đơn tự động đang để Tạo nháp. Đổi sang Tạo đơn, hoặc vào từng đơn bấm Xác nhận tạo đơn.

Khối lượng trên vận đơn sai

Sản phẩm chưa khai cân nặng nên plugin dùng Khối lượng mặc định. Khai cân nặng cho từng sản phẩm là chuẩn nhất — khai nhẹ hơn thực tế là bị VNPost thu thêm cước lúc đối soát.

Tự động và trạng thái

Không thấy mục "Cài đặt đăng đơn tự động/hàng loạt"

Addon chưa cài, chưa kích hoạt, hoặc mã bản quyền riêng của addon chưa được nhập. Addon có license tách rời với plugin chính.

Đơn không tự đăng

Kiểm: đã tích Kích hoạt chưa, điều kiện Tự động khi nào? có khớp trạng thái thật của đơn không. Bật Ghi log (debug) rồi xem WooCommerce → Trạng thái → Nhật ký.

Trạng thái đơn không tự cập nhật

Webhook chưa được khai bên VNPost. Chép Đường dẫn Webhook ở mục Webhook rồi khai vào tài khoản VNPost.

Bật xác thực chữ ký xong là mất hết cập nhật trạng thái

Đây là lỗi hay gặp nhất của VNPost. Tắt xác thực chữ ký đi, để webhook chạy thông đã, xác nhận trạng thái tự đổi được, rồi mới bật lại. Chính plugin cũng ghi cảnh báo này ngay cạnh ô đó.

Webhook trước có chạy, giờ dừng hẳn

Bạn vừa bấm Thay đổi key mà chưa khai lại đường dẫn mới bên VNPost, hoặc website vừa đổi tên miền.

Khách bị thu phí ship mà lẽ ra shop trả

Người trả cước ở mục đăng đơn tự động đang để Người nhận trả. Đổi sang Shop trả.

Email và theo dõi

Khách không nhận được email báo vận đơn

Kiểm Spam trước. Sau đó cài một plugin SMTP và gửi thư qua tài khoản mail của chính tên miền — website chưa cấu hình SMTP thì email rất hay bị chặn.

VNPost có trang tra cứu riêng như GHTK không

Không cần. Plugin chèn hành trình vận đơn thẳng vào trang chi tiết đơn hàng của khách (Tài khoản → Đơn hàng), và gửi kèm liên kết theo dõi trong email. Xem bài email.

Email hiện nguyên chữ {vnpost_id}

Gõ sai tên mã. Bốn mã dùng được là {site_title}, {order_id}, {vnpost_id}, {vnpost_tracking_link}.

Vẫn chưa xong

Gửi cho chúng tôi ba thứ, thường là đủ để trả lời trong vài phút:

  • Bật Ghi log (debug) ở mục Cài đặt chung, làm lại thao tác gây lỗi rồi chép mục mới nhất trong WooCommerce → Trạng thái → Nhật ký, nguồn devvn-vnpost.
  • Mô tả thao tác bạn vừa làm và kết quả mong đợi.
  • Tên miền website.

Che Mã khách hàng, Mã hợp đồng, tài khoản, key webhook, License Key và thông tin khách hàng trước khi gửi. Zalo / điện thoại: 0965 419 096.

Hỗ trợ Zalo