SPX Express (Shopee Express) cho WooCommerce
Plugin nối website WooCommerce của bạn với SPX — đơn vị vận chuyển của Shopee. Khách thấy phí ship thật lúc đặt hàng, đơn tự đẩy sang SPX theo điều kiện bạn đặt, trạng thái vận đơn tự chảy ngược về website. Trang này là lộ trình từ lúc mới cài cho tới khi chạy tự động.
Plugin làm được những gì
- Tính phí ship thật — khách chọn Tỉnh/Phường ở trang thanh toán, plugin hỏi SPX và hiện đúng số tiền cho từng dịch vụ.
- Tạo đơn tự động — đặt điều kiện theo trạng thái đơn và hình thức thanh toán, đơn thoả điều kiện là tự đẩy sang SPX, không cần bấm tay.
- In vận đơn — in phiếu giao hàng của SPX ngay trong trang đơn hàng.
- Trạng thái tự cập nhật — SPX giao xong thì đơn trên website tự chuyển sang trạng thái bạn chọn.
- Trang tra cứu cho khách — khách tự tra vận đơn trên website bạn, có mức bảo mật và email báo mã vận đơn.
- Trường địa chỉ tiếng Việt — Tỉnh/Thành → Phường/Xã chuẩn theo dữ liệu SPX.
Cần chuẩn bị gì
- Website WordPress đã cài và kích hoạt WooCommerce.
- Tài khoản tích hợp SPX — App ID, App Secret, User ID, User Secret. Liên hệ SPX để được cấp.
- Mã License plugin đã mua tại levantoan.com.
SPX cấp riêng App ID/Secret cho môi trường thử nghiệm và môi trường thật. Plugin lưu cả hai và bạn chọn dùng bộ nào. Hãy chạy Test cho tới khi tạo được vận đơn trơn tru rồi mới chuyển sang Production — đơn tạo ở Test không phát sinh chi phí và không có shipper tới lấy.
Lộ trình 9 bước
Năm bước đầu là bắt buộc, làm xong là bán hàng được. Các bước sau bật dần tuỳ nhu cầu.
Tải file zip lên và kích hoạt.
Chưa kích hoạt thì plugin không chạy.
Nhập App ID, Secret, User ID rồi bấm Test kết nối.
Nơi shipper tới lấy hàng, cũng là gốc để tính phí.
Thêm SPX vào khu vực giao hàng, rồi điều chỉnh phí, miễn phí, cân nặng.
Đặt điều kiện để đơn tự đẩy sang SPX.
Để trạng thái vận đơn tự về website.
Khách tự tra mã, đỡ một lượt hỏi han.
Nơi tìm nguyên nhân khi có gì đó không chạy.
Các tab cấu hình
Toàn bộ nằm ở WooCommerce → SPX Express, thanh tab dọc bên trái:
| Tab | Lo việc gì |
|---|---|
| Cài đặt chung | Trường địa chỉ tiếng Việt ở trang thanh toán. Đây là module dùng chung của mọi plugin vận chuyển DevVN — sửa ở đâu cũng ra cùng kết quả. |
| Kết nối API | Môi trường Test/Production và bốn mã do SPX cấp, kèm ba công cụ kiểm tra. |
| Người gửi | Kho lấy hàng và dịch vụ vận chuyển mặc định. |
| Phí vận chuyển | Thêm SPX vào khu vực giao hàng; cộng trừ phí, miễn phí, làm tròn, cân nặng mặc định, phí dự phòng. |
| Tạo đơn | Tự động tạo đơn, COD, người trả phí, bảo hiểm, gói hàng. |
| Webhook & Đồng bộ | Token webhook, ánh xạ trạng thái, đồng bộ dữ liệu địa chỉ SPX. |
| Tracking | Trang tra cứu vận đơn, bảo mật và email báo mã. |
| Nhật ký | Toàn bộ request và response trao đổi với SPX. |
| License | Mã bản quyền và kiểm tra bản cập nhật. |
Bắt đầu từ Cài đặt plugin.