Vận chuyển và phí ship

Lấy danh sách hãng vận chuyển từ tài khoản Nhanh.vn, chọn hãng nào hiện cho khách, và quyết định trang thanh toán có hiện logo, thời gian giao hay không. Giá ship do Nhanh.vn tính theo kho gửi, địa chỉ khách và khối lượng giỏ hàng.

Tuỳ chọn Bước 8 / 11 Cập nhật 11.10.2026

Phương thức "Giao hàng qua Nhanh.vn"

Plugin thêm một phương thức vận chuyển tên Giao hàng qua Nhanh.vn. Nó chạy cho mọi đơn, không phải thêm vào khu vực giao hàng của WooCommerce, và ô Kích hoạt bật sẵn. Muốn tắt hẳn thì vào WooCommerce → Cài đặt → Vận chuyển, mục Giao hàng qua Nhanh.vn.

Ở trang thanh toán, mỗi dịch vụ Nhanh.vn trả về là một dòng dạng "Tên hãng - Tên dịch vụ" kèm giá. Ô "Tiêu đề" trong cài đặt phương thức không hiện cho khách.

Mở tab Vận chuyển

Tab Vận chuyển với lựa chọn hình thức kết nối vận chuyển, nút lấy danh sách hãng và bảng hãng vận chuyển có cột Kích hoạt
Ảnh rút gọn danh sách còn 6 hãng. Cột Logo để trống vì máy chụp không tải được ảnh logo từ máy chủ Nhanh.vn.
  1. Vận chuyển — tab thứ tư.
  2. Hình thức kết nối vận chuyển (chỉ API v3) — Kết nối có sẵn của Nhanh.vn (mặc định) dùng các hãng Nhanh.vn đã kết nối sẵn. Kết nối tài khoản riêng của shop dùng khi bạn đã nối tài khoản hãng vận chuyển của riêng mình vào Nhanh.vn; khi đó mỗi hãng bạn tích là một lần hỏi giá riêng.
  3. Lấy danh sách các hãng vận chuyển về web — bấm để tải danh sách hãng. Nhanh.vn có thêm hãng thì bấm lại.
  4. Kích hoạt — tích hãng muốn cho khách chọn. Không tích hãng nào thì hiện tất cả những gì Nhanh.vn trả về.
Kết nối Nhanh.vn với WooCommerce trong 5 bước
Video bắt đầu ở 1:25: chọn hãng vận chuyển trong tab Vận chuyển, rồi xem phí ship hiện ở trang thanh toán.

Hiển thị ở trang thanh toán

Khối Hiển thị ở trang thanh toán với hai ô Logo hãng vận chuyển và Mô tả thời gian giao
Bấm vào ảnh để phóng to.
  1. Logo hãng vận chuyển — hiện logo trước tên phương thức. Mặc định bật. Chỉ có với API v3.
  2. Mô tả thời gian giao — thêm mô tả dịch vụ trong ngoặc sau tên, ví dụ "(2-3 ngày)". Mặc định bật.

Đổi xong bấm Lưu thay đổi ở cuối tab.

Khách thấy gì

Trang thanh toán với địa chỉ khách mẫu và ba dịch vụ vận chuyển kèm thời gian giao và giá
Trang thanh toán với dữ liệu và giá mẫu.

Plugin hiện tất cả dịch vụ Nhanh.vn trả về cho các hãng bạn đã chọn, khách tự chọn dịch vụ rẻ hay nhanh.

Phí được tính thế nào

  • Kho gửi — chọn theo kho chính và khu vực bán hàng, xem bài kho hàng.
  • Địa chỉ khách — khách phải chọn đủ tỉnh và phường/xã (địa chỉ 2 cấp), hoặc tỉnh và quận/huyện (3 cấp), thì mới có giá.
  • Khối lượng — tổng cân nặng × số lượng của giỏ, quy ra gram. Giỏ không có sản phẩm nào khai cân nặng thì plugin tính 500 g cho mỗi sản phẩm — giá có thể lệch, nên khai cân nặng cho sản phẩm.
  • Tiền thu hộ — bằng tạm tính giỏ hàng khi khách chọn thanh toán khi nhận hàng (COD) hoặc chưa chọn cách thanh toán; chọn cách khác thì bằng 0.

