VI | EN
Nhắn Messenger
Dành cho developer

Review Aftersales Requests — API TikTok Shop

tiktok.return_refund.202609.aftersales.review · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

tiktok.return_refund.202609.aftersales.review

POST/return_refund/202609/aftersales/reviewGọi qua 360: POST https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review
Endpoint ghi — thay đổi dữ liệu trên TikTok Shop. Key phải được tạo với tick "Cho phép gọi API ghi", nếu không sẽ nhận 403 write_not_allowed. Mỗi lần gọi được ghi nhật ký.
Mô tả API

Xét duyệt các yêu cầu hậu mãi.

  • Gọi qua /v1/tiktok/return_refund/202609/aftersales/review với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn app_key, shop_cipher, sign và access_token.
  • API GHI: thay đổi dữ liệu thật trên TikTok Shop; cần key có quyền ghi (can_write) và gói mở module Đơn hàng. Xét duyệt các yêu cầu hậu mãi.
  • HTTP 200 vẫn có thể có lỗi nghiệp vụ; kiểm code trước khi dùng kết quả.
  • Quyết định áp dụng riêng cho từng dòng; số tiền hoàn một phần cũng tính cho từng dòng. Các dòng cùng SKU phải nằm trong cùng đối tượng quyết định. Lấy lý do từ GET /return_refund/202606/review_decision cho cùng yêu cầu trước khi xét duyệt.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
aftersales_request_decisionsbodyobject[]KhôngHậu mãi yêu cầu các quyết định.
aftersales_request_decisions[].request_idbodystringCóDEMO_REQUEST_0001Mã truy vết yêu cầu.
aftersales_request_decisions[].request_id_typebodystringKhôngAFTERSALESYêu cầu mã loại. Giá trị / trường liên quan: AFTERSALES, RMA.
aftersales_request_decisions[].line_item_decisionsbodyobject[]CóDòng mặt hàng các quyết định.
aftersales_request_decisions[].line_item_decisions[].line_itemsbodyobject[]CóCác dòng hàng.
aftersales_request_decisions[].line_item_decisions[].line_items[].return_line_item_idbodystringCó100000000000000001Mã trả hàng dòng mặt hàng.
aftersales_request_decisions[].line_item_decisions[].line_items[].sub_return_line_item_idbodystringKhông100000000000000001Mã con trả hàng dòng mặt hàng.
aftersales_request_decisions[].line_item_decisions[].actionbodystringCóAPPROVE_REQUESTHành động. Giá trị / trường liên quan: APPROVE_REQUEST, APPROVE_RETURN_PACKAGE, REJECT_REQUEST, REJECT_RETURN_PACKAGE, REFUND_INSTEAD, OFFER_PARTIAL_REFUND, OFFER_PARTIAL_REFUND_AFTER_RECEIVING_PKG.
aftersales_request_decisions[].line_item_decisions[].alternative_solution_detailsbodyobjectKhôngThay thế giải pháp chi tiết.
aftersales_request_decisions[].line_item_decisions[].alternative_solution_details.partial_refund_amountbodystringKhông10000Một phần hoàn tiền số tiền.
aftersales_request_decisions[].line_item_decisions[].alternative_solution_details.currencybodystringKhôngVNDMã tiền tệ.
aftersales_request_decisions[].line_item_decisions[].reasonbodyobjectKhôngLý do.
aftersales_request_decisions[].line_item_decisions[].reason.reason_idbodystringKhông100000000000000001Mã lý do.
aftersales_request_decisions[].line_item_decisions[].reason.textbodystringKhôngminh-hoaNội dung.
aftersales_request_decisions[].line_item_decisions[].reason.mediabodyobjectKhôngTệp đa phương tiện.
aftersales_request_decisions[].line_item_decisions[].reason.media.uribodystringKhôngminh-hoaUri.
aftersales_request_decisions[].line_item_decisions[].reason.media.mime_typebodystringKhôngimage/pngMime loại.
aftersales_request_decisions[].action_unix_timebodyintKhông1792650000Hành động unix thời gian. Mốc Unix giây.
aftersales_request_decisions[].idempotency_keybodystringKhôngdemo-yeu-cau-0001Khóa chống xử lý lặp do bên gọi tạo; dùng lại cùng khóa khi thử lại cùng yêu cầu. Tối đa 255 ký tự.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review",
    params={},
    json={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({}),
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok/return_refund/202609/aftersales/review' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của TikTok Shop)

TênKiểuMẫuMô tả
codeint0Mã kết quả; 0 là thành công.
messagestringSuccessThông báo kết quả; khi lỗi, đọc nội dung để xử lý.
request_idstringDEMO_REQUEST_0001Mã truy vết yêu cầu.
dataobjectDữ liệu.
errorsobject[]Các lỗi.
codestring0Mã kết quả; 0 là thành công.
messagestringSuccessThông báo kết quả; khi lỗi, đọc nội dung để xử lý.

Mẫu phản hồi

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_REQUEST_0001",
  "data": {
    "errors": []
  }
}

Mã lỗi của TikTok Shop (2)

Bấm để xem
MãÝ nghĩa
ReverseOrderExistNegotiate25011010 request has been transferred to platform operator 25011012 reverse status cannot approve application 25011013 reverse status cannot approve receive 25011023 forbid process authentic guarantee order 25011026 forbid process receive for FBT order 25011032
ReverseInvalidStatusPartialRefund25020004 decision not match reverse type 25020005 No permission to process this order 25020008 Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. 25020009 reverse already cancelled

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Đơn hàng ở trang nền tảng
  3. Tạo API key (tick kênh TikTok Shop)
  4. Gọi theo ví dụ ở trên