Đăng đơn lên Nhanh.vn từ WooCommerce: thủ công, hàng loạt, tự động

Chào anh em! Khách đặt hàng trên website WooCommerce, còn xác nhận, đóng gói, gửi hãng vận chuyển thì nhân viên làm trên Nhanh.vn. Không nối hai bên thì mỗi đơn web lại phải mở Nhanh.vn gõ lại tên, số điện thoại, địa chỉ, từng sản phẩm, rồi chọn hãng. Đọc xong bài, anh em đăng đơn lên Nhanh.vn được thẳng từ trang đơn WooCommerce và chọn được cách hợp với shop: bấm từng đơn, chọn nhiều đơn đăng một lần, hay để web tự đăng.

Plugin đẩy đơn trong bài là sản phẩm mình tự viết và đang bảo trì, gửi đơn sang Nhanh.vn qua Open API. Còn đơn vào Nhanh.vn rồi đi tiếp thế nào thì mình đọc ở trang hướng dẫn chính thức pos.manual.nhanh.vn và tài liệu developers.nhanh.group, lần kiểm gần nhất là tháng 10/2026. Nhanh.vn đổi giao diện thì tên nút có thể lệch đôi chút, anh em cứ bám theo ý từng bước. Ảnh plugin chụp trên bản demo. Tên khách và cước trong ảnh đều là dữ liệu mẫu.

Đơn website vào Nhanh.vn đi đường nào?

Theo hướng dẫn quy trình xử lý đơn của Nhanh.vn, danh sách đơn trên Nhanh gom đơn từ nhiều nguồn: website của Nhanh hoặc website tích hợp API của Nhanh, Facebook, sàn TMĐT, phần mềm khác nối qua API, và đơn nhân viên tự tạo. Sau đó đơn đi lần lượt từ xác nhận, đóng gói, gửi hãng vận chuyển tới giao thành công. Nhanh.vn ghi rằng khi đơn thành công, hệ thống trừ tồn và cập nhật số tồn hiển thị trên website tích hợp API.

Plugin của mình nằm ở nguồn “website tích hợp API”: gửi dữ liệu đơn WooCommerce qua Open API để Nhanh.vn tạo đơn trong danh sách đơn, kèm ID đơn WooCommerce và nguồn “Website”. Đơn nhân viên tự tạo trong phần mềm thì làm theo hướng dẫn của Nhanh.vn, vào Đơn hàng → Thêm mới rồi điền tay; bài này chỉ nói đơn khách đặt trên web.

Ba cách đăng đơn bên dưới (từng đơn, hàng loạt, tự động) có trong video gần một phút rưỡi này.

Chuẩn bị trước khi đăng đơn lên Nhanh.vn

• Kết nối xong tài khoản Nhanh.vn (khuyên dùng API v3) và đồng bộ kho ở tab “Kho hàng”, đặt một kho chính. Từng bước ở bài kết nối Nhanh.vn với website.
• Sản phẩm trên web đã có ID Nhanh, tức đã Mapping hoặc Tạo mới ở tab đồng bộ sản phẩm; cách làm ở bài đồng bộ sản phẩm Nhanh.vn về website.
• Sản phẩm nên khai cân nặng thật để cước đúng, vì sản phẩm thiếu cân nặng thì plugin lấy “Khối lượng mặc định” ở tab Tự động đăng đơn (mặc định 10 g).
• Phí ship ở trang thanh toán lấy từ Nhanh.vn (tab “Vận chuyển”), không bắt buộc nhưng nên có: dòng phí khách chọn lưu sẵn hãng, dịch vụ, kho; popup đăng đơn chọn sẵn kho đó, còn đăng tự động và hàng loạt dùng đúng hãng, dịch vụ khách đã chọn.

Cách 1: Đăng từng đơn bằng nút trong trang đơn hàng

Mở đơn trong WooCommerce, cột phải có hộp “Đăng đơn Nhanh.vn”. Bấm “Đăng đơn hàng lên Nhanh.vn”, popup “Đăng đơn lên Nhanh.vn” mở ra với thông tin lấy sẵn từ đơn:

• Ô Chọn kho chọn sẵn kho của dòng phí ship, đơn không có dòng phí đó thì chọn kho chính.
• Thông tin khách chỉ để xem, khối lượng và kích thước tính từ sản phẩm, cạnh đó là ô Ngày giao hàng.
• Ô Cho xem hàng? có bốn lựa chọn “Cho xem hàng, không cho thử”, “Cho phép thử”, “Không cho xem hàng” (mặc định) và “Cho xem, không lấy thu ship”.
• Hai ô “Phí ship báo khách” và “Tổng tiền hàng” điền sẵn theo đơn.
• Mục Cước phí vận chuyển là danh sách hãng, dịch vụ, giá lấy từ Nhanh.vn lúc mở popup, kèm lựa chọn “Tự vận chuyển” khi shop tự giao.
• Ô Ghi chú điền sẵn ghi chú khách để lại khi đặt hàng.

