快工助手跨境电商知识与商机助手

Search Aftersales Request

TikTok Shop 官方资料 · TikTok Shop Partner Center 开发者文档 · 适合开发者

stable本次发布有变化全部展示

来自 TikTok Shop 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
TikTok Shop / profile.tiktok.docs_api
语言
en-US
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/tiktok_shopaudience/developercategory/api_doctopic/compliancetopic/developer

资料正文

§1 Path: /return_refund/202603/aftersales/search

#

§2 Method: [POST]

#

§3 Function Description

Used to search for aftersales request level data.


#

§4 Common Parameters

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

Properties Location Type Require Sample Properties description
shop_cipherquerystringYGCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response.
Get by API Get Authorization Shop
content-typeheaderstringYapplication/jsonAllowed type: application/json
#

§5 Request Query Parameters

Properties Type Require Sample Properties description
app_keystringY38abcdEvery single app will have a unique key. Please use the specific key assigned to your app.
signstringY5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8cSignature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders.
timestampintY1623812664Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time.
localestringNen-USThe BCP-47 locale codes for displaying purposes. Default: en
Refer to Locale codes for the list of supported locale codes.
#

§6 Request Body Parameters

Properties Type Require Sample Properties description
whitelisted_data_fields[]stringN["LINE_ITEMS", "SKU_RETURN_REQUESTS", "RETURN_MERCHANDISE_AUTHORIZATIONS"]Whitelist of field names to return additional data in the response.
Possible values:
  • LINE_ITEMS
  • SKU_RETURN_REQUESTS
  • RETURN_MERCHANDISE_AUTHORIZATIONS | filters |object |N | |Filters to narrow the result set. | ^aftersales_request_ids |[]string |N |["4035318504086604101"] |Restricts results to the specified aftersales requests. | ^aftersales_request_statuses |[]string |N |["PENDING_REQUEST_REVIEW"] |Restricts results to the specified aftersales request statuses. Possible values:
  • INIT
  • PENDING_REQUEST_REVIEW
  • REQUEST_REVIEW_COMPLETED | ^return_types |[]string |N |["REFUND", "RETURN_AND_REFUND"] |Restricts results to aftersales request data which includes at least one sku return request with a given type. Possible values:
  • REFUND
  • RETURN_AND_REFUND
  • REPLACEMENT
  • EXCHANGE | ^main_order_ids |[]string |N |["577686530908261117"] |Restricts results to aftersales request data which includes at least one sku return request with a given main (forward) order id. | ^buyer_ids |[]string |N |["7493996903972308733"] |Restricts results to aftersales request data which includes at least one sku return request with a given buyer id. | ^time |object |N | |Time-based filtering criteria. | ^^create_time |object |N | |Filter based on creation time. | ^^^min_unix_time_inclusive |int |N |1774486592 |Inclusive lower bound (Unix seconds). | ^^^max_unix_time_exclusive |int |N |1774486592 |Exclusive upper bound (Unix seconds). | ^^update_time |object |N | |Filter based on last update time. | ^^^min_unix_time_inclusive |int |N |1774486592 |Inclusive lower bound (Unix seconds). | ^^^max_unix_time_exclusive |int |N |1774486592 |Exclusive upper bound (Unix seconds). | sort |object |N | |Sorting criteria for the result set. | ^sort_field |string |N |create_time |Name of the field used for sorting. Possible values:
  • CREATE_TIME
  • UPDATE_TIME | ^sort_order |string |N |ASC |Sort direction. Possible values:
  • ASC
  • DESC | pagination |object |N | |Pagination configuration. | ^page_size |int |N |100 |Number of records to return per page, max 100. | ^page_token |string |N |aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA== |Identifies the page to retrieve. |
#

§7 Request Sample

Query

https://open-api.tiktokglobalshop.com/return_refund/202603/aftersales/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&locale=en-US

Body

