KiotViet Sync đã đóng: web WooCommerce đang dùng nên làm gì?

Nếu web WooCommerce của shop anh em đang nối với KiotViet bằng KiotViet Sync, có thể anh em đã gặp cảnh này: dựng web mới, vào Plugins → Add New gõ tên mà không ra plugin nào. Mở trang plugin trên wordpress.org thì chỉ còn một dòng tiếng Anh báo plugin đã đóng từ 04/11/2025. KiotViet Sync là plugin miễn phí do KiotViet làm (tài khoản tác giả mykiot trên WordPress.org), đồng bộ hàng hoá, đơn hàng giữa KiotViet và WooCommerce. Bài này gom các dữ kiện có nguồn: plugin đóng khi nào, vì sao, web còn cài thì nên làm gì, và cách chuyển sang plugin khác mà giữ liên kết sản phẩm, danh mục đang có.

KiotViet Sync đã đóng trên WordPress.org: mốc thời gian, việc cần làm và cách chuyển plugin cho web WooCommerce

Mình cũng làm một plugin nối KiotViet với WooCommerce, nên có quyền lợi trong chuyện này; mục chuyển plugin gần cuối bài nói về plugin của mình. Phần về plugin cũ chỉ lấy từ trang wordpress.org, mã nguồn trên SVN của wordpress.org và trang hướng dẫn trên kiotviet.vn, đọc lại ngày 12/10/2026. KiotViet đang chuyển màn hình quản lý sang giao diện mới 2026, tên menu nhắc trong bài có thể lệch chút so với gian hàng của bạn.

📌 KiotViet Sync đóng trên WordPress.org từ 04/11/2025

Trang wordpress.org/plugins/kiotvietsync hiện ghi: “This plugin has been closed as of November 4, 2025 and is not available for download. This closure is permanent. Reason: Author Request.” Dịch ra: plugin đóng từ 04/11/2025, không tải được nữa, đóng vĩnh viễn, lý do là tác giả yêu cầu.

Để duy trì blog nên mình có làm aff cho 1 số bên hosting. Nhưng dù aff mình cũng chọn 1 số nhà cung cấp uy tín về chất lượng và support nên các bạn cứ yên tâm nhé.

Nếu có mua hosting mà có trong list dưới đây các bạn click vào link trước khi mua để ủng hộ mình nhé. Mình cảm ơn nhiều

  • 📦 Bản cuối là 1.8.5. Readme trên SVN ghi changelog 1.8.5 ngày 05/05/2025, “Tested up to: 6.8”, “Requires PHP: 7.1”.
  • 🔌 Đóng trên WordPress.org không gỡ plugin khỏi web đang cài. Plugin vẫn nằm trên web với bản đang có, chỉ không còn bản cập nhật qua trang Plugins và không cài mới từ kho được.
  • 🛡️ Không còn bản cập nhật nghĩa là lỗi bảo mật công bố sau này cũng không còn bản sửa. Ai cần tra các lỗi đã công bố cho plugin này thì gõ “kiotvietsync” ở trang tìm kiếm của NVD.
  • 📄 Trang hướng dẫn KiotViet Sync trên kiotviet.vn vẫn còn (KiotViet sửa ngày 12/02/2026), vẫn hướng dẫn cài từ Plugins → Add New và chưa ghi plugin đã đóng. Mình cũng chưa thấy trang nào của KiotViet giới thiệu plugin WordPress khác thay vào.

Vậy ai đang tìm “KiotViet Sync WordPress” để cài cho web mới sẽ không cài được bằng cách cũ.

🧰 Web còn cài KiotViet Sync thì nên làm gì?

Không cần làm gấp trong một buổi tối. Nhưng nên có kế hoạch thay, theo thứ tự này:

  1. Sao lưu cả file lẫn database trước khi đụng vào. Plugin cũ lưu liên kết trong bốn bảng riêng: wp_kiotviet_sync_categories, wp_kiotviet_sync_products, wp_kiotviet_sync_orders, wp_kiotviet_sync_logs, theo file activator trên SVN (wp_ là tiền tố mặc định, web của bạn có thể khác).
  2. Chọn cách thay. Có ba hướng: chuyển sang KiotViet Web, website bán hàng có sẵn trong KiotViet; tự viết code theo tài liệu Public API của KiotViet; hoặc dùng một plugin khác cho WooCommerce, có vài plugin trả phí, trong đó có plugin của mình.
  3. Cách mới chạy ổn rồi mới gỡ plugin cũ: Plugins, bấm Deactivate, sau đó Delete.

