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

Những câu hỏi hay gặp nhất khi dùng plugin ViettelPost. 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à kết nối

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 ViettelPost báo sai tài khoản dù gõ đúng

Tài khoản chưa vào được partner.viettelpost.vn. Đăng nhập được ở đó trước đã, rồi mới điền vào plugin. Xem bài đăng nhập.

Chỉ thấy mục Login, không thấy Cấu hình và Quản lý kho

Hai mục đó chỉ hiện sau khi đăng nhập ViettelPost thành công. Đăng nhập xong tải lại trang.

Kích hoạt plugin xong website trắng trang hoặc báo hết bộ nhớ

Bước nạp dữ liệu Tỉnh/Phường khá nặng. Nhờ hosting nâng memory_limit lên 256M rồi kích hoạt lại. Nếu website không vào được, xoá thư mục wp-content/plugins/devvn-vietnam-shipping bằng FTP để trở lại bình thường.

Cài chung với GHTK, SPX, GHN 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. Bạn khai cấu hình trang thanh toán một lần ở tab General của bất kỳ plugin nào.

Phí ship không hiện

Trang thanh toán không hiện phương thức ViettelPost nào

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

  1. Ô Kích hoạt ở WooCommerce → Cài đặt → Vận chuyển → ViettelPost có đang bật không. Lưu ý: ViettelPost không cần thêm vào khu vực giao hàng, phí tự hiện.
  2. Đã tích ít nhất một dịch vụ ở mục Cấu hình chưa.
  3. Đã có kho gửi hàng và có kho chính chưa.
  4. Khách đã chọn đủ Tỉnh/Thành và Phường/Xã chưa — thiếu là không tính được cước.
  5. Phiên đăng nhập ViettelPost còn hiệu lực không.
Hiện chữ "Phí vận chuyển sẽ báo sau"

ViettelPost không trả được giá cho tuyến đó. Thường vì địa chỉ nhận thiếu Phường/Xã, hoặc kho gửi chưa được duyệt, hoặc dịch vụ đã tích không phục vụ tuyến này. Đổi thử địa chỉ sang một tỉnh lớn để khoanh vùng nguyên nhân.

Phí ship cao hơn bảng giá ViettelPost

Hai nguyên nhân hay gặp: đang bật dịch vụ cộng thêm như khai giá hay phát tận tay ở mục Cấu hình; hoặc khối lượng quy đổi theo kích thước lớn hơn cân nặng thật. Hàng nhỏ mà nặng thì dùng hook skip_weight_conversion, xem bài hook.

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

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

Ô Phường/Xã trống, không chọn được

Dữ liệu địa chỉ chưa nạp xong. Vào tab General, khối Công cụ, bấm Cập nhật database. Hoặc đổi Hình thức tải địa chỉ sang cách khác.

Tạo vận đơn

Không thấy ô ViettelPost 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.

Tạo vận đơ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 ViettelPost. Nếu báo về lấy hàng: kho gửi chưa được ViettelPost duyệt hoặc thiếu Phường/Xã, xem Quản lý kho.

Huỷ đơn báo không thành công

ViettelPost chỉ cho huỷ khi bưu tá chưa nhận hàng. Đã nhận rồi thì phải liên hệ trực tiếp ViettelPost, plugin không làm gì thêm được.

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 giá trị mặc định. Khai cân nặng cho từng sản phẩm là chuẩn nhất; tạm thời thì đặt Khối lượng mặc định ở tab đăng đơn tự động.

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

Đơn không tự đăng dù đã bật đăng đơn tự động

Bật Bật log trong tab addon rồi tạo một đơn thử, sau đó mở file vtp_auto_log.txt trong thư mục plugin để biết plugin dừng ở bước nào. Hay gặp nhất là điều kiện trạng thái hoặc điều kiện thanh toán loại đơn đó ra.

Không thấy tab "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.

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

Webhook chưa được ViettelPost kích hoạt cho tài khoản của bạn. Chép Đường dẫn API/Webhook và Tham số bí mật ở khối Cài đặt Webhook rồi gửi cho IT ViettelPost.

Khách nhận email "đã hoàn thành" quá sớm

Bảng ánh xạ đang trỏ một mốc trung gian vào trạng thái Hoàn thành. Chỉ để mốc giao thành công trỏ vào đó, các mốc còn lại đặt Không đồng bộ trạng thái.

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

Bạn vừa bấm Tạo tham số bí mật mà chưa báo giá trị mới cho ViettelPost, hoặc website vừa đổi tên miền. Gửi lại cả hai giá trị cho ViettelPost.

Email và tra cứu

Khách không nhận được email báo mã 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. Thử gửi một email khác của WooCommerce để biết lỗi chung hay riêng.

Trang tra cứu hiện nguyên chữ [viettel_tracking]

Shortcode đang nằm trong khối không xử lý shortcode. Dán vào một khối Đoạn văn hoặc Shortcode thường rồi cập nhật trang.

Email thiếu liên kết tra cứu

Chưa chọn Trang tracking ở khối cài đặt email, hoặc trang đó chưa có shortcode. Xem bài email và tra cứu.

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:

  • Ảnh chụp màn hình chỗ báo lỗi, chụp cả thông báo của ViettelPost nếu có.
  • Mô tả thao tác bạn vừa làm và kết quả mong đợi.
  • Tên miền website.

Che mã kho, Tham số bí mật, License Key và thông tin khách hàng trước khi gửi ảnh. Zalo / điện thoại: 0965 419 096.

Hỗ trợ Zalo