Quality engine incident reason code

Use this page when your app needs to sync Quality Engine incident reasons to TikTok Shop through the Quality Engine order data exchange API. Quality Engine uses the reason code to understand why an order reconciliation incident happened. Send one of the reason codes listed on this page, match it to the applicable rule IDs, and keep the enum value exactly as written. Codes outside the list may be rejected by Quality Engine. Last reviewed: July 6, 2026, against the Data Reconciliation OpenAPI reference and the Developer dashboard rule tables.

The reason code list on this page uses the R/A rule ID system from the Developer dashboard. It should not be mixed with the old FC-101 to FC-105 wording that remains in some dashboard notes.

The Developer dashboard table includes FC-101 to FC-105 only as legacy "Not Existing Reason" wording. These FC codes are not listed as valid reason codes on this page. Do not send FC-101 to FC-105 in issue_reason unless the API reference explicitly lists them for your app version.

Use the Quality Factory Order Data Import API to sync order data and incident reason codes.

Version note: POST /data_reconciliation/202309/orders/sync and POST /data_reconciliation/202310/orders/import use orders[].not_exist_reason. The 202401 API uses orders[].issue_reason. Use the field name from the endpoint version you call. Minimal request example:

{
  "orders": [
    {
      "order_id": "7021436810468230477",
      "channel_type": "SHOPIFY",
      "channel_order_id": "8021436810468230477",
      "channel_order_status": "OPEN",
      "channel_financial_status": "PAID",
      "channel_fulfillment_status": "FULFILLED",
      "channel_order_update_time": "1692163668",
      "issue_reason": "SELLER_TIKTOKSHOP_AUTHORIZATION_REVOKED",
      "packages": [
        {
          "package_id": "RN141567632MY",
          "shipping_provider_name": "UPS",
          "tracking_number": "LX542261779US"
        }
      ]
    }
  ]
}

channel_order_update_time is the order update timestamp on the DTC channel, not the API call time. It must be a 10-digit Unix timestamp in seconds and must be earlier than the current timestamp.

Use these codes when there is no related order in the DTC channel.

Use these codes when the order is shipped in the DTC channel but not shipped in TikTok Shop.

The current Pre-RTS list does not define an OTHER code. Do not send OTHER for Pre-RTS incidents unless a newer endpoint reference explicitly adds it. If an incident does not match any listed Pre-RTS code, confirm the expected code through the latest Quality Engine rule definition or Partner Center support.

Before syncing a reason code:

1. Confirm the incident category: Orphan Order or Pre-RTS.
2. Confirm the rule ID in the Developer dashboard: R1 / R2 / A1 for Orphan Order, or A3 / R5 / R6 for Pre-RTS.
3. Pick the most specific reason code from the corresponding table.
4. Send the code exactly as listed in orders[].issue_reason for the 202401 API.
5. Do not send FC-101 to FC-105, lower-case enum values, or codes from another category unless the endpoint reference explicitly supports them.