Ba cách nối KiotViet với website, hợp với ai, tốn bao nhiêu công, mình viết ở bài kết nối KiotViet với website. Riêng câu hỏi bỏ WordPress sang KiotViet Web có ở bài KiotViet Web hay WooCommerce.

Hai điều nên biết trước khi gỡ. Một là file uninstall.php của plugin cũ không có lệnh xoá bảng, nên xoá plugin xong thì bốn bảng trên vẫn nằm trong database. Hai là nút “Ngắt kết nối” trong màn hình Cấu hình của plugin cũ mở hộp “Xóa thông tin” với ô Danh mục, Hàng hóa. Hướng dẫn của KiotViet ghi tích hai ô này là xoá thông tin đã đồng bộ, kết nối lại sẽ đồng bộ từ đầu. Định chuyển sang plugin có dùng dữ liệu liên kết cũ thì đừng tích hai ô đó.

🔁 Chuyển sang plugin của mình mà giữ liên kết sản phẩm

Plugin đồng bộ KiotViet cho WooCommerce do mình viết, không phải sản phẩm của KiotViet, cũng không phải bản mới của KiotViet Sync. Nó dùng Public API của KiotViet và chỉ chạy với gian hàng bán lẻ, bán buôn, không hỗ trợ KiotViet FnB. Phần dành cho shop đang dùng KiotViet Sync là nút Chuyển ID từ plugin cũ, nằm trong khối “Chuyển dữ liệu từ plugin cũ (kvsync)” ở tab “Cài đặt API”.

Thứ tự chuyển bên dưới có trong video chưa tới hai phút này.

  • 🔗 Nút đọc hai bảng plugin cũ để lại, wp_kiotviet_sync_products và wp_kiotviet_sync_categories, rồi gán KiotViet ID cho sản phẩm và danh mục đang có trên web.
  • 🧱 Nút chỉ gán ID, không tạo lại sản phẩm, nên lúc chuyển sản phẩm giữ nguyên đường dẫn, ảnh, mô tả.
  • ⏭️ Mục nào đã có KiotViet ID thì bỏ qua. Dữ liệu của plugin cũ giữ nguyên, không bị xoá. Mỗi lượt chạy 100 dòng.
  • 📭 Nút chỉ chuyển ID sản phẩm và danh mục. Liên kết đơn hàng cũ không chuyển; đơn đã lên KiotViet vẫn nằm trên KiotViet, cần sửa thì sửa ngay trên KiotViet.

Thứ tự chuyển an toàn

  1. Sao lưu web như bước 1 ở trên.
  2. Cài plugin mới, kích hoạt ở tab “License”. License chưa hợp lệ thì plugin không gọi được KiotViet.
  3. Mở tab “Cài đặt API”, nhập “Retailer”, “Client ID”, “Client Secret” rồi bấm “Kiểm tra kết nối”. Đây đúng là bộ ba plugin cũ từng hỏi, chỉ khác tên: Địa chỉ truy cập cửa hàng, Client ID, Mã bảo mật.
  4. Bấm “Chuyển ID từ plugin cũ”, chờ chạy hết các lượt.
  5. Kiểm vài sản phẩm. Ở tab “Đồng bộ sản phẩm”, bấm “Tải từ API KiotViet” để kéo hàng hoá về bảng tạm, lọc theo “Liên kết WooCommerce” xem sản phẩm cũ đã nhận liên kết chưa. Chọn vài dòng để “Cập nhật”, bấm “Đồng bộ đã chọn”, rồi mở các sản phẩm đó trên web xem tên, giá, tồn kho.
  6. Mở tab “Webhook”, bấm “Đăng ký tất cả webhook” để plugin mới nhận 11 sự kiện về sản phẩm, tồn kho, bảng giá, khách hàng, đơn hàng. Đăng ký xong, xem bảng “Danh sách các sự kiện Webhook” đã đủ dòng chưa.
  7. Tắt KiotViet Sync ở trang Plugins. Chạy vài ngày thấy ổn rồi mới xoá.
