Skip to main content

Quality engine incident reason code

For developers who have integrated with Quality Engine, when there are some incidents, developers need to sync incident reason by reason code of the list. It can help the system to identify risk order and A-LOC order with higher accuracy and then we can provide more efficient suggestions for sellers/developers to resolve the issues. And it also is very helpful to improve our system performance.

To sync reason code, developers need:

  1. Syncing enumeration of reason code on the list via Quality Engine data exchanging API.
  2. Using codes on the list, any codes out of the list will be forbidden to sync by Quality Engine.
  3. Using correct code, developers need to pay attention to the description of code and sync the most reasonable code for the specific incident.
  4. Using the code which is suitable for the rule, every reason code has its suitable rules, developers need to follow the mapping relationship on the list.

Reason Code List:

  1. Reason codes for incident that there is no related order in DTC channel. (Orphan order)
Reason CategorySuitable for RulesReason CodeOrphan Reason Desc
Orphan OrderR1/R2/A1SELLER_TIKTOKSHOP_AUTHORIZATION_REVOKEDSeller revoked TikTok shop authorization for the App
Orphan OrderR1/R2/A1SELLER_UNINSTALLED_DTC_APPSeller uninstalled the App from the Channel platform
Orphan OrderR1/R2/A1SELLER_NOT_GRANT_DTC_PERMISSIONSeller did not grant corresponding APIs permission of the Channel platform for App
Orphan OrderR1/R2/A1SELLER_DTC_STORE_UNAVAILABLESeller's Channel store is unavailable
Orphan OrderR1/R2/A1SELLER_TIKTOKSHOP_STORE_INACTIVESeller's TikTok shop store is inactive
Orphan OrderR1/R2/A1SELLER_DTC_NO_SKUNo corresponding SKU found for seller's Channel products
Orphan OrderR1/R2/A1SELLER_DTC_ABNORMAL_PRODUCT_STATUSAbnormal product status on seller's Channel platform
Orphan OrderR1/R2/A1SELLER_DTC_PRODUCT_OUT_OF_STOCKProducts on seller's Channel platform are out of stock
Orphan OrderR1/R2/A1SELLER_TIKTOKSHOP_ORDER_AMOUNT_ZEROOrder amount in seller's TikTok shop orders is 0
Orphan OrderR1/R2/A1SELLER_APP_OWE_FEESeller used the App but did not renew or out of quota
Orphan OrderR1/R2/A1SELLER_ABANDON_SYNC_TIKTOKSHOP_ORDERSeller opted not to synchronize TikTok shop orders
Orphan OrderR1/R2/A1APP_MISSED_WEBHOOKApp missed TikTok shop order webhooks
Orphan OrderR1/R2/A1APP_ORDER_RETRIEVE_API_FAILEDApp failed to retrieve orders by calling TikTok shop API
Orphan OrderR1/R2/A1APP_ORDER_RETRIEVE_API_NOT_MATCH_DTC_FIELDThe order information retrieved by the App through the TikTok shop API is incomplete
Orphan OrderR1/R2/A1APP_CALL_DTC_CREATE_ORDER_API_FAILEDApp failed to create orders by calling Channel API
Orphan OrderR1/R2/A1OTHEROther
  1. Reason code for incident that order is shipped in DTC channel but not shipped in TikTok Shop.
Reason CategorySuitable for RulesReason CodePre-RTS Desc
Pre-RTSA3/R5/R6INVALID_TRACKING_NUMBERInvalid Tracking Number entered in DTC:
  • tracking number has extra spaces or tabs
  • tracking number is incorrect but accepted by DTC TTS rejects this fulfillment | | Pre-RTS | A3/R5/R6 | UNSUPPORTED_CARRIER_TRACKING_NUMBER | Supported carrier by DTC but unsupported carrier in TTS TTS rejects this fulfillment | | Pre-RTS | A3/R5/R6 | ORDER_NOT_ELIGIBLE_FOR_FULFILLMENT | Package shipped in DTC but not TTS because TTS has a cancellation or refund request for that order. TTS rejects this fulfillment | | Pre-RTS | A3/R5/R6 | FULFILL_UNIT_OR_ORDER_NUMBER_NOT_COMBINED_CORRECTLY | Package or Order fulfillment call to TTS failed because the tracking number has been used in another order without combining orders. | | Pre-RTS | A3/R5/R6 | FULFILL_UNIT_OR_ORDER_NUMBER_NOT_FOUND | Package or Order fulfillment call to TTS failed because seller combined or split order in TTS or the DTC before fulfillment. TTS rejects this fulfillment | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_RATE_LIMIT | Package or Order fulfillment call to TTS failed because app rate limit was exceeded and there was no retry | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_NO_RETRY_LOGIC | order fulfillment call was made for this order from the connector app but TTS system was down and threw an internal error. Order fulfillment was not retried by the connector app | | Pre-RTS | A3/R5/R6 | FULFILLMENT_FAILURE_DUE_TO_NO_API_CALL | No order fulfillment call was made for this order from the connector |