Đồng bộ sản phẩm

Đưa sản phẩm, giá và tồn kho từ KiotViet sang WooCommerce. Đây là bước tốn thời gian nhất khi cài lần đầu, nhưng chỉ phải làm kỹ một lần.

Nguyên tắc: chạy qua hai giai đoạn

Plugin không lấy thẳng từ KiotViet đổ vào WooCommerce, mà đi qua một bộ nhớ đệm trung gian:

Giai đoạn 1 — tải về bộ nhớ đệm. Gọi sang KiotViet lấy toàn bộ sản phẩm rồi cất vào một bảng riêng trên website. Giai đoạn này chưa đụng gì tới sản phẩm WooCommerce của bạn.
Giai đoạn 2 — đưa sang WooCommerce. Đọc từ bộ nhớ đệm rồi tạo mới hoặc cập nhật sản phẩm thật.

Tách hai giai đoạn để bạn xem trước được sẽ nhận về những gì, lọc lấy đúng phần cần, rồi mới cho ghi vào website.

Sao lưu trước khi chạy giai đoạn 2 lần đầu

Giai đoạn 2 có thể tạo mới hoặc ghi đè hàng nghìn sản phẩm và không có nút hoàn tác. Hãy sao lưu cơ sở dữ liệu trước.

Khối đầu tiên quyết định trường nào của KiotViet sẽ ghi đè lên WooCommerce. Bỏ chọn một mục nghĩa là plugin sẽ không đụng tới trường đó nữa.

Nếu bạn tự viết mô tả sản phẩm trên website

Hãy bỏ chọn Mô tả đầy đủ và Ảnh gallery, nếu không công sức viết mô tả sẽ bị dữ liệu KiotViet ghi đè ở lần đồng bộ kế tiếp.

Khối Thống kê Cache cho biết bộ nhớ đệm đang có bao nhiêu sản phẩm và lần cập nhật gần nhất là khi nào.

Tải từ API KiotViet — nút bạn cần khi cài lần đầu. Gọi sang KiotViet lấy toàn bộ sản phẩm về bộ nhớ đệm. Cửa hàng nhiều hàng thì bước này chạy vài phút, đừng đóng tab.
Làm mới thống kê — chỉ đếm lại các con số đang hiển thị, không gọi sang KiotViet.
Xóa Cache — dọn sạch bộ nhớ đệm. Sản phẩm WooCommerce vẫn còn nguyên, chỉ mất dữ liệu tạm nên phải tải lại từ đầu.
Tạo lại bảng — xoá hẳn bảng đệm rồi tạo mới. Chỉ dùng khi bảng bị lỗi và plugin báo không đọc được.

Số trong bộ nhớ đệm không phải số sản phẩm trên website

Bộ nhớ đệm hiện bao nhiêu sản phẩm bên KiotViet. Chúng chỉ thành sản phẩm thật trên website sau khi bạn chạy giai đoạn 2.

Đồng bộ đã chọn — chỉ xử lý những sản phẩm bạn tích ở bảng bên dưới. Nên dùng cách này lần đầu: chọn vài sản phẩm, chạy thử, kiểm tra kết quả rồi mới làm hàng loạt.
Đồng bộ đã chọn trong nền — giao cho website chạy ngầm, bạn đóng tab vẫn chạy tiếp. Dùng khi số lượng lớn.
Đồng bộ tất cả theo filter — xử lý mọi sản phẩm khớp bộ lọc hiện tại, kể cả những trang bạn chưa xem tới. Xem kỹ bộ lọc trước khi bấm.
Đồng bộ tồn kho — chỉ cập nhật số lượng tồn, không đụng tên, giá hay ảnh. Nhanh và an toàn, hợp để chạy khi thấy tồn kho lệch.
Auto Mapping — tự nối sản phẩm KiotViet với sản phẩm WooCommerce sẵn có theo mã hàng, thay vì tạo mới trùng lặp.
Auto Mapping theo tên — nối theo tên khi hai bên không dùng chung mã hàng. Kém chắc chắn hơn nên có màn hình riêng để bạn duyệt từng cặp.

Website đã có sẵn sản phẩm thì chạy Auto Mapping trước

Nối sản phẩm cũ vào KiotViet trước khi đồng bộ, nếu không plugin sẽ tạo thêm một bộ sản phẩm mới và website bạn bị trùng hàng đôi.

Cột bên trái bảng là bộ lọc. Lọc trước rồi mới chọn giúp bạn không phải cuộn qua hàng nghìn dòng.

Hai bộ lọc hay dùng nhất:

Liên kết WooCommerce — chọn "Chưa liên kết" để tìm ra sản phẩm KiotViet chưa có mặt trên website.
Trạng thái — chọn "Đang hoạt động" để bỏ qua hàng đã ngừng kinh doanh.

Cột WooCommerce Product cho biết sản phẩm đã nối với hàng nào trên website. Trống nghĩa là chưa liên kết.

Sao lưu website.
Bấm Tải từ API KiotViet, đợi chạy xong.
Nếu website đã có sản phẩm cũ: chạy Auto Mapping.
Lọc lấy 3–5 sản phẩm, bấm Đồng bộ đã chọn, rồi mở ngoài website xem tên, giá, ảnh, tồn kho đã đúng chưa.
Đúng rồi mới bỏ lọc và chạy Đồng bộ tất cả theo filter hoặc chạy trong nền.

Sau đó nhớ đăng ký webhook để những thay đổi tiếp theo tự về, khỏi phải bấm tay. Còn vướng gì xem Giải đáp thắc mắc.