Mã lý do sự cố của Quality Engine
Đối với các nhà phát triển đã tích hợp với Quality Engine, khi xảy ra một số sự cố, nhà phát triển cần đồng bộ lý do sự cố theo mã lý do trong danh sách. Việc này giúp hệ thống nhận diện đơn hàng rủi ro và đơn hàng A-LOC với độ chính xác cao hơn, từ đó chúng tôi có thể đưa ra các gợi ý hiệu quả hơn cho người bán/nhà phát triển để giải quyết vấn đề. Đồng thời điều này cũng rất hữu ích trong việc cải thiện hiệu năng hệ thống của chúng tôi.
Để đồng bộ mã lý do, nhà phát triển cần:
- Đồng bộ tập giá trị (enumeration) của mã lý do trong danh sách thông qua Quality Engine data exchanging API.
- Sử dụng các mã trong danh sách; bất kỳ mã nào nằm ngoài danh sách đều sẽ bị Quality Engine cấm đồng bộ.
- Sử dụng đúng mã; nhà phát triển cần chú ý đến phần mô tả của mã và đồng bộ mã hợp lý nhất cho từng sự cố cụ thể.
- Sử dụng mã phù hợp với quy tắc (rule); mỗi mã lý do có các quy tắc phù hợp riêng, nhà phát triển cần tuân theo mối quan hệ ánh xạ trong danh sách.
Danh sách mã lý do:
- Mã lý do cho sự cố không có đơn hàng tương ứng trong kênh DTC. (Đơn hàng mồ côi - Orphan order)
| Reason Category | Suitable for Rules | Reason Code | Orphan Reason Desc |
|---|---|---|---|
| Orphan Order | R1/R2/A1 | SELLER_TIKTOKSHOP_AUTHORIZATION_REVOKED | Người bán đã thu hồi ủy quyền TikTok shop cho App |
| Orphan Order | R1/R2/A1 | SELLER_UNINSTALLED_DTC_APP | Người bán đã gỡ cài đặt App khỏi nền tảng Channel |
| Orphan Order | R1/R2/A1 | SELLER_NOT_GRANT_DTC_PERMISSION | Người bán chưa cấp quyền API tương ứng của nền tảng Channel cho App |
| Orphan Order | R1/R2/A1 | SELLER_DTC_STORE_UNAVAILABLE | Cửa hàng Channel của người bán không khả dụng |
| Orphan Order | R1/R2/A1 | SELLER_TIKTOKSHOP_STORE_INACTIVE | Cửa hàng TikTok shop của người bán không hoạt động |
| Orphan Order | R1/R2/A1 | SELLER_DTC_NO_SKU | Không tìm thấy SKU tương ứng cho sản phẩm Channel của người bán |
| Orphan Order | R1/R2/A1 | SELLER_DTC_ABNORMAL_PRODUCT_STATUS | Trạng thái sản phẩm bất thường trên nền tảng Channel của người bán |
| Orphan Order | R1/R2/A1 | SELLER_DTC_PRODUCT_OUT_OF_STOCK | Sản phẩm trên nền tảng Channel của người bán đã hết hàng |
| Orphan Order | R1/R2/A1 | SELLER_TIKTOKSHOP_ORDER_AMOUNT_ZERO | Số tiền đơn hàng trong đơn TikTok shop của người bán bằng 0 |
| Orphan Order | R1/R2/A1 | SELLER_APP_OWE_FEE | Người bán đã sử dụng App nhưng không gia hạn hoặc đã hết hạn mức (quota) |
| Orphan Order | R1/R2/A1 | SELLER_ABANDON_SYNC_TIKTOKSHOP_ORDER | Người bán chọn không đồng bộ đơn hàng TikTok shop |
| Orphan Order | R1/R2/A1 | APP_MISSED_WEBHOOK | App đã bỏ lỡ webhook đơn hàng TikTok shop |
| Orphan Order | R1/R2/A1 | APP_ORDER_RETRIEVE_API_FAILED | App không lấy được đơn hàng khi gọi TikTok shop API |
| Orphan Order | R1/R2/A1 | APP_ORDER_RETRIEVE_API_NOT_MATCH_DTC_FIELD | Thông tin đơn hàng mà App lấy được qua TikTok shop API không đầy đủ |
| Orphan Order | R1/R2/A1 | APP_CALL_DTC_CREATE_ORDER_API_FAILED | App không tạo được đơn hàng khi gọi Channel API |
| Orphan Order | R1/R2/A1 | OTHER | Khác |
- Mã lý do cho sự cố đơn hàng đã được giao trong kênh DTC nhưng chưa được giao trong TikTok Shop.
| Reason Category | Suitable for Rules | Reason Code | Pre-RTS Desc |
|---|---|---|---|
| Pre-RTS | A3/R5/R6 | INVALID_TRACKING_NUMBER | Tracking Number không hợp lệ được nhập trong DTC: |
- tracking number có thêm khoảng trắng hoặc tab thừa
- tracking number không chính xác nhưng vẫn được DTC chấp nhận TTS từ chối lần fulfillment này | | Pre-RTS | A3/R5/R6 | UNSUPPORTED_CARRIER_TRACKING_NUMBER | Đơn vị vận chuyển được DTC hỗ trợ nhưng không được TTS hỗ trợ TTS từ chối lần fulfillment này | | Pre-RTS | A3/R5/R6 | ORDER_NOT_ELIGIBLE_FOR_FULFILLMENT | Kiện hàng được giao trong DTC nhưng không trong TTS vì TTS có yêu cầu hủy hoặc hoàn tiền cho đơn hàng đó. TTS từ chối lần fulfillment này | | Pre-RTS | A3/R5/R6 | FULFILL_UNIT_OR_ORDER_NUMBER_NOT_COMBINED_CORRECTLY | Lệnh gọi fulfillment kiện hàng hoặc đơn hàng tới TTS thất bại vì tracking number đã được dùng trong một đơn hàng khác mà không gộp đơn hàng. | | Pre-RTS | A3/R5/R6 | FULFILL_UNIT_OR_ORDER_NUMBER_NOT_FOUND | Lệnh gọi fulfillment kiện hàng hoặc đơn hàng tới TTS thất bại vì người bán đã gộp hoặc tách đơn hàng trong TTS hoặc DTC trước khi fulfillment. TTS từ chối lần fulfillment này | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_RATE_LIMIT | Lệnh gọi fulfillment kiện hàng hoặc đơn hàng tới TTS thất bại vì đã vượt quá rate limit của app và không có cơ chế thử lại (retry) | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_NO_RETRY_LOGIC | Lệnh gọi fulfillment đơn hàng đã được thực hiện cho đơn này từ connector app nhưng hệ thống TTS bị ngừng hoạt động và trả về lỗi nội bộ. Lệnh fulfillment đơn hàng không được connector app thử lại | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_NO_API_CALL | Không có lệnh gọi fulfillment đơn hàng nào được thực hiện cho đơn này từ connector |