DevVN Docs VNPost

Đăng nhập VNPost API

Bước nối website với tài khoản VNPost. Khác các hãng khác, VNPost cần tới bốn thông tin: mã khách hàng, mã hợp đồng, tài khoản và mật khẩu — và bạn phải chọn đúng hệ thống trước đã.

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

Chọn hệ thống trước

Vào WooCommerce → Cài đặt VNPost, tab Cài đặt VNPost, mục con Cài đặt chung.

Mục Hệ thống VNPost với hai lựa chọn hệ thống mới my.vnpost.vn và hệ thống cũ donhang.vnpost.vn, kèm ô Ghi log debug
Bấm vào ảnh để phóng to.
  1. Hệ thống — chọn Hệ thống mới trên my.vnpost.vn. Lựa chọn còn lại là donhang.vnpost.vn, hệ thống cũ mà VNPost đã bỏ; chỉ chọn nếu bạn thật sự còn dùng nó.
  2. Ghi log (debug) — ghi lại mọi lần plugin gọi API và webhook để còn dò lỗi. Bật lúc mới cài, tắt khi chạy ổn. Log xem tại WooCommerce → Trạng thái → Nhật ký, nguồn devvn-vnpost.

Mở mục Đăng nhập

Cùng tab đó, mục con Đăng nhập.

Tab Cài đặt VNPost với bảy mục con và khung đăng nhập VNPost
Thông tin tài khoản trong ảnh là giá trị mẫu. Bấm vào ảnh để phóng to.
  1. Cài đặt VNPost — tab thứ hai.
  2. Thanh mục con — bảy mục: Cài đặt chung · Đăng nhập · Cấu hình · Kho hàng · Webhook · Email · Cài đặt đăng đơn tự động/hàng loạt.

Điền bốn thông tin

Khung đăng nhập VNPost với lựa chọn môi trường Sandbox hoặc Production, Mã khách hàng, Mã hợp đồng, Tên đăng nhập, Mật khẩu và nút Đăng nhập
Bấm vào ảnh để phóng to.
  1. Môi trường — Sandbox để thử (đơn tạo ra không phát sinh chi phí, không có bưu tá tới lấy), Production khi bán thật. Mỗi môi trường có tài khoản riêng, đăng ký theo liên kết ngay cạnh.
  2. Mã khách hàng (Mã đơn vị) — mã VNPost cấp cho cửa hàng bạn.
  3. Mã hợp đồng — mã hợp đồng CMS của người gửi, do VNPost cung cấp khi ký hợp đồng. Không có thì để trống, plugin vẫn chạy.
  4. Tên đăng nhập — tài khoản VNPost.
  5. Mật khẩu — mật khẩu tài khoản đó.
  6. Đăng nhập — bấm và chờ. Thành công thì các mục con còn lại dùng được.
Đổi mật khẩu bên VNPost thì phải đăng nhập lại ở đây

Plugin giữ một phiên làm việc với VNPost và tự gia hạn. Đổi mật khẩu trên trang VNPost là phiên đó hỏng ngay: phí ship ngừng hiện, đăng đơn báo lỗi. Quay lại mục Đăng nhập điền 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. Sang mục con Cấu hình — phải thấy danh sách gói dịch vụ VNPost.
  2. Sang Kho hàng — khai được kho và lưu được.
  3. Thêm sản phẩm vào giỏ, vào trang thanh toán và xem có hiện phí ship VNPost không.

Lỗi thường gặp

Hiện tượngCách xử lý
Đăng nhập thất bại dù gõ đúngSai hệ thống hoặc sai môi trường. Tài khoản Sandbox không đăng nhập được vào Production và ngược lại.
Báo sai mã khách hàngMã khách hàng (Mã đơn vị) khác với tên đăng nhập. Hỏi lại nhân viên VNPost phụ trách hợp đồng.
Không có mã hợp đồngĐể trống ô đó. Plugin vẫn chạy, chỉ là đơn không gắn với hợp đồng CMS.
Đang chạy tốt bỗng mất phí shipPhiên hết hạn hoặc vừa đổi mật khẩu bên VNPost. Đăng nhập lại.
Muốn biết VNPost trả về gìBật Ghi log (debug) ở mục Cài đặt chung, rồi xem WooCommerce → Trạng thái → Nhật ký.

Tiếp theo: khai kho lấy hàng.

Hỗ trợ Zalo