Giải đáp thắc mắc

Kiểm theo thứ tự này, gần như luôn ra nguyên nhân:

1. Đã thêm phương thức SPX vào khu vực giao hàng của WooCommerce chưa, và công tắc cột Bật đã bật chưa — xem hướng dẫn từng bước kèm ảnh. Đây là điểm khác với GHTK, GHN, VNPost, ViettelPost, SuperShip: mấy plugin đó không cần bước này, SPX thì bắt buộc.
2. Đã đồng bộ dữ liệu địa chỉ SPX chưa — chưa đồng bộ thì ô Tỉnh/Phường trống và không tính được phí.
3. Bấm Test kết nối ở tab Kết nối API xem có thành công không.
4. Ô Phí dự phòng khi API lỗi có để trống không — để trống thì khi API lỗi khách không thấy phương thức nào cả.

Kết quả tính phí đang được nhớ tạm. Giảm ô Cache (giây) ở tab Phí vận chuyển hoặc chờ hết hạn. Nếu vẫn y nguyên thì khu vực giao hàng đang dùng phương thức Đồng giá chứ không phải SPX.

Cân nặng khai trên website nhỏ hơn cân nặng thật, SPX cân lại rồi tính đúng. Khai cân nặng cho từng sản phẩm thay vì dựa vào ô Cân nặng mặc định — ô đó chỉ là lưới an toàn.

SPX chỉ phục vụ hoả tốc ở một số tuyến. Khách ở vùng không hỗ trợ thì dịch vụ này không hiện — đây là giới hạn của hãng, plugin không can thiệp được.

Địa chỉ khách hoặc địa chỉ kho không khớp bộ dữ liệu chuẩn của SPX. Vào Webhook & Đồng bộ bấm Đồng bộ ngay, rồi mở Nhật ký xem response nhắc tới địa chỉ người gửi hay người nhận để biết sửa chỗ nào.

Quy tắc chưa khớp trạng thái thật của đơn — kiểm lại cặp Trạng thái và Hình thức thanh toán ở tab Tạo đơn. Nếu đang bật Chạy nền thì còn phụ thuộc cron của WordPress; website ít khách thì cron chạy thưa, hãy đặt cron thật ở hosting.

Danh sách cổng thanh toán tính là COD đang tích nhầm cổng chuyển khoản. Vào tab Tạo đơn bỏ tích, chỉ để lại cổng thanh toán khi nhận hàng.

SPX không sắp được lịch lấy cho khu vực đó vào thời điểm đó. Bật Gửi tại bưu cục khi không có khung giờ lấy hàng ở tab Tạo đơn — đơn vẫn tạo được, bạn tự mang hàng ra bưu cục SPX.

Chuyển Môi trường sang Test ở tab Kết nối API và dùng bộ mã Test do SPX cấp. Đơn tạo ra không có thật, không tốn phí, không có shipper tới lấy. Tập xong nhớ chuyển lại Production.

Chưa đăng ký webhook thì trạng thái không tự về — phải bấm Cập nhật TT trong từng đơn. Đăng ký một lần là xong chuyện này mãi mãi, xem Webhook & đồng bộ.

Đã đăng ký rồi mà vẫn không đổi thì kiểm bảng Map trạng thái: dòng 4001 — Đã giao hàng phải được đặt là Đã hoàn thành.

Bạn không tự bật được, phải nhờ SPX. Chép đường dẫn ở khối Webhook nhận trạng thái (nhớ bấm Lưu cấu hình trước) rồi gửi cho nhân viên SPX phụ trách shop.

Không. SPX phải gọi vào được website từ Internet. Trên máy local hay tên miền chưa trỏ ra ngoài thì webhook không bao giờ tới — dùng nút Cập nhật TT trong từng đơn để thử.

Chưa đồng bộ dữ liệu địa chỉ chuẩn SPX. Vào Webhook & Đồng bộ bấm Đồng bộ ngay. Đây là nguyên nhân số một của gần như mọi trục trặc sau khi mới cài.

Thường là nhầm bộ mã: mã Test dùng cho Production hoặc ngược lại. Hai môi trường có bộ mã hoàn toàn khác nhau.

Cũng nhớ bấm Lưu cấu hình trước khi bấm kiểm tra — ba nút kiểm tra dùng mã đã lưu trong cơ sở dữ liệu, không phải mã bạn vừa gõ.

Dùng nút Tạo tài khoản (user_id/secret) ở khối Công cụ kiểm tra trong tab Kết nối API — plugin sinh cặp còn lại từ App ID/App Secret.

Được. Các plugin vận chuyển DevVN được thiết kế để cài chung trên một website, khách sẽ thấy phí của từng hãng ở trang thanh toán và tự chọn.

Phần trang thanh toán là module dùng chung, nên tab Cài đặt chung chỉ có một bộ cấu hình duy nhất — mở từ trang cài đặt của plugin nào cũng ra đúng những lựa chọn đó.

Đồng bộ lại dữ liệu địa chỉ để danh sách khớp với bộ SPX đang dùng. Sau đó kiểm lại địa chỉ kho gửi hàng xem còn chọn đúng Tỉnh/Phường không.