{"whitelisted_data_fields":["LINE_ITEMS","SKU_RETURN_REQUESTS","RETURN_MERCHANDISE_AUTHORIZATIONS"],"filters":{"aftersales_request_ids":["4035318504086604101"],"aftersales_request_statuses":["PENDING_REQUEST_REVIEW"],"return_types":["REFUND","RETURN_AND_REFUND"],"main_order_ids":["577686530908261117"],"buyer_ids":["7493996903972308733"],"time":{"create_time":{"min_unix_time_inclusive":1774486592,"max_unix_time_exclusive":1774486592},"update_time":{"min_unix_time_inclusive":1774486592,"max_unix_time_exclusive":1774486592}}},"sort":{"sort_field":"create_time","sort_order":"ASC"},"pagination":{"page_size":100,"page_token":"aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA=="}}
#

§8 Response Parameters

Properties Type Sample Properties description
codeint0The success or failure status code returned in API response.
messagestringSuccessThe success or failure messages returned in API response. Reasons of failure will be described in the message.
request_idstring202203070749000101890810281E8C70B7Request log
dataobjectSpecific return information
^aftersales_requests[]objectList of aftersales (return) request data.
^^idstring4035318504086604101Unique identifier for this aftersales request.
^^line_items[]objectList of items associated with this aftersales request.
^^^return_line_item_idstring4035227657962164811Unique identifier for this item in the return. In the case of virtual bundle, this is corresponds to the id of the original parent item bundle.
^^^sub_return_line_item_idstring4035227657962164815Unique identifier for this item in the return. In the case of virtual bundle, this is corresponds to the id of the current child item being returned.
^^^sku_idstring2729382476852921560SKU identifier associated with this item (for product details).
^^^main_order_idstring577686530908261117Identifier of the associated main (forward) order.
^^^sku_return_request_idstring4035318504086604100Identifier of the associated SKU-level, sub return request.
^^statusstringPENDING_REQUEST_REVIEWCurrent state of this aftersales request.
Possible values:
  • INIT
  • PENDING_REQUEST_REVIEW
  • REQUEST_REVIEW_COMPLETED | ^^sku_return_requests |[]object | |SKU-level, sub return requests associated with this aftersales request (also known as "reverse orders" or "return requests"). | ^^^order_id |string |577686530908261117 |TikTok Shop order ID. Contains multiple order line item IDs. | ^^^return_id |string |4035318504086604100 |The identifier of a specific return. | ^^^return_type |string |REFUND |Return type. Available values:
  • REFUND: Seller will issue a refund without return. The buyer is not required to send the item(s) back to the seller.
  • RETURN_AND_REFUND: Buyer is required to send the item(s) back to the seller. The seller will need to review the condition of the returned item(s) before a refund can be issued to the buyer.
  • REPLACEMENT: The buyer requires the seller to replace the item(s).
  • EXCHANGE: The buyer requires the seller to exchange the item(s). | ^^^return_status |string |RETURN_OR_REFUND_REQUEST_PENDING |Return status. Available values:
  • RETURN_OR_REFUND_REQUEST_PENDING: Buyer has initiated a return or refund request. The request is pending review by seller or platform.
  • REFUND_OR_RETURN_REQUEST_REJECT: The return or refund request was rejected.
  • AWAITING_BUYER_SHIP: The return request was approved. The seller is waiting for the buyer to ship the approved items to the seller. If the buyer doesn't ship the items to the seller before the deadline, the platform will close the request.
  • BUYER_SHIPPED_ITEM: Buyer has shipped the approved items to seller.
  • REJECT_RECEIVE_PACKAGE: Seller inspected the returned items and rejected the return package.
  • RETURN_OR_REFUND_REQUEST_SUCCESS: The return/refund request was approved. The buyer will be refunded.
  • RETURN_OR_REFUND_REQUEST_CANCEL: The request has been cancelled by the buyer or system.
  • RETURN_OR_REFUND_REQUEST_COMPLETE: The return/refund was processed successfully. The buyer has been refunded.
  • REPLACEMENT_REQUEST_PENDING: Buyer has initiated a replacement request. The request is pending review by seller.
  • REPLACEMENT_REQUEST_REJECT: Seller reject the buyer replacement request.
  • REPLACEMENT_REQUEST_REFUND_SUCCESS: Buyer's replacement request was resolved by refund due to insufficient inventory.
  • REPLACEMENT_REQUEST_CANCEL: Buyer canceled the replacement request.
  • REPLACEMENT_REQUEST_COMPLETE: Seller has approved the buyer's replacement request, platform will generate a new order for seller to fulfill.
  • AWAITING_BUYER_RESPONSE: Seller offer another return type to the buyer, and waiting buyer response. Seller proposed return type can check the seller_proposed_return_type.
  • EXCHANGE_REQUEST_PENDING: Buyer has initiated an exchange request. The request is pending review by seller.
  • EXCHANGE_REQUEST_REFUND_SUCCESS: Buyer's exchange request was resolved by refund due to insufficient inventory.
  • EXCHANGE_REQUEST_CANCEL: Buyer canceled the exchange request.
  • EXCHANGE_REQUEST_COMPLETE: Seller has approved the buyer's exchange request, platform will generate a new order for seller to fulfill. | ^^^arbitration_status |string |IN_PROGRESS |List of arbitration statuses. Available values:
  • IN_PROGRESS: The TikTok Shop platform operator is processing arbitration. Platform may request additional information from the seller.
  • SUPPORT_BUYER: The platform operator supports buyer.
  • SUPPORT_SELLER: The platform operator supports seller.
  • CLOSED: Arbitration is closed | ^^^role |string |BUYER |Return initiation role. Available values:
  • BUYER
  • SELLER
  • OPERATOR : TikTok Shop platform operator.
  • SYSTEM: TikTok Shop system. Please see "API overview" to learn more about roles. | ^^^return_reason |string |ecom_order_to_ship_canceled_reason_created_by_mistakes |Reason for return. | ^^^return_reason_text |string |Order created by mistake |Reason for return, in localized text. You can change language using the locale request parameter. | ^^^seller_next_action_response |[]object | |Seller's next action and deadline. | ^^^^action |string |SELLER_RESPOND_REFUND |Seller's next action. Available values:
  • SELLER_RESPOND_REFUND
  • SELLER_RESPOND_RETURN
  • SELLER_RESPOND_RECEIVE_PACKAGE
  • SELLER_RESPOND_REPLACEMENT | ^^^^deadline |int |1690554680 |Indicates the deadline for when seller must perform the next action. | ^^^shipment_type |string |PLATFORM |The shipment method the buyer selected to send the item(s) back to seller Available values:
  • PLATFORM: Buyer will use TikTok Shop's shipping service to send the items back to seller. Use the handover_method field to see which handover method the buyer is using, drop_off or pickup.
  • BUYER_ARRANGE: Buyer will arrange shipment to send the item(s) back to seller. | ^^^handover_method |string |DROP_OFF |The handover method buyer chooses to use when returning item(s) to seller using platform's shipping service.
  • DROP_OFF: buyer will drop off the item(s) at courier
  • PICKUP: buyer is scheduling a pick up service offered by the courier. | ^^^return_tracking_number |string |213456789098765433456 |The tracking number of parcels when buyer returns the item(s). | ^^^return_provider_name |string |J&T Express |The provider name of parcel when buyer returns the item(s). | ^^^return_provider_id |string |TH27014E9R5Q4G |The provider ID of parcel when buyer returns the items. | ^^^pre_return_id |string |4035310341095393452 |The previous return ID the current return order is edited from. | ^^^next_return_id |string |4035310341095393463 |The next return ID the current return order is edited to. | ^^^refund_amount |object | |Refund amount details. | ^^^^currency |string |USD |Payment currency. | ^^^^refund_total |string |1.23 |Total refund amount to buyer. | ^^^^refund_subtotal |string |1 |Subtotal refund amount to buyer. | ^^^^refund_shipping_fee |string |0.2 |Shipping fee refund amount to buyer. | ^^^^refund_tax |string |0.03 |Tax refund amount to buyer. | ^^^^retail_delivery_fee |string |0.1 |Retail delivery fee takes effect once platform GMV exceeds 500,000 USD, according to US Colorado states' compliance rules. | ^^^^buyer_service_fee |string |0.1 |Buyer service fee. | ^^^return_line_items |[]object | |Return order lines items. | ^^^^return_line_item_id |string |4035227657962164811 |Return order line ID. | ^^^^order_line_item_id |string |576473917261451851 |Order line ID. | ^^^^sku_id |string |2729382476852921560 |SKU ID. | ^^^^sku_name |string |1#, Standard |SKU name. | ^^^^product_image |object | |Product image information. | ^^^^^url |string |https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447 |Product image URL. | ^^^^^width |int |200 |Product image width. Units: pixels (px). | ^^^^^height |int |200 |Product image height. Units: pixels (px). | ^^^^product_name |string |(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs |Product name. | ^^^^seller_sku |string |PUTIH 1 TALI |SKU name defined by seller. | ^^^^refund_amount |object | |Refund amount details. | ^^^^^currency |string |USD |Payment currency. | ^^^^^refund_total |string |1.23 |Total refund amount to buyer. | ^^^^^refund_subtotal |string |1 |Subtotal refund amount to buyer. | ^^^^^refund_shipping_fee |string |0.2 |Shipping fee refund amount to buyer. | ^^^^^refund_tax |string |0.03 |Tax refund amount to buyer. | ^^^^^retail_delivery_fee |string |0.1 |Retail delivery fee takes effect once platform GMV exceeds 500,000 USD, according to US Colorado states' compliance rules. | ^^^^^buyer_service_fee |string |0.1 |Buyer service fee. | ^^^^return_sub_line_items |[]object | |Return sub order lines items. Sub items represent skus that belong to a "virtual bundle" that has been defined by a seller. The sub_items will include all relevant information about each item that is a part of the virtual bundle. | ^^^^^return_sub_line_item_id |string |4035227657962164812 |Return sub order line ID. | ^^^^^return_line_item_id |string |4035227657962164811 |Return order line ID. | ^^^^^sub_order_line_item_id |string |576473917261451852 |Sub order line ID. | ^^^^^order_line_item_id |string |576473917261451851 |Order line ID. | ^^^^^sku_id |string |2729382476852921560 |SKU ID. | ^^^^^sku_name |string |1#, Standard |SKU name. | ^^^^^product_image |object | |Product image information. | ^^^^^^url |string |https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447 |Product image URL. | ^^^^^^width |int |200 |Product image width. Units: pixels (px). | ^^^^^^height |int |200 |Product image height. Units: pixels (px). | ^^^^^product_name |string |(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs |Product name. | ^^^^^seller_sku |string |PUTIH 1 TALI |SKU name defined by seller. | ^^^^^refund_amount |object | |Refund amount details. | ^^^^^^currency |string |USD |Payment currency. | ^^^^^^refund_total |string |1.23 |Total refund amount to buyer. | ^^^^^^refund_subtotal |string |1 |Subtotal refund amount to buyer. | ^^^^^^refund_shipping_fee |string |0.2 |Shipping fee refund amount to buyer. | ^^^^^^refund_tax |string |0.03 |Tax refund amount to buyer. | ^^^^^^retail_delivery_fee |string |0.1 |Retail delivery fee takes effect once platform GMV exceeds 500,000 USD, according to US Colorado states' compliance rules. | ^^^^^^buyer_service_fee |string |0.1 |Buyer service fee. | ^^^create_time |int |1690451136 |Return create time. Unix timestamp. | ^^^update_time |int |1690453136 |Return update time. Unix timestamp. | ^^^discount |object | |Discount refund details. | ^^^^product_platform_discount |string |0.1 |The refund amount of platform discount. | ^^^^product_seller_discount |string |0.1 |The refund amount of product seller discount. | ^^^^shipping_fee_platform_discount |string |0.1 |The refund amount of shipping fee platform discount. | ^^^^shipping_fee_seller_discount |string |0.1 |The refund amount of shipping fee seller discount. | ^^^shipping_fee |object | |The return shipping fee details. | ^^^^seller_paid_return_shipping_fee_amount |string |0.1 |The amount of return shipping fee seller paid. | ^^^^buyer_paid_return_shipping_fee_amount |string |0.1 |The amount of return shipping fee buyer paid. | ^^^^platform_paid_return_shipping_fee_amount |string |0.1 |The amount of return shipping fee platform paid. | ^^^buyer_keep_item |bool |false |Whether buyer can keep the item(s) in a return or replacement process. | ^^^return_shipping_document_type |string |SHIPPING_LABEL |The type of return shipping document selected by the buyer. Available values:
  • SHIPPING_LABEL
  • QR_CODE - QR Code with Box
  • QR_CODE_NBNL - QR Code with No Box No Label | ^^^return_method |string |SELLER_ARRANGE |Return method:
  • SELLER_SHIPPED: Seller offers the return shipping service.
  • BUYER_SHIPPED: Buyer offers the return shipping service.
  • PLATFORM_SHIPPED: TikTok Shop offers the return shipping service. | ^^^is_combined_return |bool |false |This field will return true if the buyer is asking to combine multiple returns into one return package. | ^^^combined_return_id |string |4035309948547073951 |If is_combined_return is true, this field will return the combined_return_id associated with the combined return. | ^^^seller_proposed_return_type |string |PARTIAL_REFUND |Seller proposed return type:
  • PARTIAL_REFUND | ^^^partial_refund_amount |object | |Partial refund details. | ^^^^partial_refund_total |string |10 |The partial refund amount offered by seller. Note: only seller proposed partial refund will return this field. | ^^^^currency |string |IDR |Partial refund currency | ^^^buyer_rejected_partial_refund |bool |true |Only return this field when seller initiated the partial refund. Available values:
  • TRUE: Buyer reject the seller partial refund offer.
  • FALSE: Buyer accept the seller partial refund offer or awaiting buyer response. | ^^^return_warehouse_address |object | |The return warehouse address details provided by the seller. | ^^^^full_address |string |1199 Coleman Ave San Jose, CA 95110 |The full return warehouse address. | ^^^exchange_order_lines |[]object | |Ignore this field. It is not yet supported. | ^^^^order_line_id |string |0 |Ignore this field. It is not yet supported. | ^^^^sku_id |string |0 |Ignore this field. It is not yet supported. | ^^^^sku_name |string |0 |Ignore this field. It is not yet supported. | ^^^^product_name |string |0 |Ignore this field. It is not yet supported. | ^^^^seller_sku_name |string |0 |Ignore this field. It is not yet supported. | ^^^^product_image |object | |Ignore this field. It is not yet supported. | ^^^^^url |string |0 |Ignore this field. It is not yet supported. | ^^^^^width |int |0 |Ignore this field. It is not yet supported. | ^^^^^height |int |0 |Ignore this field. It is not yet supported. | ^^^^price_detail |object | |Ignore this field. It is not yet supported. | ^^^^^currency |string |0 |Ignore this field. It is not yet supported. | ^^^^^refund_total |string |0 |Ignore this field. It is not yet supported. | ^^^^^refund_subtotal |string |0 |Ignore this field. It is not yet supported. | ^^^^^refund_shipping_fee |string |0 |Ignore this field. It is not yet supported. | ^^^^^refund_tax |string |0 |Ignore this field. It is not yet supported. | ^^^reshipment_order_id |string |0 |Ignore this field. It is not yet supported. | ^^^is_quick_refund |bool |false |If the return hit the quick refund strategy, the seller cannot reject the received package | ^^^return_sub_line_items |[]object | |Return sub order lines items. Sub items represent skus that belong to a "virtual bundle" that has been defined by a seller. The sub_items will include all relevant information about each item that is a part of the virtual bundle. | ^^^^return_sub_line_item_id |string |4035227657962164812 |Return sub order line ID. | ^^^^return_line_item_id |string |4035227657962164811 |Return order line ID. | ^^^^sub_order_line_item_id |string |576473917261451852 |Sub order line ID. | ^^^^order_line_item_id |string |576473917261451851 |Order line ID. | ^^^^sku_id |string |2729382476852921560 |SKU ID. | ^^^^sku_name |string |1#, Standard |SKU name. | ^^^^product_image |object | |Product image information. | ^^^^^url |string |https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447 |Product image URL. | ^^^^^width |int |200 |Product image width. Units: pixels (px). | ^^^^^height |int |200 |Product image height. Units: pixels (px). | ^^^^product_name |string |(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs |Product name. | ^^^^seller_sku |string |PUTIH 1 TALI |SKU name defined by seller. | ^^^^refund_amount |object | |Refund amount details. | ^^^^^currency |string |USD |Payment currency. | ^^^^^refund_total |string |1.23 |Total refund amount to buyer. | ^^^^^refund_subtotal |string |1 |Subtotal refund amount to buyer. | ^^^^^refund_shipping_fee |string |0.2 |Shipping fee refund amount to buyer. | ^^^^^refund_tax |string |0.03 |Tax refund amount to buyer. | ^^^^^retail_delivery_fee |string |0.1 |Retail delivery fee takes effect once platform GMV exceeds 500,000 USD, according to US Colorado states' compliance rules. | ^^^^^buyer_service_fee |string |0.1 |Buyer service fee. | ^^return_merchandise_authorizations |[]object | |Associated RMA (return package) records. | ^^^id |string |2894521704838895640 |Unique identifier for this RMA data. | ^^^package_id |string |2894521704838895645 |Identifier of the associated physical return package. | ^^^aftersales_request_id |string |4035318504086604101 |Identifier of the parent aftersales request. | ^^^status |string |AWAITING_BUYER_RETURN |The current state of this RMA data. Possible values:
  • INIT
  • AWAITING_BUYER_RETURN
  • RETURN_IN_TRANSIT
  • PENDING_PACKAGE_REVIEW
  • PACKAGE_REVIEW_COMPLETED | ^^^line_items |[]object | |List of items associated with this aftersales request. | ^^^^return_line_item_id |string |4035227657962164811 |Unique identifier for this item in the return. In the case of virtual bundle, this is corresponds to the id of the original parent item bundle. | ^^^^sub_return_line_item_id |string |4035227657962164815 |Unique identifier for this item in the return. In the case of virtual bundle, this is corresponds to the id of the current child item being returned. | ^^^^sku_id |string |2729382476852921560 |SKU identifier associated with this item (for product details). | ^^^^main_order_id |string |577686530908261117 |Identifier of the associated main (forward) order. | ^^^^sku_return_request_id |string |4035318504086604100 |Identifier of the associated SKU-level, sub return request. | ^total_count |int |12345 |The total result set size, independent of pagination. | ^next_page_token |string |aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA== |Used to fetch the next page/set of results. |
