Plugin kết nối Nhanh.vn với WooCommerce: đồng bộ tồn kho, sản phẩm, đơn hàng

PLUGIN KẾT NỐI NHANH.VN VỚI WOOCOMMERCE LÀ GÌ?

Plugin kết nối Nhanh.vn với WooCommerce là plugin WordPress nối website WooCommerce với phần mềm quản lý bán hàng Nhanh.vn qua Open API của Nhanh.vn. Sau khi cài, sản phẩm và tồn kho trên web đi theo dữ liệu trên Nhanh.vn, còn đơn khách đặt trên web được đăng lên Nhanh.vn để bạn xử lý chung với đơn cửa hàng, đơn sàn.

Plugin do DevVN (Lê Văn Toản) phát triển từ năm 2019 và vẫn được cập nhật theo Open API của Nhanh.vn, theo WooCommerce và theo địa giới hành chính mới. Bản hiện tại chạy Open API v3. Đăng đơn hàng loạt và tự động có sẵn trong plugin, không bán riêng addon.

BÁN HÀNG TRÊN NHANH.VN NHƯNG WEBSITE VẪN LÀM TAY?

Nếu bạn quản lý cửa hàng bằng Nhanh.vn mà website WooCommerce chưa kết nối, có lẽ mỗi ngày bạn đang gặp những chuyện này:

• Web báo còn hàng trong khi cửa hàng đã bán hết, khách đặt xong lại phải gọi xin lỗi, huỷ đơn.
• Tạo sản phẩm trên Nhanh.vn xong lại phải tạo lần nữa trên web, giá hay ảnh đổi một chỗ là lệch chỗ kia.
• Đơn web phải chép tay sang Nhanh.vn từng đơn một, từ tên, số điện thoại, địa chỉ tới sản phẩm, phí ship.
• Khách nhắn hỏi “chi nhánh nào còn size này?” và bạn phải mở Nhanh.vn tra từng kho.
• Báo phí ship cho từng khách vì web không biết giá của các hãng vận chuyển bạn đang dùng trên Nhanh.vn.

Còn nếu bạn là lập trình viên làm web cho khách dùng Nhanh.vn, tự tích hợp Open API nghĩa là phải tự lo cấp quyền lấy access token (hết hạn sau 1 năm), giới hạn 150 request/30 giây, webhook phải trả 200 thật nhanh, phân trang, rồi chuyển từ API v2 sang v3.

NHANH.VN VÀ WEBSITE CHẠY CÙNG NHAU NHƯ THẾ NÀO?

Sau khi cài plugin, dữ liệu đi như sau:

1. Bạn chọn sản phẩm trên Nhanh.vn cần đưa lên web, plugin tạo mới hoặc ghép với sản phẩm đang có, kèm danh mục, biến thể, giá, ảnh, mô tả.
2. Mỗi khi tồn kho trên Nhanh.vn đổi, Nhanh.vn gửi webhook, plugin xếp vào hàng đợi rồi cập nhật số tồn trên web.
3. Khách đặt hàng trên web thấy phí ship của các hãng bạn đã nối trên Nhanh.vn, với địa chỉ 2 cấp sau sáp nhập.
4. Đơn lên Nhanh.vn khi bạn bấm “Đăng đơn hàng lên Nhanh.vn”, chọn nhiều đơn đăng một lần, hoặc để plugin tự đăng khi có đơn mới.
5. Trên Nhanh.vn, đơn web nằm cùng chỗ với đơn cửa hàng và đơn sàn, đóng gói và gửi hãng vận chuyển như bình thường.

TÍNH NĂNG CỦA PLUGIN

15 tính năng dưới đây đều có trong bản 1.6.4, từ kết nối Open API, đồng bộ kho, sản phẩm, khách hàng tới đăng đơn và trang thanh toán:

Kết nối Nhanh.vn bằng Open API v3, thấy rõ hạn token

Tạo app trên open.nhanh.vn, dán App ID và Secret Key, bấm “Get accessCode” để cấp quyền là xong. Các đường dẫn cần khai cho app (Redirect URL, Webhooks callback URL, verify token) đã in sẵn trong trang cài đặt.

• Chọn được Version 3 (khuyên dùng) hoặc Version 2 cho site cũ.
• Hiện ngày token hết hạn và các quyền đã cấp. Token Nhanh.vn có hạn 1 năm, hết hạn thì bấm cấp lại.

Đồng bộ cửa hàng, kho từ Nhanh.vn về website

