Kết nối Nhanh.vn với WooCommerce

Xem video

Plugin làm được những gì

• Đồng bộ sản phẩm từ Nhanh.vn về website — danh mục, sản phẩm, biến thể, giá, ảnh, mô tả, cân nặng, kích thước và tồn kho. Đi một chiều Nhanh.vn → website: sửa sản phẩm trên website không đẩy ngược lên Nhanh.vn. Xem bài đồng bộ sản phẩm.
• Tồn kho tự cập nhật qua webhook — khi tồn kho hay thông tin sản phẩm đổi trên Nhanh.vn, Nhanh.vn báo về website và plugin cập nhật trong nền. Có trang Webhook Queue để xem từng lượt và thử lại lượt lỗi. Xem bài webhook.
• Phí ship theo hãng trên Nhanh.vn — khách chọn địa chỉ là thấy danh sách hãng và dịch vụ kèm giá, có logo và thời gian giao. Nhanh.vn không trả được giá thì hiện dòng "Phí vận chuyển sẽ báo sau." để khách vẫn đặt được. Xem bài vận chuyển.
• Đăng đơn lên Nhanh.vn — bấm tay trong trang đơn hàng, chọn nhiều đơn rồi đăng một lượt, hoặc để plugin tự đăng khi đơn tới mốc bạn chọn. Huỷ đơn trên Nhanh.vn bằng một nút. Có sẵn trong plugin, không phải mua thêm addon. Xem bài đăng đơn.
• Đồng bộ khách hàng (API v3) — đẩy tài khoản khách trên website lên Nhanh.vn, kéo khách từ Nhanh.vn về theo lịch. Khách chưa khớp tài khoản nào nằm chờ bạn duyệt. Xem bài đồng bộ khách hàng.
• Xem cửa hàng còn hàng — nút "Xem Showroom còn hàng" ở trang sản phẩm hỏi Nhanh.vn tồn từng kho ngay lúc khách bấm. Xem bài xem cửa hàng còn hàng.
• Tự giãn nhịp gọi API — Nhanh.vn giới hạn 150 lần gọi mỗi 30 giây cho từng API. Plugin tự giữ dưới mức đó, và khi Nhanh.vn báo ERR_429 thì tự chờ hết thời gian khoá rồi gọi lại.
• Trang thanh toán kiểu Việt Nam — địa chỉ 2 cấp sau sáp nhập, số điện thoại Việt Nam, reCAPTCHA, chặn đơn rác, sổ địa chỉ, tách đơn. Xem bài trang thanh toán.

Cần chuẩn bị gì

• WordPress đã cài WooCommerce 5.6 trở lên (plugin đã kiểm tới WooCommerce 11.1.1, có hỗ trợ HPOS — màn hình đơn hàng mới).
• Hosting chạy PHP 7.2 trở lên và đã bật ionCube Loader. Thiếu ionCube thì plugin chỉ hiện thông báo lỗi và không chạy.
• Website chạy https — Nhanh.vn yêu cầu địa chỉ nhận webhook phải là https.
• Tài khoản Nhanh.vn của cửa hàng, đã bật "Cho phép kết nối Open API" trong cài đặt doanh nghiệp, và một tài khoản developer ở open.nhanh.vn để tạo app.
• Mã License plugin đã mua tại levantoan.com.

Lộ trình 11 bước

Năm bước đầu là bắt buộc. Các bước sau bật dần tuỳ cách bạn bán hàng — nhưng webhook thì nên làm ngay, không có nó tồn kho chỉ đổi khi bạn bấm đồng bộ tay.

Các tab cấu hình

Toàn bộ nằm ở WooCommerce → Nhanh.vn, thanh tab ngang trên đầu trang.

1. Cài đặt chung — trường địa chỉ và các tuỳ chọn trang thanh toán. Đây là module dùng chung với các plugin vận chuyển của DevVN, chạy cả khi chưa kích hoạt License.
2. Nhanh.vn — chọn phiên bản API, nhập Business ID, App ID, Secret Key và cấp quyền.
3. Kho hàng — đồng bộ kho, kho chính, khu vực bán hàng, nút xem cửa hàng còn hàng.
4. Vận chuyển — hình thức kết nối, danh sách hãng, logo và thời gian giao.
5. Webhook — chạy nền và bảng trạng thái đơn (bảng này chỉ dùng cho API v2).
6. Webhook Queue — hàng đợi webhook. Chỉ hiện khi bật chạy nền.
7. Đồng bộ sản phẩm — danh mục và sản phẩm theo API v3.
8. Đồng bộ khách hàng — chỉ có ở API v3.
9. Tự động đăng đơn — tự đăng, cài đặt mặc định cho đăng hàng loạt, bắt buộc ID Nhanh, tài khoản nhận chuyển khoản.
10. License — mã bản quyền và kiểm tra cập nhật.

Các tab từ Kho hàng tới Tự động đăng đơn chỉ hiện sau khi kết nối Nhanh.vn thành công. Nếu website dùng API v2 thì thay cho hai tab đồng bộ sản phẩm và khách hàng là một tab Đồng bộ thông tin sản phẩm.

Bắt đầu từ Cài đặt plugin.