#

§9 Response Sample

{"code":0,"data":{"aftersales_requests":[{"id":"4035318504086604101","line_items":[{"return_line_item_id":"4035227657962164811","sub_return_line_item_id":"4035227657962164815","sku_id":"2729382476852921560","main_order_id":"577686530908261117","sku_return_request_id":"4035318504086604100"}],"status":"PENDING_REQUEST_REVIEW","sku_return_requests":[{"order_id":"577686530908261117","return_id":"4035318504086604100","return_type":"REFUND","return_status":"RETURN_OR_REFUND_REQUEST_PENDING","arbitration_status":"IN_PROGRESS","role":"BUYER","return_reason":"ecom_order_to_ship_canceled_reason_created_by_mistakes","return_reason_text":"Order created by mistake","seller_next_action_response":[{"action":"SELLER_RESPOND_REFUND","deadline":1690554680}],"shipment_type":"PLATFORM","handover_method":"DROP_OFF","return_tracking_number":"213456789098765433456","return_provider_name":"J\u0026T Express","return_provider_id":"TH27014E9R5Q4G","pre_return_id":"4035310341095393452","next_return_id":"4035310341095393463","refund_amount":{"currency":"USD","refund_total":"1.23","refund_subtotal":"1","refund_shipping_fee":"0.2","refund_tax":"0.03","retail_delivery_fee":"0.1","buyer_service_fee":"0.1"},"return_line_items":[{"return_line_item_id":"4035227657962164811","order_line_item_id":"576473917261451851","sku_id":"2729382476852921560","sku_name":"1#, Standard","product_image":{"url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447","width":200,"height":200},"product_name":"(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs","seller_sku":"PUTIH 1 TALI","refund_amount":{"currency":"USD","refund_total":"1.23","refund_subtotal":"1","refund_shipping_fee":"0.2","refund_tax":"0.03","retail_delivery_fee":"0.1","buyer_service_fee":"0.1"},"return_sub_line_items":[{"return_sub_line_item_id":"4035227657962164812","return_line_item_id":"4035227657962164811","sub_order_line_item_id":"576473917261451852","order_line_item_id":"576473917261451851","sku_id":"2729382476852921560","sku_name":"1#, Standard","product_image":{"url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447","width":200,"height":200},"product_name":"(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs","seller_sku":"PUTIH 1 TALI","refund_amount":{"currency":"USD","refund_total":"1.23","refund_subtotal":"1","refund_shipping_fee":"0.2","refund_tax":"0.03","retail_delivery_fee":"0.1","buyer_service_fee":"0.1"}}]}],"create_time":1690451136,"update_time":1690453136,"discount":{"product_platform_discount":"0.1","product_seller_discount":"0.1","shipping_fee_platform_discount":"0.1","shipping_fee_seller_discount":"0.1"},"shipping_fee":{"seller_paid_return_shipping_fee_amount":"0.1","buyer_paid_return_shipping_fee_amount":"0.1","platform_paid_return_shipping_fee_amount":"0.1"},"buyer_keep_item":false,"return_shipping_document_type":"SHIPPING_LABEL","return_method":"SELLER_ARRANGE","is_combined_return":false,"combined_return_id":"4035309948547073951","seller_proposed_return_type":"PARTIAL_REFUND","partial_refund_amount":{"partial_refund_total":"10","currency":"IDR"},"buyer_rejected_partial_refund":true,"return_warehouse_address":{"full_address":"1199 Coleman Ave San Jose, CA 95110"},"exchange_order_lines":[{"order_line_id":"0","sku_id":"0","sku_name":"0","product_name":"0","seller_sku_name":"0","product_image":{"url":"0","width":0,"height":0},"price_detail":{"currency":"0","refund_total":"0","refund_subtotal":"0","refund_shipping_fee":"0","refund_tax":"0"}}],"reshipment_order_id":"0","is_quick_refund":false,"return_sub_line_items":[{"return_sub_line_item_id":"4035227657962164812","return_line_item_id":"4035227657962164811","sub_order_line_item_id":"576473917261451852","order_line_item_id":"576473917261451851","sku_id":"2729382476852921560","sku_name":"1#, Standard","product_image":{"url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/004797ebfd8c4d3da2df1cc4bfdb0614~tplv-o3syd03w52-origin-jpeg.jpeg?from=4246405447","width":200,"height":200},"product_name":"(SP) [PROMO BUNDLING] NICE Tissue Facial 180s x 5 pcs","seller_sku":"PUTIH 1 TALI","refund_amount":{"currency":"USD","refund_total":"1.23","refund_subtotal":"1","refund_shipping_fee":"0.2","refund_tax":"0.03","retail_delivery_fee":"0.1","buyer_service_fee":"0.1"}}]}],"return_merchandise_authorizations":[{"id":"2894521704838895640","package_id":"2894521704838895645","aftersales_request_id":"4035318504086604101","status":"AWAITING_BUYER_RETURN","line_items":[{"return_line_item_id":"4035227657962164811","sub_return_line_item_id":"4035227657962164815","sku_id":"2729382476852921560","main_order_id":"577686530908261117","sku_return_request_id":"4035318504086604100"}]}]}],"total_count":12345,"next_page_token":"aDU2dHIzMlFhME5CUzJKUDhDdVJhTDM1WmJkeFVTVW9LTkRaSnNaZCtuWjJXVU5CSDhlaA=="},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
#

§10 Error Code

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code

Code Message
25001001An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format.
25020005No permission to process this order
25020008Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support.
36009003Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support.
#