Bấm “Đồng bộ kho từ Nhanh.vn về web” là toàn bộ cửa hàng, kho trên Nhanh.vn hiện trong plugin. Từ đây bạn quyết định kho nào được tính, kho nào hiện cho khách.

• Đặt làm kho chính và chọn khu vực bán hàng theo tỉnh cho từng kho.
• Không tính tồn kho của kho riêng (kho lỗi, kho trưng bày) vào số tồn trên web.
• Ẩn khỏi danh sách cửa hàng còn hàng, thêm địa chỉ và đường dẫn bản đồ.

Kéo sản phẩm, danh mục, biến thể từ Nhanh.vn về WooCommerce

Khỏi nhập sản phẩm hai lần. Plugin tải danh sách sản phẩm trên Nhanh.vn, bạn chọn từng sản phẩm Mapping (ghép với sản phẩm đã có trên web), Tạo mới hoặc Bỏ qua.

• Đồng bộ danh mục trước, rồi tới sản phẩm và biến thể.
• Nhiều sản phẩm thì bấm đồng bộ trong nền, không phải giữ trang mở.
• Đồng bộ một chiều từ Nhanh.vn về web và không xoá sản phẩm trên web.

Chọn đồng bộ trường nào, có ghi đè hay không

Mỗi shop chỉnh nội dung trên web một kiểu, nên plugin cho bạn chọn từng trường lấy từ Nhanh.vn.

• Giá bán và giá cũ, ảnh đại diện, ảnh gallery, mô tả đầy đủ (giữ định dạng), mô tả ngắn, trọng lượng, kích thước, tồn kho.
• Mỗi mục có ô ghi đè: bỏ tick thì giữ nội dung bạn đã viết trên web.
• Ảnh nhận theo phiên bản: ảnh không đổi thì không tải lại, ảnh trùng tự bỏ qua.

Tồn kho tự cập nhật qua webhook, xử lý chạy nền

Khi tồn kho hoặc sản phẩm trên Nhanh.vn thay đổi, Nhanh.vn gửi webhook về website. Plugin nhận, lưu vào hàng đợi, trả lời Nhanh.vn ngay rồi mới cập nhật, nên website không bị chậm khi có nhiều thay đổi cùng lúc.

• Trang Webhook Queue cho bạn xem sự kiện đang chờ, đã xong, thất bại và bấm Retry.
• Sự kiện trùng của cùng một sản phẩm được gộp lại.
• Webhook được xác thực bằng verify token trước khi xử lý.
• Tự điều tiết dưới giới hạn 150 request/30 giây của Nhanh.vn, gặp khoá tạm thời thì chờ rồi gọi lại thay vì báo lỗi.

Chọn hãng vận chuyển lấy từ Nhanh.vn

Bấm “Lấy danh sách các hãng vận chuyển về web”, plugin tải các hãng có trên Nhanh.vn. Bạn tick hãng nào được hiện cho khách ở trang thanh toán.

• Chọn kết nối có sẵn của Nhanh.vn hoặc tài khoản vận chuyển riêng của shop.
• Bật logo hãng trước tên phương thức và mô tả thời gian giao (ví dụ 2-3 ngày).

Phí ship các hãng đã nối trên Nhanh.vn hiện ở trang thanh toán

Khách chọn tỉnh/thành và phường/xã, trang thanh toán hiện phí ship của các hãng vận chuyển bạn đã kết nối trên Nhanh.vn, tính từ kho phụ trách khu vực của khách (chưa gán thì dùng kho chính). Khách biết phí trước khi đặt, bạn không phải báo phí cho từng người.

• Phí lấy theo kho xuất, địa chỉ nhận, khối lượng giỏ hàng và tiền thu hộ.
• Nhanh.vn chưa trả được giá thì hiện “Phí vận chuyển sẽ báo sau”, khách vẫn đặt được hàng.

Khách tự xem cửa hàng nào còn hàng

Shop có nhiều chi nhánh thường bị hỏi “chỗ nào còn hàng?”. Bật tính năng này, trang sản phẩm có nút “Xem Showroom còn hàng” (đổi chữ được): bấm vào là thấy danh sách cửa hàng đang còn sản phẩm, lấy trực tiếp từ Nhanh.vn.

• Hiện hoặc ẩn số tồn từng cửa hàng.
• Kèm địa chỉ và nút “Chỉ đường” mở bản đồ.
• Đặt danh sách ở chỗ khác bằng shortcode [nhanhvn_depot].

Đăng đơn web lên Nhanh.vn bằng 1 cú click

