Đồng bộ khách hàng

Đẩy tài khoản khách trên website lên danh sách khách hàng của Nhanh.vn, và kéo khách từ Nhanh.vn về website theo lịch. Khách kéo về mà chưa khớp tài khoản nào thì chờ bạn duyệt — plugin không tự tạo tài khoản.

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

Trước khi bật

  • Chỉ có khi kết nối bằng API v3.
  • Lần đầu mở tab, bấm Khởi tạo bảng ngay để plugin tạo bảng lưu liên kết khách giữa hai bên.
  • Lúc cấp quyền ở bước Get accessCode phải có quyền khách hàng. Thiếu thì cấp quyền lại (xem bài kết nối API).

1. Cài đặt

Tab Đồng bộ khách hàng, phần Cài đặt với chế độ đồng bộ, đơn hàng khách guest, lịch tự động kéo về, bảng mapping field và nút Lưu cài đặt
Bấm vào ảnh để phóng to.
  1. Đồng bộ khách hàng — tab thứ tám.
  2. Chế độ đồng bộ — Tắt (mặc định), Chỉ đẩy WP → Nhanh.vn, Chỉ kéo Nhanh.vn → WP hoặc Hai chiều.
  3. Đơn hàng khách (guest) — mặc định tắt. Bật thì khách đặt hàng không cần tài khoản cũng được tạo thành khách hàng trên Nhanh.vn.
  4. Lịch tự động kéo về — Chỉ thủ công (mặc định), Mỗi giờ hoặc Mỗi ngày.
  5. Mapping field — trường nào trên website ứng với trường nào trên Nhanh.vn. Mặc định: mobile → billing_phone, họ và tên → billing_first_name, billing_last_name, email → billing_email, address → billing_address_1, gender → billing_gender; birthday để trống. Tỉnh, quận, phường luôn lấy từ địa chỉ thanh toán sẵn có, không cần khai.
  6. Lưu cài đặt — bắt buộc bấm; hai nút chạy tay ở mục 2 bật hay mờ theo chế độ đã lưu.
Đồng bộ sản phẩm và khách hàng Nhanh.vn về WooCommerce
Video bắt đầu ở 0:55: chọn chế độ, map trường và chạy đồng bộ khách hàng.

Đẩy lên và kéo về chạy thế nào

Đẩy lên: website → Nhanh.vn

  • Chạy ngay khi khách đăng ký tài khoản, sửa hồ sơ hoặc đặt hàng (đặt hàng không cần tài khoản thì chỉ khi bật ô guest).
  • Bắt buộc có tên và số điện thoại Việt Nam hợp lệ; thiếu thì bỏ qua và ghi lý do vào nhật ký.
  • Gửi kèm tỉnh, quận, phường theo mã của Nhanh.vn, chạy được với cả địa chỉ 2 cấp và 3 cấp.

Kéo về: Nhanh.vn → website

  • Không theo thời gian thực — Nhanh.vn chưa có webhook cho khách hàng, nên chỉ kéo về khi bạn bấm nút hoặc tới lịch.
  • Mỗi lần chỉ lấy những khách mới hoặc vừa sửa kể từ lần kéo trước. Danh sách dài thì plugin chạy từng đợt khoảng 20 giây, tự nối đợt sau.
  • Khách khớp được tài khoản trên website thì cập nhật ngay. Thứ tự khớp: liên kết đã có, rồi số điện thoại, rồi email.
  • Kéo về không ghi đè tỉnh, quận, phường, và không đổi email đăng nhập của khách.
  • Chế độ Hai chiều: hai bên cùng sửa một khách thì bản sửa sau cùng thắng.

2. Chạy đồng bộ thủ công

Mục Chạy đồng bộ thủ công với nút Kéo khách hàng từ Nhanh.vn về và nút Đẩy toàn bộ tài khoản WP lên Nhanh.vn
Nút mờ là chiều mà chế độ đã lưu không cho phép.
  1. Kéo khách hàng từ Nhanh.vn về — kéo ngay, không chờ lịch.
  2. Đẩy toàn bộ tài khoản WP lên Nhanh.vn — đẩy mọi tài khoản hiện có (tối đa 2000 tài khoản mỗi lần), chạy trong nền với thanh tiến trình và nút Dừng & xoá tiến trình. Dùng một lần khi mới bật đồng bộ.
Đẩy khách lên chạy ngay lúc khách đặt hàng

Với chế độ có chiều đẩy lên, mỗi đơn mới là một lần gọi Nhanh.vn trong lúc khách bấm đặt hàng. Lúc Nhanh.vn chậm, bước đặt hàng cũng chậm theo. Bật chiều đẩy lên xong, hãy đặt thử vài đơn để xem tốc độ trang thanh toán.

3. Bảng mapping khách hàng

Khách kéo về mà không khớp tài khoản nào nằm ở trạng thái Chờ duyệt.

Bảng mapping khách hàng với bộ lọc, nút Làm mới và các nút Tạo tài khoản WP mới, ô tìm tài khoản, Bỏ qua khách này
Khách trong ảnh là dữ liệu mẫu. Cột Trạng thái hiện mã: mapping là chờ duyệt, update là đã liên kết, skip là đã bỏ qua.
  1. Bộ lọc — Tất cả, Chờ duyệt, Đã liên kết, Đã bỏ qua. Bấm Làm mới để tải lại bảng.
  2. Tạo tài khoản WP mới — tạo tài khoản khách hàng với tên đăng nhập nhanh_<số điện thoại>. Plugin không gửi email cho khách; khách không có email thì plugin dùng địa chỉ tạm <số điện thoại>@placeholder.local.
  3. Ô tìm tài khoản — gõ để tìm một tài khoản có sẵn trên website rồi chọn nó, khách được liên kết vào tài khoản đó.
  4. Bỏ qua khách này — không đồng bộ khách đó nữa.

Tag khách hàng chỉ đi một chiều từ Nhanh.vn về website.

Kiểm tra đã đúng chưa

  1. Đăng ký một tài khoản thử có số điện thoại thật dạng 09xxxxxxxx: vài giây sau khách đó có trên Nhanh.vn.
  2. Tạo một khách mới trên Nhanh.vn, bấm Kéo khách hàng từ Nhanh.vn về: khách hiện trong bảng ở trạng thái chờ duyệt (hoặc đã liên kết nếu trùng số điện thoại).

Lỗi thường gặp

Hiện tượngNguyên nhân và cách xử lý
"Chức năng này chỉ hỗ trợ API v3…"Website đang kết nối bằng API v2. Chuyển sang v3 theo bài kết nối API.
Nút kéo về hoặc đẩy lên bị mờChế độ đã lưu không cho chiều đó. Đổi chế độ rồi bấm Lưu cài đặt.
Một số tài khoản không lên Nhanh.vnThiếu tên hoặc số điện thoại không đúng dạng Việt Nam. Xem nhật ký ở WooCommerce → Trạng thái → Nhật ký.
Khách sửa trên Nhanh.vn mà website chưa đổiKéo về không theo thời gian thực. Đặt lịch Mỗi giờ hoặc bấm kéo tay.
Khách kéo về không có tỉnh, phườngKhi kéo về, plugin không ghi tỉnh, quận, phường vào tài khoản. Khách chọn lại ở lần đặt hàng sau.

Tiếp theo: vận chuyển & phí ship.

Hỗ trợ Zalo