Đồ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.
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
- Đồng bộ khách hàng — tab thứ tám.
- Chế độ đồng bộ — Tắt (mặc định), Chỉ đẩy WP → Nhanh.vn, Chỉ kéo Nhanh.vn → WP hoặc Hai chiều.
- Đơ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.
- Lịch tự động kéo về — Chỉ thủ công (mặc định), Mỗi giờ hoặc Mỗi ngày.
- 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. - 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.
Đẩ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
- Kéo khách hàng từ Nhanh.vn về — kéo ngay, không chờ lịch.
- Đẩ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.
mapping là chờ duyệt, update là đã liên kết, skip là đã bỏ qua.- 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.
- 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. - Ô 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 đó.
- 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
- Đă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. - 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ượng | Nguyê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.vn | Thiế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 đổi | Ké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ường | Khi 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.