Trong trang đơn hàng, bấm “Đăng đơn hàng lên Nhanh.vn”: thông tin khách, sản phẩm, khối lượng đã điền sẵn, bạn chọn kho xuất, hãng vận chuyển rồi đăng.

• Thấy trước phí ship từng hãng hoặc chọn Tự vận chuyển.
• Chọn cho xem hàng, ghi chú cho đơn.
• Đơn đã đăng hiện ID đơn trên Nhanh.vn, huỷ được ngay từ website.

Đăng đơn hàng loạt lên Nhanh.vn

Nhiều đơn một lúc? Chọn các đơn trong danh sách rồi chọn “Đăng đơn lên Nhanh.vn”. Plugin dùng các giá trị mặc định bạn cài sẵn để đăng, không cần làm thủ công từng đơn.

• Thêm 2 trạng thái đơn “Đang đóng hàng” và “Đã đăng lên Nhanh.vn” để dễ theo dõi.

Tự động đăng đơn lên Nhanh.vn

Bật một lần, đơn mới tự lên Nhanh.vn mà không cần admin duyệt từng đơn.

• Chọn thời điểm: khi đơn mới được tạo hoặc khi đơn chuyển sang trạng thái bạn chọn.
• Cài sẵn cho xem hàng, trạng thái trên Nhanh.vn sau khi đăng, có tự gửi sang hãng vận chuyển hay không, khối lượng mặc định.
• Chặn đơn có sản phẩm chưa đồng bộ với Nhanh.vn, chọn tài khoản nhận tiền chuyển khoản (API v3).

Đồng bộ khách hàng giữa website và Nhanh.vn

Khách mua trên web và khách mua tại cửa hàng nằm chung một danh sách. Chọn chế độ chỉ kéo về, chỉ đẩy lên hoặc hai chiều (API v3).

• Ghép khách theo số điện thoại, email; khách chưa khớp nằm chờ bạn duyệt: tạo tài khoản mới, liên kết hoặc bỏ qua.
• Kéo về thủ công hoặc theo lịch mỗi giờ, mỗi ngày.
• Không tự gửi email cho khách khi tạo tài khoản.

Trang thanh toán theo địa chỉ Việt Nam 2 cấp sau sáp nhập

Dữ liệu địa chỉ đã cập nhật theo tỉnh/thành và phường/xã mới sau sáp nhập, kèm mã địa chỉ của Nhanh.vn để đơn đăng lên đúng địa chỉ.

• Sổ địa chỉ cho khách đã đăng nhập, chọn địa chỉ kiểu sàn thương mại điện tử.
• Kiểm tra số điện thoại Việt Nam, không bắt buộc email, xưng hô Anh/Chị.
• Freeship theo phương thức thanh toán, làm tròn phí ship.

Tách đơn hàng khi cần giao nhiều lần

Một đơn có món còn hàng, món chưa về? Tách ra đơn mới để xử lý phần có sẵn trước.

• Chọn sản phẩm và số lượng chuyển sang đơn mới.
• Đơn mới giữ nguyên thông tin khách của đơn gốc.

Danh sách đơn gọn, xử lý ngay tại chỗ

Bật giao diện danh sách đơn kiểu mới trong “Cài đặt chung”, mỗi dòng đơn hiện đủ khách, sản phẩm, trạng thái và nút Nhanh.vn.

• Đăng đơn lên Nhanh.vn hoặc huỷ đơn trên Nhanh.vn ngay ở danh sách.
• Đổi trạng thái tại chỗ, lọc theo ngày, tỉnh, quận/huyện, kênh bán.
• Kèm chặn đơn ảo theo IP, từ khoá và reCAPTCHA ở trang thanh toán cổ điển.

Xem giá & mua

LÀM TAY VÀ DÙNG PLUGIN KHÁC NHAU THẾ NÀO?

CÁCH KẾT NỐI NHANH.VN VỚI WOOCOMMERCE TRONG 5 BƯỚC

Không cần biết lập trình. Mỗi bước đều có hướng dẫn chi tiết kèm ảnh:

1. Cài plugin như mọi plugin WordPress rồi kích hoạt bằng mã license nhận qua email. Xem Cài đặt plugin.
2. Tạo app trên open.nhanh.vn rồi dán App ID, Secret Key vào tab “Nhanh.vn” của plugin, chọn Version 3.
3. Bấm “Get accessCode” để cấp quyền cho app trên Nhanh.vn. Plugin hiện ngày token hết hạn để bạn cấp lại đúng hạn. Xem Kết nối Open API Nhanh.vn.
4. Bấm “Đồng bộ kho từ Nhanh.vn về web”, đặt kho chính, chọn hãng vận chuyển hiện ở trang thanh toán. Xem Kho hàng và Vận chuyển.
5. Khai đường dẫn webhook trong app, rồi kéo sản phẩm từ Nhanh.vn về web. Xem Webhook và Đồng bộ sản phẩm.

