Danh sách kiểm tra khi cài đặt
Plugin tự dò xem website của bạn đã cấu hình tới đâu và còn thiếu gì. Đây là chỗ nên mở đầu tiên mỗi khi thấy đồng bộ không chạy.
Tab Bắt đầu dùng để làm gì
Trạng thái trong tab này được kiểm tra trực tiếp từ cấu hình thật của website, không phải do bạn tự đánh dấu. Nghĩa là nếu nó báo màu xanh thì bước đó thật sự đã xong.
- Tab Bắt đầu — mở tab này mỗi khi nghi ngờ cấu hình có vấn đề.
- Số bước đã xong — ví dụ
7/8nghĩa là còn một bước chưa làm. Thanh màu bên dưới cho thấy tiến độ. - Kiểm tra lại — bấm sau khi bạn vừa sửa cấu hình, để plugin dò lại từ đầu thay vì hiện kết quả cũ.
Trước khi báo lỗi, hãy mở tab này và bấm Kiểm tra lại. Phần lớn ca "không đồng bộ" là do một bước bắt buộc bị tắt hoặc rơi ra sau khi đổi hosting.
Đọc một dòng bước
Mỗi bước hiển thị theo cùng một khuôn, quen mắt rồi thì liếc là biết:
- Biểu tượng trạng thái — dấu tích xanh là đã xong, vòng tròn đỏ là chưa làm, dấu gạch xám là không cần làm vì bạn đã tắt chức năng đó.
- Nhãn phân loại — Bắt buộc là không có không chạy được, Tuỳ chọn là bật khi cần.
- Dòng trạng thái — nói rõ hiện đang thế nào, ví dụ "Đã đăng ký 11 webhook" hoặc "Chưa chọn — đang lấy dữ liệu từ tất cả chi nhánh".
- Nút hành động — nhảy thẳng tới đúng tab để sửa, khỏi phải tự đi tìm.
Bước nào bắt buộc
Bốn bước dưới đây không có thì plugin không chạy. Sáu bước còn lại chỉ bật khi bạn cần.
| # | Bước | Phân loại |
|---|---|---|
| 1 | Kích hoạt License — chưa kích hoạt thì mọi kết nối bị chặn | Bắt buộc |
| 2 | Cập nhật dữ liệu địa chỉ — để địa chỉ đơn hàng khớp với KiotViet | Bắt buộc |
| 3 | Kết nối API KiotViet | Bắt buộc |
| 4 | Chọn chi nhánh — để trống là lấy từ tất cả chi nhánh | Tuỳ chọn |
| 5 | Ánh xạ danh mục | Tuỳ chọn |
| 6 | Đồng bộ sản phẩm lần đầu | Bắt buộc |
| 7 | Đồng bộ đơn hàng | Tuỳ chọn |
| 8 | Phí vận chuyển & phụ thu | Tuỳ chọn |
| 9 | Đồng bộ khách hàng | Tuỳ chọn |
| 10 | Đăng ký Webhook — không có thì thay đổi bên KiotViet không tự về | Bắt buộc |
Khi bạn tắt đồng bộ đơn hàng thì bước 7 sẽ hiện "Không áp dụng". Đó không phải lỗi, chỉ là plugin đang nói bước này không liên quan tới cấu hình hiện tại của bạn.
Phần kiểm tra môi trường
Cuộn xuống dưới danh sách còn một khối nữa: những yếu tố của website chứ không phải của plugin, nhưng lại hay làm đồng bộ cài xong mà không chạy. Ví dụ đường dẫn tĩnh chưa bật thì webhook sẽ không nhận được dữ liệu.
Nếu khối này báo đỏ, hãy sửa trước rồi mới đi tiếp — sửa cấu hình plugin sẽ không giải quyết được.
Xong phần này thì sang Kết nối API KiotViet.