Tab Cài đặt API của plugin đồng bộ KiotViet cho WooCommerce: ô Retailer, Client ID, Client Secret đã che giá trị, ô Chi nhánh và nút Kiểm tra kết nối
Bước 3: nhập ba thông tin kết nối rồi bấm Kiểm tra kết nối. Giá trị trong ảnh đã che.

Quên chỗ lấy Client ID, Mã bảo mật trên KiotViet thì không sao. Các bước có ảnh nằm ở bài lấy Client ID, Client Secret KiotViet.

Trước lần đồng bộ lớn, xem lại các ô ở tab “Đồng bộ sản phẩm”. Mỗi trường có ô “Ghi đè … nếu sản phẩm đã có …”: tên mặc định ghi đè, mô tả đầy đủ mặc định không ghi đè. Ở “Mapping Giá”, trước đây shop chọn bảng giá nào cho Giá khuyến mại ở plugin cũ thì chọn lại bảng đó cho “Giá khuyến mãi:”. ⚠️ Để ô này ở “– Không dùng –” thì giá khuyến mãi đặt tay trên web bị xoá ở lần đồng bộ sau.

Hai bảng cũ không còn, ví dụ đổi hosting mà chỉ chép file, thì nút “Auto Mapping” ở tab “Đồng bộ sản phẩm” liên kết sản phẩm theo ID và SKU, không ghi đè dữ liệu. Danh mục khi đó ánh xạ ở tab “Ánh xạ danh mục”. Hai bước tải về bảng tạm rồi đồng bộ được giải thích kỹ ở bài đồng bộ sản phẩm KiotViet về WooCommerce.

❓ Câu hỏi thường gặp

KiotViet Sync còn tải được không?

Không. Trang plugin trên wordpress.org ghi không còn cho tải và đóng vĩnh viễn. Bản đăng lại ở trang khác thì không rõ ai đóng gói, mình không khuyên cài.

Web đang chạy KiotViet Sync có tự ngừng không?

Trang đóng plugin không nói gì về chuyện đó. Plugin đã cài vẫn nằm trên web với bản đang có (bản cuối là 1.8.5) cho tới khi bạn tắt. Nó chỉ không có bản cập nhật mới, kể cả bản sửa lỗi bảo mật.

Đã xoá plugin cũ rồi còn chuyển ID được không?

Được, nếu hai bảng wp_kiotviet_sync_products và wp_kiotviet_sync_categories còn trong database. File gỡ cài đặt của plugin cũ không xoá bảng. Trường hợp trước đó đã bấm “Ngắt kết nối” có tích xoá, hoặc ai đó đã dọn database, thì dùng “Auto Mapping” như ở trên.

Plugin của DevVN có phải KiotViet Sync bản mới?

Không. Plugin do mình viết và bảo trì, kết nối qua Public API của KiotViet. DevVN không phải đối tác của KiotViet, và plugin không dùng cho KiotViet FnB.

Shop muốn chuyển mà ngại tự làm thì nhắn mình: plugin có hỗ trợ cài đặt miễn phí, giá xem ở trang sản phẩm. Từng ô của tab kết nối có giải thích ở trang Cài đặt API trong tài liệu plugin.

Web của bạn đang chạy KiotViet Sync bản nào, có bao nhiêu sản phẩm đã liên kết? Kể dưới bình luận, mình chỉ thứ tự chuyển hợp với trường hợp đó.

Bài viết trong series

Kết nối WooCommerce với KiotViet

0/5đã đọc
  1. 1 KiotViet Sync đã đóng: web WooCommerce đang dùng nên làm gì? Đang đọc Đã đọc
  2. 2 Kết nối KiotViet với website: 3 cách và 6 bước nối WooCommerce Đang đọc Đã đọc
  3. 3 Đồng bộ tồn kho KiotViet với website: cơ chế và cách xử lý khi lệch Đang đọc Đã đọc
  4. 4 Đồng bộ sản phẩm KiotViet về WooCommerce: biến thể, ảnh, bảng giá Đang đọc Đã đọc
  5. 5 Đồng bộ đơn hàng KiotViet: đẩy đơn website thành phiếu Đặt hàng Đang đọc Đã đọc
Sản phẩm nổi bật của Toản
x