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

Những câu hỏi hay gặp 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 10.10.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

Sửa lỗi WooCommerce không hiện phí ship Viettel Post
Năm chỗ cần kiểm khi phí Viettel Post không hiện có trong video này. Còn lại xem các câu bên dưới.
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 dịch vụ nào ở 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. Kết nối đăng nhập ViettelPost còn hiệu lực không, và license còn hạn 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 — hay gặp với hàng nhẹ mà cồng kềnh, hoặc kích thước khai trên sản phẩm lớn hơn thực tế. Kiểm lại kích thước sản phẩm trước. Muốn trang thanh toán chỉ tính theo cân nặng thật thì dùng hook skip_weight_conversion, xem bài hook.

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

Mã kết nối ViettelPost không gia hạn được — thường do bạn đã đổi mật khẩu bên ViettelPost, hoặc WP-Cron của website không chạy. Vào mục Login đăng nhập lại là xong, không mất cấu hình nào. Cũng kiểm tra license còn hạn không.

Ô 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.

Trang thanh toán vẫn hiện Quận/Huyện, muốn chuyển sang địa chỉ 2 cấp mới

Mặc định plugin dùng dữ liệu 3 cấp cũ (Tỉnh → Quận/Huyện → Phường/Xã). Vào tab General, khối Công cụ, mục Cập nhật dữ liệu địa chỉ, chọn Mới nhất rồi bấm Cập nhật database.

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

Khi tạo vận đơn bằng tay, khối lượng lấy từ cân nặng và kích thước khai trên sản phẩm; sản phẩm chưa khai cân nặng thì ô khối lượng là 0. Khai đủ cân nặng, kích thước cho từng sản phẩm là cách gốc. Với đơn đang tạo, sửa thẳng ô Khối lượng và Kích thước trong khung tạo vận đơn trước khi bấm tạo. Khối lượng mặc định ở tab đăng đơn tự động chỉ dùng cho đơn do addon đăng tự động/hàng loạt.

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

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

Hay gặp là điều kiện trạng thái hoặc điều kiện thanh toán loại đơn đó ra, hoặc đơn không lấy được kho (đơn không có kho từ dòng phí ship mà Kho mặc định để Tự động theo đơn hàng). Bật Bật log trong tab addon rồi tạo một đơn thử: file vtp_auto_log.txt có dòng mới nghĩa là addon đã gửi sang ViettelPost, đọc thông báo ViettelPost trả về trong đó; không có dòng nào nghĩa là addon chưa tới bước gửi.

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

Addon là phần mua thêm, không có sẵn trong plugin chính. Đã mua thì kiểm addon đã cài và kích hoạt chưa. Thấy tab mà chỉ có ô nhập mã nghĩa là chưa nhập mã bản quyền riêng của addon — 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 khai trên hệ thống Partner. Bấm Lưu thay đổi ở khối Cài đặt Webhook trước, rồi chép Đường dẫn API/Webhook và Tham số bí mật. Đăng nhập partner.viettelpost.vn, vào Bảng điều khiển → Thông tin tài khoản → Cấu hình webhook, dán vào rồi bấm Kiểm tra kết nối. Cũng xem lại bảng ánh xạ: mốc nào để Không đồng bộ trạng thái thì đơn không đổi.

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 lưu Tham số bí mật mới mà chưa cập nhật trên Partner, hoặc website vừa đổi tên miền. Vào Cấu hình webhook trên Partner khai lại cả hai giá trị.

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