stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§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_cipher | query | string | Y | GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3 | Use 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-type | header | string | Y | application/json | Allowed type: application/json |
§5 Request Query Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| app_key | string | Y | 38abcd | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign | string | Y | 5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp | int | Y | 1623812664 | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| locale | string | N | en-US | The 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 | []string | N | ["LINE_ITEMS", "SKU_RETURN_REQUESTS", "RETURN_MERCHANDISE_AUTHORIZATIONS"] | Whitelist of field names to return additional data in the response. |
| Possible values: |
LINE_ITEMSSKU_RETURN_REQUESTSRETURN_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:INITPENDING_REQUEST_REVIEWREQUEST_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:REFUNDRETURN_AND_REFUNDREPLACEMENTEXCHANGE| ^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_TIMEUPDATE_TIME| ^sort_order |string |N |ASC |Sort direction. Possible values:ASCDESC| 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×tamp=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 |
|---|---|---|---|
| code | int | 0 | The success or failure status code returned in API response. |
| message | string | Success | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | 202203070749000101890810281E8C70B7 | Request log |
| data | object | Specific return information | |
| ^aftersales_requests | []object | List of aftersales (return) request data. | |
| ^^id | string | 4035318504086604101 | Unique identifier for this aftersales request. |
| ^^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. |
| ^^status | string | PENDING_REQUEST_REVIEW | Current state of this aftersales request. |
| Possible values: |
INITPENDING_REQUEST_REVIEWREQUEST_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 theseller_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:BUYERSELLEROPERATOR: 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_REFUNDSELLER_RESPOND_RETURNSELLER_RESPOND_RECEIVE_PACKAGESELLER_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 thehandover_methodfield to see which handover method the buyer is using,drop_offorpickup.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 courierPICKUP: 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_LABELQR_CODE- QR Code with BoxQR_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 |Ifis_combined_returnistrue, this field will return thecombined_return_idassociated 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:INITAWAITING_BUYER_RETURNRETURN_IN_TRANSITPENDING_PACKAGE_REVIEWPACKAGE_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 |
|---|---|
| 25001001 | An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format. |
| 25020005 | No permission to process this order |
| 25020008 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
| 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