Cần người cài giúp? Hỗ trợ cài đặt miễn phí qua Zalo.

AI NÊN DÙNG PLUGIN NÀY?

• Chủ shop, chuỗi cửa hàng đang dùng Nhanh.vn và có website WooCommerce, muốn tồn kho trên web khớp cửa hàng, đơn web vào chung một chỗ.
• Lập trình viên, đơn vị làm web cho khách dùng Nhanh.vn, không muốn tự viết và bảo trì phần Open API, vì plugin có sẵn hook/filter để tuỳ biến.
• Shop đang cân nhắc chuyển sang website của Nhanh.vn nhưng không muốn bỏ website WordPress đang có giao diện, bài viết và thứ hạng Google.
• Khách đang dùng bản cũ hoặc API v2 thì xem phần cập nhật lên bản mới và API v3.

Đang dùng KiotViet thay vì Nhanh.vn? Xem plugin đồng bộ KiotViet với WooCommerce.

XEM PLUGIN HOẠT ĐỘNG TRONG VÀI GIÂY

Ba thao tác chính, quay trên website demo với dữ liệu mẫu:

Video hướng dẫn kết nối từ cài đặt tới đăng đơn:

YÊU CẦU HỆ THỐNG VÀ TƯƠNG THÍCH

• WooCommerce 5.6 trở lên, đã kiểm tra tới WooCommerce 11.1.1.
• PHP 7.2 đến 8.2.
• ionCube Loader bật trên hosting, vì plugin được mã hoá bằng ionCube để bảo vệ bản quyền. Hosting chưa bật thì nhờ nhà cung cấp bật trước khi cài plugin.
• Tài khoản Nhanh.vn đã bật “Cho phép kết nối Open API”, và một app tạo trên open.nhanh.vn.
• Website chạy HTTPS, vì Nhanh.vn yêu cầu đường dẫn nhận quyền và đường dẫn webhook dùng https.
• Tương thích HPOS (cách lưu đơn hàng mới của WooCommerce).
• Checkout block có ô địa chỉ khi dùng địa chỉ 2 cấp, trang thanh toán cổ điển dùng được đầy đủ tuỳ chọn.

Lập trình viên có nhiều hook/filter để tuỳ biến mà không sửa lõi plugin, như sửa dữ liệu gửi lên Nhanh.vn trước khi đăng đơn, chọn hãng vận chuyển khi đăng tự động, đổi trường mô tả khi đồng bộ sản phẩm, chạy thêm việc sau khi đăng đơn thành công. Xem Hook cho lập trình viên.

ĐANG DÙNG BẢN CŨ HOẶC API V2?

Nhanh.vn ghi trên trang quản lý app: webhook version 2.0 ngừng hỗ trợ sau 31/08/2026, và tài liệu Open API ghi API phiên bản 2.0 ngừng hỗ trợ sau 30/11/2026. Nếu website của bạn còn chạy plugin bản cũ (1.3.x) hoặc đang chọn API v2, nên lên bản mới và chuyển sang v3:

1. License còn hạn thì cập nhật plugin ngay trong trang quản trị WordPress như mọi plugin khác; license đã hết hạn thì gia hạn để nhận bản mới.
2. Ở tab “Nhanh.vn” chọn Version 3, bấm “Get accessCode” để cấp quyền lại (token v2 không gọi được API v3), rồi trong app trên open.nhanh.vn chọn Webhooks version 3.0.
3. Bấm đồng bộ lại kho và kiểm tra trang Webhook Queue sau khi chuyển.

Chi tiết từng bước ở Kết nối Open API Nhanh.vn. Cần làm giúp? Nhắn Zalo, hỗ trợ cài đặt miễn phí.

CHỌN GÓI PHÙ HỢP

Đổi tên miền? Nhắn Zalo để được gỡ liên kết tên miền cũ.

Xem giá & chọn gói

CÂU HỎI THƯỜNG GẶP

MUA VÀ CÀI ĐẶT

Mua xong, mã license gửi qua email. Bạn cài theo 5 bước ở trên, hoặc nhắn Zalo để được cài giúp miễn phí.

Xem giá & mua

Cần tư vấn trước khi mua? Nhắn Zalo 0965 419 096.

LỊCH SỬ CẬP NHẬT