Nhật ký API
Mọi lần plugin nói chuyện với SPX đều được ghi lại ở đây, cả câu hỏi lẫn câu trả lời. Khi có gì đó không chạy, đây là màn hình cho bạn biết SPX đã nói gì thay vì phải đoán.
Bật ghi nhật ký
Công tắc nằm ở cuối tab Kết nối API: Bật ghi nhật ký (log request/response API). Chưa bật thì tab này trống.
Đọc nhật ký
Vào WooCommerce → SPX Express → Nhật ký.
- Nhật ký — mục thứ tám trên thanh tab.
- Xoá nhật ký — dọn sạch danh sách. Nhật ký chỉ giữ một số lượng bản ghi gần nhất nên nó tự cuốn chiếu, nhưng xoá tay thì dễ đọc hơn khi đang tìm một lỗi cụ thể.
Mỗi mục gồm thời điểm, tên lệnh đã gọi và nội dung trao đổi. Cặp cần đọc là:
| Dòng | Cho biết gì |
|---|---|
| request | Dữ liệu website gửi đi. Đây là chỗ kiểm địa chỉ, cân nặng, tiền thu hộ có đúng như bạn nghĩ không. |
| response | Câu trả lời của SPX. Lỗi thì có mã lỗi và mô tả — chép nguyên đoạn này khi hỏi SPX hoặc nhờ hỗ trợ. |
Vài mã lỗi hay gặp
| Nội dung trong response | Nghĩa là gì |
|---|---|
Nhắc tới PickupAddress | Địa chỉ kho lấy hàng không hợp lệ hoặc chưa được SPX duyệt. Xem Kho gửi hàng. |
| Nhắc tới địa chỉ người nhận | Địa chỉ khách không khớp dữ liệu chuẩn SPX. Đồng bộ lại dữ liệu địa chỉ. |
| Lỗi xác thực hoặc chữ ký | Sai App ID/Secret, hoặc nhầm mã Test sang Production. Xem Kết nối API. |
| Không có khung giờ lấy hàng | SPX không sắp được lịch lấy. Bật Gửi tại bưu cục ở tab Tạo đơn. |
Làm lại đúng thao tác gây lỗi, mở tab Nhật ký, chép mục mới nhất rồi gửi kèm khi nhắn Zalo. Có nội dung response thì tìm ra nguyên nhân trong vài phút; chỉ có ảnh chụp thông báo lỗi thì phải hỏi qua lại nhiều lượt.
Nhớ che App ID và User ID nếu chúng xuất hiện trong đoạn bạn chép.
Nên bật thường trực không
Bật lúc mới cài và trong vài tuần đầu — đó là giai đoạn hay gặp trục trặc nhất. Chạy ổn rồi thì có thể tắt cho nhẹ cơ sở dữ liệu, bật lại khi cần tìm lỗi. Nhật ký không lưu vô hạn nên để bật cũng không phình to mãi.
Muốn can thiệp sâu hơn vào dữ liệu gửi đi thì xem Hook action và filter.