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 10.10.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 hay gặp 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 đỏ.

Kết nối Viettel Post với WooCommerce trong 4 bước
Video bắt đầu ở 0:40, đúng phần đăng nhập tài khoản Viettel Post trong mục Login của trang này.

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 lưu lại mật khẩu này để tự gia hạn kết nối về sau.
  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.

Đăng nhập xong, plugin lấy một mã kết nối dài hạn từ ViettelPost và tự gia hạn trước ngày hết hạn. Bạn không phải vào đăng nhập lại định kỳ.

Đổi mật khẩu bên ViettelPost thì vào lại mục Login

Đổi mật khẩu trên trang ViettelPost xong, hãy vào lại mục Login và đăng nhập bằng mật khẩu mới. Mã kết nối cũ có thể vẫn chạy tới lần tự gia hạn kế tiếp, nhưng lần gia hạn đó dùng mật khẩu đã lưu — sai mật khẩu là mất kết nối. Đăng nhập lại 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ý khoKết nối 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í shipMã kết nối 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 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