Giải đáp thắc mắc

Kiểm tra theo thứ tự: mở tab Bắt đầu xem bước Đăng ký Webhook có màu xanh không. Không có webhook thì thay đổi bên KiotViet sẽ không tự về website.

Nếu webhook vẫn tốt, thử bấm Đồng bộ tồn kho trong tab Đồng bộ sản phẩm để nạp lại ngay. Còn lệch nữa thì thường do sản phẩm chưa được liên kết với KiotViet.

Thường là bộ nhớ đệm của website (WP Rocket, LiteSpeed…) đang giữ trang cũ. Trong tab Cài đặt API hãy bật Tự động xóa cache sản phẩm sau khi cập nhật tồn kho.

Vào tab Cài đặt API, ô Chi nhánh chọn đúng chi nhánh cần dùng rồi lưu lại. Để trống nghĩa là cộng gộp tồn kho của tất cả chi nhánh.

Do chạy đồng bộ khi sản phẩm cũ chưa được nối với KiotViet, nên plugin tưởng là hàng mới và tạo thêm. Lần sau hãy chạy Auto Mapping trước.

Với số hàng đã trùng, lọc theo Liên kết WooCommerce → Chưa liên kết để khoanh vùng rồi xử lý.

Đúng như thiết kế: KiotViet là nguồn dữ liệu chính, sửa ở website sẽ bị ghi đè ở lần đồng bộ kế tiếp. Muốn tự đặt tên riêng thì vào tab Đồng bộ sản phẩm bỏ chọn trường tên trong khối Tùy chọn đồng bộ.

Chạy lại Tải từ API KiotViet rồi đồng bộ, plugin sẽ chuyển các sản phẩm đó về trạng thái ngừng bán. Với sản phẩm có biến thể, sản phẩm cha chỉ ngừng khi tất cả biến thể đều đã ngừng.

Hay gặp nhất là ô Retailer bị gõ cả .kiotviet.vn, hoặc Client Secret dán thiếu ký tự. Xem lại Kết nối API KiotViet.

Nhớ bấm Lưu cài đặt trước rồi mới kiểm tra kết nối.

KiotViet không cho xem lại. Vào Thiết lập → Thiết lập cửa hàng → Kết nối API tạo một kết nối mới, lấy cặp Client ID và Client Secret mới rồi cập nhật vào plugin.

Webhook trỏ về địa chỉ cũ nên không còn nhận được dữ liệu. Sau khi đổi hosting hoặc đổi tên miền, phải đăng ký lại webhook. Mở tab Bắt đầu để xem bước webhook có còn xanh không.

Kiểm tra trong tab Đồng bộ đơn hàng: chức năng đã bật chưa, và quy tắc đang đặt đẩy đơn ở trạng thái nào. Nhiều cửa hàng đặt chỉ đẩy khi đơn chuyển sang Đang xử lý, nên đơn mới đặt chưa thấy là bình thường.

Do dữ liệu đơn vị hành chính hai bên không khớp. Mở tab Bắt đầu, chạy bước Cập nhật dữ liệu địa chỉ để đưa về đúng bộ dữ liệu mới nhất.