DevVN Docs SPX Express

Tạo đơn lên SPX

Đẩy đơn hàng sang SPX để lấy mã vận đơn. Làm tay từng đơn cũng được, nhưng hay hơn là đặt điều kiện để đơn tự đi — sáng ra chỉ việc in vận đơn và gói hàng.

Tuỳ chọn Bước 6 / 9 Cập nhật 06.09.2026

Tạo đơn thủ công trong trang đơn hàng

Mở một đơn bất kỳ, nhìn cột bên phải sẽ thấy hộp SPX Express.

Hộp SPX Express của đơn chưa đẩy, chỉ có dòng chữ Đơn chưa đẩy lên SPX và nút Đẩy đơn lên SPX
Đơn chưa đẩy thì hộp chỉ có một nút.

Bấm Đẩy đơn lên SPX, chờ vài giây. Thành công thì hộp đổi hình dạng:

Hộp SPX Express của đơn đã tạo, hiện mã vận đơn, trạng thái, kho gửi, phí ước tính và bốn nút thao tác
Hộp sau khi đã có vận đơn. Mọi thông tin trong ảnh là dữ liệu mẫu.
MụcÝ nghĩa
Mã vận đơnMã SPX cấp, bấm vào là mở trang tra cứu của SPX.
Trạng tháiTình trạng vận đơn lấy từ SPX, ví dụ Chờ lấy hàng.
Kho gửiKho nào được dùng cho đơn này.
Phí ước tínhPhí lúc tạo đơn. SPX cân lại hàng thật có thể ra số khác — bấm Phí thực tế để lấy con số cuối.
In vận đơnMở phiếu giao hàng của SPX để in dán lên kiện.
Cập nhật TTHỏi SPX trạng thái mới nhất. Dùng khi chưa bật webhook.
Hủy đơnHuỷ vận đơn bên SPX. Chỉ huỷ được khi shipper chưa lấy hàng.

Tự động tạo đơn

Vào WooCommerce → SPX Express → Tạo đơn.

Khối Tự động tạo đơn với công tắc bật, điều kiện theo trạng thái và hình thức thanh toán, và trạng thái sau khi tạo
Điều kiện tự động tạo đơn.
  1. Tạo đơn — mục thứ năm trên thanh tab.
  2. Bật tự động tạo đơn — công tắc tổng.
  3. Trạng thái — đơn chuyển sang trạng thái này thì đẩy. Hay dùng nhất là Đang xử lý.
  4. Hình thức thanh toán — chỉ áp cho một cổng thanh toán, hoặc Tất cả.
  5. Trạng thái sau khi tạo — chuyển đơn sang trạng thái khác ngay sau khi có vận đơn, tiện để lọc "đơn đã đẩy" trong danh sách.

Bấm Thêm điều kiện để có nhiều quy tắc, ví dụ đơn chuyển khoản thì đẩy ngay khi Đang xử lý, còn đơn COD thì đợi tới khi bạn gọi xác nhận xong mới đẩy. Ô Chạy nền cho phép đẩy đơn ở hàng đợi để trang quản trị không phải chờ.

Bật tự động ở môi trường Production là tạo vận đơn thật

Mỗi đơn thoả điều kiện sẽ tự sinh vận đơn, và huỷ muộn có thể phát sinh phí. Hãy chạy thử toàn bộ quy tắc ở môi trường Test trước, xem đúng loại đơn nào được đẩy rồi mới chuyển sang Production.

COD, người trả phí và bảo hiểm

Khối COD với công tắc thu hộ, danh sách cổng thanh toán tính là COD, ô người trả phí và bảo hiểm
Ba nhóm quyết định tiền bạc của vận đơn.
  1. Thu hộ COD — bật thì shipper thu tiền của khách. Bên dưới là danh sách cổng thanh toán được coi là COD; tích đúng cổng "thanh toán khi nhận hàng", đừng tích chuyển khoản kẻo thu tiền hai lần.
  2. Người trả phí vận chuyển — ai chịu phí ship: shop hay khách. Để Tự động thì plugin suy theo phí ship trên đơn — đơn có phí ship thì khách trả, đơn miễn phí ship thì shop trả.
  3. Bảo hiểm hàng hoá — khai giá trị hàng để được bồi thường khi thất lạc. Có ngưỡng giá trị tối thiểu mới áp dụng.

Gói hàng và cách lấy hàng

Khối Gói hàng với ô tên hàng hoá mặc định, tuỳ chọn gửi tại bưu cục và cho khách đồng kiểm
Khối Gói hàng & Lấy hàng.
  1. Tên hàng hoá mặc định — tên ghi trên vận đơn khi bạn không muốn lộ tên sản phẩm thật. Để trống thì plugin ghi tên sản phẩm trong đơn.
  2. Gửi tại bưu cục khi không có khung giờ lấy hàng — SPX không sắp được lịch lấy thì đơn chuyển sang hình thức bạn tự mang ra bưu cục, thay vì báo lỗi và không tạo được đơn.
  3. Đồng kiểm — cho khách mở kiện kiểm tra trước khi nhận. Giảm tỉ lệ bom hàng nhưng có thể phát sinh phí dịch vụ.

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

  1. Ở môi trường Test, tự đặt một đơn rồi chuyển sang trạng thái đã khai trong quy tắc.
  2. Mở đơn ra: hộp SPX Express phải hiện mã vận đơn.
  3. Kiểm dòng Kho gửi đúng kho mong muốn và Phí ước tính khớp với phí khách đã trả.
  4. Không có gì xảy ra thì mở Nhật ký xem SPX trả về lỗi gì.

Lỗi thường gặp

Tình huốngNguyên nhân và cách xử lý
Bấm đẩy đơn báo lỗi địa chỉĐịa chỉ khách không khớp dữ liệu chuẩn SPX. Đồng bộ lại dữ liệu địa chỉ ở Webhook & Đồng bộ.
Tự động không chạyQuy tắc chưa khớp trạng thái thật của đơn, hoặc đang bật Chạy nền mà cron của WordPress không chạy.
Tiền thu hộ saiTích nhầm cổng chuyển khoản vào danh sách COD. Bỏ tích đi.
Không tạo được vì thiếu khung giờ lấy hàngBật Gửi tại bưu cục khi không có khung giờ lấy hàng.
Huỷ đơn báo không huỷ đượcShipper đã lấy hàng thì phải liên hệ SPX xử lý, plugin không huỷ được nữa.

Để trạng thái tự cập nhật, sang Webhook & đồng bộ.

Hỗ trợ Zalo