DevVN Docs Đồng bộ KiotViet

Đồng bộ khách hàng

Nối hồ sơ khách giữa website và KiotViet để lịch sử mua hàng, điểm tích luỹ và công nợ nằm chung một chỗ thay vì tách làm hai.

Tuỳ chọn Bước 7 / 10 Cập nhật 06.09.2026

Chọn chiều đồng bộ trước đã

Đây là quyết định quan trọng nhất của bài này, và đổi giữa chừng thì rắc rối, nên cân nhắc kỹ:

Chế độPhù hợp khi
TắtBạn không cần quản lý khách chung. Đơn vẫn đẩy sang KiotViet bình thường dưới dạng khách lẻ.
KiotViet → WooCommerceBạn đã có sẵn tệp khách trên KiotViet và muốn họ có tài khoản trên website.
WooCommerce → KiotVietKhách chủ yếu đăng ký trên website, muốn đưa họ vào phần mềm bán hàng.
Cả hai chiềuBán cả tại quầy lẫn trên web, cùng một tệp khách. Mạnh nhất nhưng cũng dễ sinh trùng nhất.

Mở tab Đồng bộ khách hàng

Thanh tab với chấm số 1 chỉ vào tab Đồng bộ khách hàng
Tab Đồng bộ khách hàng.
  1. Tab Đồng bộ khách hàng — cấu hình và danh sách khách đều ở đây.

Các mục cấu hình

Khối cài đặt đồng bộ khách hàng
Cài đặt đồng bộ khách hàng. Bấm vào ảnh để đọc rõ.
MụcÝ nghĩa
Chế độ đồng bộBốn lựa chọn ở bảng phía trên.
Tiền tố mã KHVí dụ KH- để nhìn mã là biết khách đến từ website.
Số lượng mỗi batchMỗi lần xử lý bao nhiêu khách. Hosting yếu thì giảm xuống 20–30 cho khỏi quá tải.
Tự động tạo userKhi KiotViet báo có khách mới, tự tạo luôn tài khoản trên website.
Xóa cứng userKhách bị xoá bên KiotViet thì xoá hẳn tài khoản website. Mặc định chỉ gỡ liên kết, an toàn hơn.
Khi đăng ký mớiNgười dùng đăng ký tài khoản trên web là đẩy sang KiotViet ngay.
Guest CheckoutĐẩy cả khách mua không đăng nhập. Bật thì tệp khách đầy đủ hơn, nhưng KiotViet sẽ nhiều hồ sơ dùng một lần.
Cân nhắc kỹ trước khi bật "Xóa cứng user"

Xoá tài khoản WordPress là mất luôn lịch sử đơn hàng gắn với tài khoản đó. Tài khoản quản trị luôn được plugin bảo vệ, nhưng khách thường thì không.

Danh sách khách và các nút thao tác

Hàng nút thao tác khách hàng với bốn vị trí được đánh số
Các nút xử lý hàng loạt. Bấm vào ảnh để phóng to.
  1. Tải từ KiotViet — lấy danh sách khách về xem trước, chưa tạo tài khoản nào trên website.
  2. Đồng bộ tất cả KiotViet → WP — tạo tài khoản website cho khách KiotViet.
  3. Chỉ liên kết KiotViet → WP — nên chạy cái này trước. Chỉ nối những khách đã trùng số điện thoại hoặc email, không tạo mới ai cả.
  4. Đồng bộ tất cả WP → KiotViet — đẩy khách website sang phần mềm bán hàng.
Liên kết trước, tạo mới sau

Chạy Chỉ liên kết trước sẽ ghép hết các khách đã tồn tại ở cả hai bên. Sau đó mới đồng bộ, phần tạo mới chỉ còn đúng những người thật sự chưa có. Làm ngược lại thì mỗi khách thành hai hồ sơ.

Số điện thoại là chìa khoá ghép

Plugin ghép khách chủ yếu theo số điện thoại, sau đó mới tới email. Nên trước khi chạy hàng loạt, kiểm tra dữ liệu điện thoại hai bên có cùng định dạng không — một bên lưu 0912345678, bên kia lưu +84912345678 thì plugin coi là hai người khác nhau.

Thứ tự nên làm

  1. Chọn chế độ đồng bộ, lưu lại.
  2. Bấm Tải từ KiotViet để xem danh sách.
  3. Chạy Chỉ liên kết để ghép khách trùng.
  4. Kiểm tra vài hồ sơ xem ghép đúng người chưa.
  5. Đúng rồi mới chạy đồng bộ hàng loạt.

Tiếp theo là bước quan trọng nhất để mọi thứ chạy tự động: Webhook.

Hỗ trợ Zalo