⚠️ Bấm “Đăng đơn” thì đơn lên Nhanh ở trạng thái Đã xác nhận và được gửi luôn sang hãng vận chuyển đã chọn; hai giá trị này cố định khi đăng thủ công. Nên kiểm hãng, kho, tổng tiền trước khi bấm.

• Phí ship khách trả trên đơn Nhanh.vn lấy bằng phí ship của đơn web; tổng đơn thấp hơn tiền hàng cộng ship thì phần chênh gửi thành giảm giá, cao hơn (do phí khác) thì cộng vào phí ship khách.
• Đơn không thu COD trên API v3 thì chọn “Tài khoản nhận tiền chuyển khoản” ở tab Tự động đăng đơn để plugin gửi số tiền khách đã chuyển, để trống thì plugin không gửi số tiền này.
• Đăng xong, hộp đơn hiện “ID đơn hàng trên Nhanh.vn”, “Mã đơn vận chuyển” khi Nhanh.vn trả về, và nút “Huỷ đơn trên Nhanh.vn”.

Muốn có nút đăng đơn ngay trong danh sách đơn thì bật “Thay đổi giao diện trang đơn hàng” ở tab “Cài đặt chung” (mặc định tắt). Danh sách sẽ có thêm lọc theo ngày, tỉnh, quận/huyện và đổi trạng thái ngay tại dòng.

Cách 2: Đăng hàng loạt nhiều đơn một lần

Ở danh sách đơn (cả màn hình HPOS lẫn kiểu cũ), tick các đơn cần đăng, chọn hành động hàng loạt “Đăng đơn lên Nhanh.vn” rồi bấm Áp dụng. Không có popup: plugin dùng cài đặt mặc định ở tab “Tự động đăng đơn” (mục dưới) và chạy nền từng đơn một. Hãng, dịch vụ, kho lấy từ dòng phí ship Nhanh của đơn; đơn không có dòng phí Nhanh thì mặc định “Tự vận chuyển” và kho chính.

Cùng chỗ đó có thêm hai hành động “Chuyển sang trạng thái đang đóng hàng” và “Chuyển sang trạng thái đã đăng lên Nhanh.vn”, ứng với hai trạng thái đơn mới plugin thêm vào WooCommerce. Đăng hàng loạt có sẵn trong plugin, không phải mua addon.

Cách 3: Tự động đăng đơn khi có đơn mới

Tab “Tự động đăng đơn”, ô “Kích hoạt” mặc định tắt. Bật lên rồi chọn “Tự động khi nào?”: “Khi đơn mới được tạo”, hoặc khi đơn chuyển sang một trạng thái anh em chọn (mặc định là Hoàn thành). Hoàn thành thường là lúc đơn đã giao xong, nên muốn đơn lên Nhanh.vn kịp đóng gói thì chọn mốc sớm hơn: “Khi đơn mới được tạo”, hoặc khi đơn chuyển sang Đang xử lý nếu shop muốn kiểm đơn trên web trước.

Các cài đặt mặc định dưới đây dùng chung cho đăng tự động và đăng hàng loạt:

• Cho xem hàng?: Không cho xem hàng.
• Ô Trạng thái trên Nhanh.vn sau khi đăng đơn là Mới (hoặc Đã xác nhận); để Mới thì nhân viên vẫn xác nhận đơn trên Nhanh.vn như đơn từ các kênh khác.
• Tự động gửi sang hãng vận chuyển?: Không.
• Trạng thái đơn sau khi đăng tự động: Đã đăng lên Nhanh.vn.
• Khối lượng mặc định cho sản phẩm thiếu cân nặng: 10 g.
• Mục Thanh toán khi đăng đơn (API v3) có nút “Đồng bộ tài khoản kế toán từ Nhanh.vn” và ô “Tài khoản nhận tiền chuyển khoản”, áp cho cả đăng thủ công.

Đơn được đăng chạy nền, mỗi lần một đơn; đơn đã đăng thì bỏ qua, trừ đơn đã huỷ trên Nhanh. Kết quả hiện trong hộp đơn: “Đăng đơn tự động lên Nhanh.vn thành công!” hoặc thông báo lỗi. Nhanh báo lỗi dữ liệu thì plugin không tự đăng lại (chỉ gọi lại khi lỗi mạng), anh em sửa theo thông báo rồi đăng tay. Chi tiết từng ô ở trang đăng đơn lên Nhanh.vn.

Bắt buộc sản phẩm có ID Nhanh.vn

Ô “Bắt buộc sản phẩm có ID Nhanh.vn” ở tab Tự động đăng đơn, mặc định tắt. Bật lên thì mọi kiểu đăng (thủ công, hàng loạt, tự động) bị chặn nếu đơn có sản phẩm hoặc biến thể chưa có ID Nhanh: hộp đơn báo lỗi đỏ kèm tên sản phẩm thay cho nút, đơn có thêm ghi chú “Nhanh.vn: Không đăng đơn…”, và có dòng log trong WooCommerce (nguồn devvn-nhanhvn). Đồng bộ sản phẩm xong thì nên bật để không có đơn nào lên Nhanh thiếu hàng. Dev muốn quyết định riêng từng đơn có filter nhanhvn_require_nhanh_id, xem trang hooks.

