DevVN Docs ViettelPost

Đăng nhập ViettelPost API

Bước nối website với tài khoản ViettelPost của bạn. Chỉ một ô tên đăng nhập và một ô mật khẩu, nhưng có một điều kiện bắt buộc phải làm trước — bỏ qua là đăng nhập mãi không được.

Bắt buộc Bước 3 / 8 Cập nhật 06.09.2026

Làm việc này trước, đừng bỏ qua

ViettelPost có hai hệ thống và tài khoản phải vào được cả hai thì API mới nhận:

  1. Mở partner.viettelpost.vn và đăng nhập bằng tài khoản hiện có.
  2. Không vào được? Sang viettelpost.vn đăng ký với chính tài khoản đó, rồi quay lại thử bước 1.
  3. Vào được cả hai trang rồi mới điền vào khung của plugin.

Đây là nguyên nhân số một khiến việc đăng nhập thất bại. Plugin cũng ghi lại lời nhắc này ngay trên màn hình, ở khung màu đỏ.

Mở mục Login

Vào WooCommerce → ViettelPost, tab ViettelPost, mục con Login.

Tab ViettelPost với ba mục con Login, Cấu hình, Quản lý kho và khung đăng nhập API
Tài khoản trong ảnh là giá trị mẫu. Bấm vào ảnh để phóng to.
  1. ViettelPost — tab thứ hai.
  2. Login · Cấu hình · Quản lý kho — ba mục con. Hai mục sau chỉ hiện sau khi đăng nhập thành công, nên lúc đầu bạn chỉ thấy Login.
  3. Username — tài khoản ViettelPost của bạn.
  4. Password — mật khẩu của tài khoản đó.

Đăng nhập

Khung Đăng nhập ViettelPost API với lời nhắc màu đỏ, ô Username, ô Password và nút Đăng nhập
Bấm vào ảnh để phóng to.
  1. Username — điền tài khoản.
  2. Password — điền mật khẩu. Plugin không hiện lại mật khẩu ở lần vào sau, đó là cố ý.
  3. Đăng nhập — bấm và chờ. Thành công thì hai mục con Cấu hình và Quản lý kho xuất hiện trên thanh mục con.
Đổi mật khẩu bên ViettelPost thì phải đăng nhập lại ở đây

Plugin giữ một phiên làm việc với ViettelPost. Đổi mật khẩu trên trang ViettelPost là phiên đó hỏng ngay: phí ship ngừng hiện, tạo vận đơn báo lỗi. Quay lại mục Login đăng nhập lại là xong, không mất cấu hình nào.

Cách kiểm tra đã nối được chưa

  1. Thanh mục con hiện đủ Login · Cấu hình · Quản lý kho.
  2. Mở Quản lý kho, bấm Đồng bộ kho từ ViettelPost — phải thấy kho của bạn hiện ra.
  3. Mở Cấu hình, bấm Lấy dịch vụ tự động — phải thấy danh sách dịch vụ.

Cả ba đều chạy nghĩa là website đang nói chuyện được với ViettelPost.

Lỗi thường gặp

Hiện tượngCách xử lý
Đăng nhập báo sai tài khoản dù gõ đúngTài khoản chưa vào được partner.viettelpost.vn. Làm phần đầu bài này trước.
Đăng nhập xong vẫn không thấy mục Cấu hình và Quản lý khoPhiên chưa được lưu. Tải lại trang một lần. Vẫn không có thì đăng nhập lại và xem hosting có chặn kết nối ra ngoài không.
Đang chạy tốt bỗng mất phí shipPhiên hết hạn hoặc bạn vừa đổi mật khẩu bên ViettelPost. Vào lại mục Login đăng nhập lại.
Bấm Đăng nhập không phản ứng gìThường do plugin khác gây lỗi JavaScript trên trang quản trị. Mở Console của trình duyệt xem báo gì, hoặc tắt thử các plugin tối ưu.

Tiếp theo: khai kho gửi hàng.

Hỗ trợ Zalo