Kết quả hỏi giá được giữ 1 giờ nếu máy chủ có Redis hoặc Memcached. Không có thì mỗi lần khách tải giỏ hàng, trang thanh toán là một lần hỏi Nhanh.vn.

Khi Nhanh.vn không trả được giá

Nhanh.vn lỗi, thiếu dữ liệu hay không có dịch vụ nào cho địa chỉ đó thì trang thanh toán hiện một dòng "Phí vận chuyển sẽ báo sau." giá 0đ, để khách vẫn đặt được hàng và bạn gọi báo phí sau. Dòng này không tự ẩn khi có phương thức vận chuyển khác. Muốn đổi chữ, xem filter devvn_title_shipping_fee_failed ở bài hook.

Muốn cộng, giảm hay làm tròn phí ship

Tab này không có ô cộng thêm phí. Làm tròn phí ship về nghìn có ở tab Cài đặt chung. Cộng phí đóng gói hay giảm phí theo điều kiện thì dùng filter devvn_nhanhvn_rate — có ví dụ ở bài hook.

Miễn phí ship theo cách thanh toán

Module trang thanh toán có thêm phương thức Freeship by payment method, cài ở WooCommerce → Cài đặt → Vận chuyển, mục cùng tên. Mặc định tắt.

  • Kích hoạt — bật miễn phí vận chuyển theo hình thức thanh toán.
  • Tiêu đề — chữ khách thấy, mặc định "Miễn phí vận chuyển".
  • Chọn hình thức thanh toán — mã cách thanh toán, cách nhau dấu phẩy, ví dụ bacs (chuyển khoản), cod.
  • Tổng đơn hàng — tổng đơn tối thiểu để được miễn phí.
  • Hình thức giao hàng — ẩn các phương thức vận chuyển khác khi đơn đủ điều kiện miễn phí.

Kiểm tra đã đúng chưa

  1. Mở website ở cửa sổ ẩn danh, thêm một sản phẩm có cân nặng vào giỏ.
  2. Vào trang thanh toán, chọn tỉnh và phường/xã.
  3. Thấy các dòng "Tên hãng - Tên dịch vụ" kèm giá là xong. Chỉ thấy "Phí vận chuyển sẽ báo sau." thì xem bảng lỗi bên dưới.

Lỗi thường gặp

Hiện tượngNguyên nhân và cách xử lý
Không có dòng nào của Nhanh.vnLicense không hợp lệ (phương thức biến mất hẳn), phương thức Giao hàng qua Nhanh.vn bị tắt, hoặc khách chưa chọn đủ địa chỉ.
Chỉ có "Phí vận chuyển sẽ báo sau."Chưa đặt kho chính; token hết hạn (xem tab Nhanh.vn); hãng đã chọn không có dịch vụ cho tuyến đó; Nhanh.vn đang giới hạn số lần gọi (ERR_429). Thử bỏ tích hết hãng để xem Nhanh.vn có trả giá nào không.
"Không tìm thấy hãng vận chuyển nào"Chưa bấm Lấy danh sách các hãng vận chuyển về web, hoặc lúc cấp quyền thiếu quyền vận chuyển.
Có hãng không mong muốnChưa tích hãng nào (nên hiện tất cả). Tích đúng các hãng muốn dùng rồi lưu.
Không hiện logo hãngÔ Logo hãng vận chuyển đang tắt, hoặc website dùng API v2 (Nhanh.vn không trả logo).
Phí ship lệch nhiều so với thực tếSản phẩm chưa khai cân nặng (plugin tính 500 g mỗi sản phẩm), hoặc kho gửi không đúng — kiểm tra khu vực bán hàng.

Tiếp theo: đăng đơn lên Nhanh.vn.

Hỗ trợ Zalo