Huỷ đơn trên Nhanh.vn từ website

Đơn đã đăng có nút “Huỷ đơn trên Nhanh.vn” (hỏi xác nhận trước khi huỷ). Với API v3, đơn trên Nhanh được huỷ kèm ghi chú “Hủy qua API – Website”. Huỷ xong, nút đăng đơn hiện lại để đăng lại khi cần; mã đơn gửi lần sau có dạng <thời điểm>_<ID đơn>. Plugin không đổi trạng thái đơn trên web khi huỷ, anh em tự chuyển nếu cần. Plugin cũng không sửa đơn đã đăng và không in vận đơn; hai việc này làm trên Nhanh.vn.

Trạng thái đơn từ Nhanh.vn có về lại web không?

Chiều từ web sang Nhanh.vn là ba cách ở trên. Chiều từ Nhanh.vn về web đi bằng webhook và khác nhau theo phiên bản API:

• Với API v2 (site cũ), webhook “Sửa đơn hàng” đổi trạng thái đơn web theo bảng ở tab Webhook → “Cài đặt trạng thái đơn hàng”: 17 trạng thái của Nhanh.vn, mỗi dòng chọn một trạng thái WooCommerce hoặc “Không đồng bộ trạng thái”. Mặc định, Success đổi thành Hoàn thành; Failed, CarrierCanceled, Returning, Returned thành Thất bại; Canceled, Aborted thành Đã huỷ. Có điều Nhanh.vn ghi webhook version 2.0 “Ngừng hỗ trợ sau 31-08-2026”, nên mình khuyên chuyển v3.
• Với API v3, plugin chưa cập nhật trạng thái đơn về WooCommerce; anh em theo dõi trạng thái đơn trên Nhanh.vn. Webhook v3 vẫn xử lý đơn bị xoá trên Nhanh.vn (sự kiện Xóa đơn hàng): đơn web chuyển sang Đã huỷ và được phép đăng lại; tồn kho và sản phẩm cập nhật như bình thường.
• Đơn tạo trên Nhanh.vn (bán tại quầy, đơn sàn) không kéo về WooCommerce.

Khi đơn giao thành công và Nhanh trừ tồn, số tồn trên web đổi theo qua webhook “Cập nhật tồn kho”, mình viết riêng ở bài đồng bộ tồn kho Nhanh.vn. Cách khai webhook và hàng đợi chạy nền có ở bài webhook Nhanh.vn và trang webhook.

Lỗi hay gặp khi đăng đơn

• Không thấy hộp “Đăng đơn Nhanh.vn” là do license chưa kích hoạt hoặc không hợp lệ.
• Hộp đơn báo đỏ kèm tên sản phẩm nghĩa là đang bật “Bắt buộc sản phẩm có ID Nhanh.vn” mà sản phẩm đó chưa nối, anh em Mapping ở tab đồng bộ sản phẩm hoặc nhập Nhanh ID trong trang sửa sản phẩm.
• Khi hiện báo “Nhanh.vn đang giới hạn số lần gọi API (ERR_429)”, plugin đã tự chờ và gọi lại một lần, anh em đợi số giây ghi trong thông báo rồi bấm lại.
• Bật tự động mà đơn không lên thì thường do đơn chưa tới mốc trạng thái đã chọn (mặc định là Hoàn thành), đơn đã đăng trước đó, hoặc Nhanh.vn trả lỗi (đọc trong hộp đơn).
• Đơn trên web không đổi trạng thái theo Nhanh.vn thì xem site đang dùng API nào: v3 thì theo dõi trạng thái trên Nhanh.vn như mục trên, v2 thì kiểm webhook đã bật sự kiện Sửa đơn hàng chưa.

Ba cách đăng đơn ở trên đều nằm sẵn trong plugin kết nối Nhanh.vn với WooCommerce, cùng với đồng bộ sản phẩm, tồn kho, phí ship theo hãng trên Nhanh. Giá xem ở trang sản phẩm; mua xong mình hỗ trợ cài đặt miễn phí.

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

Đăng đơn hàng loạt, tự động có phải mua thêm addon không?

Không. Đăng thủ công, hàng loạt và tự động đều có sẵn trong plugin; tự động mặc định tắt, bật ở tab “Tự động đăng đơn”.

Đăng đơn có gửi luôn sang hãng vận chuyển không?

Đăng thủ công thì có: đơn lên Nhanh ở trạng thái Đã xác nhận và gửi sang hãng đã chọn trong popup. Đăng tự động và hàng loạt thì theo cài đặt, mặc định là trạng thái Mới và không gửi sang hãng.

Trên Nhanh.vn có biết đơn nào đến từ website không?

Plugin gửi kèm ID đơn WooCommerce và nguồn đơn “Website”, tiện đối chiếu hai bên khi khách gọi hỏi đơn.

Anh em đang đăng đơn mà vướng chỗ nào cứ để lại bình luận, nhớ che số điện thoại, địa chỉ khách trước khi dán ảnh nhé. Mong từ đơn tới, anh em bấm “Đăng đơn” là đơn nằm ngay trên Nhanh.vn, không dính hộp báo đỏ nào 🚀