Dành cho developer

Get Eligible Shipping Services — API TikTok Shop

tiktok.fulfillment.202309.orders.order_id.shipping_services.query · 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.

Xem trong mục lục API Trang nền tảng TikTok Shop

tiktok.fulfillment.202309.orders.order_id.shipping_services.query

POST/fulfillment/202309/orders/{order_id}/shipping_services/queryGọi qua 360: POST https://partner.quantri360.com/v1/tiktok/fulfillment/202309/orders/{order_id}/shipping_services/query

Mô tả API

Tra cứu dịch vụ vận chuyển phù hợp cho một đơn.

Gọi qua /v1/tiktok/fulfillment/202309/orders/{order_id}/shipping_services/query 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 chỉ đọc; code = 0 mới là thành công.
Chỉ dùng được với đơn đủ điều kiện; kiểm message. Kể cả khi gửi trọng lượng và kích thước vẫn có thể nhận code 21001001.

Request

Địa chỉ

POST https://partner.quantri360.com/v1/tiktok/fulfillment/202309/orders/{order_id}/shipping_services/query

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer 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_id	query	string	100001	Gian 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ên	Vị trí	Kiểu	Bắt buộc	Mẫu	Mô tả
order_id	path	string	Có	100000000000000001	Mã đơn hàng.
order_line_item_ids	body	string[]	Không	["100000000000000001"]	Các mã đơn dòng mặt hàng.
weight	body	object	Không		Khối lượng.
weight.value	body	string	Có	10	Giá trị.
weight.unit	body	string	Có	GRAM	Đơn vị.
dimension	body	object	Không		Kích thước.
dimension.length	body	string	Có	10	Dài.
dimension.width	body	string	Có	10	Rộng.
dimension.height	body	string	Có	10	Cao.
dimension.unit	body	string	Có	INCH	Đơn vị.
order_line_list	body	object[]	Không		Đơn dòng danh sách.
order_line_list[].order_line_id	body	string	Không	100000000000000001	Mã dòng hàng.
order_line_list[].sub_item_id	body	string	Không	100000000000000001	Mã con mặt hàng. Bắt buộc với sản phẩm dạng gói; không bắt buộc với sản phẩm thường.

Ví dụ request

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/fulfillment/202309/orders/100000000000000001/shipping_services/query" \
  -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/fulfillment/202309/orders/100000000000000001/shipping_services/query",
    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/fulfillment/202309/orders/100000000000000001/shipping_services/query');
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/fulfillment/202309/orders/100000000000000001/shipping_services/query' . '?' . 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ên	Kiểu	Mẫu	Mô tả
code	int	0	Mã kết quả; 0 là thành công.
message	string	Success	Thông báo kết quả; khi lỗi, đọc nội dung để xử lý.
request_id	string	DEMO_REQUEST_0001	Mã truy vết yêu cầu.
data	object		Dữ liệu.
order_id	string	100000000000000001	Mã đơn hàng.
order_line_id	string[]		Mã dòng hàng.
weight	object		Khối lượng.
value	string	10	Giá trị.
unit	string	GRAM	Đơn vị.
shipping_services	object[]		Vận chuyển các dịch vụ.
id	string	100000000000000001	Mã.
name	string	Mẫu minh họa	Tên.
price	string	10000	Giá.
currency	string	VND	Mã tiền tệ.
earliest_delivery_days	int	1	Sớm nhất giao hàng ngày.
latest_delivery_days	int	1	Muộn nhất giao hàng ngày.
is_default	bool	false	Là mặc định.
shipping_provider_name	string	Mẫu minh họa	Vận chuyển đơn vị tên.
shipping_provider_id	string	100000000000000001	Mã đơn vị vận chuyển.
shipping_fee	string	10000	Vận chuyển phí.
shipping_app_service_fee	string	10000	Vận chuyển ứng dụng dịch vụ phí.
signature_fee	string	10000	Chữ ký phí.
dimension	object		Kích thước.
length	string	10	Dài.
width	string	10	Rộng.
height	string	10	Cao.
unit	string	GRAM	Đơn vị.

Mẫu phản hồi

{
  "code": 0,
  "message": "Success",
  "request_id": "DEMO_REQUEST_0001",
  "data": {
    "order_id": "100000000000000001",
    "order_line_id": [
      "100000000000000001"
    ],
    "weight": {
      "value": "10",
      "unit": "GRAM"
    },
    "shipping_services": [
      {
        "id": "100000000000000001",
        "name": "Mẫu minh họa",
        "price": "10000",
        "currency": "VND",
        "earliest_delivery_days": 1,
        "latest_delivery_days": 1,
        "is_default": false,
        "shipping_provider_name": "Mẫu minh họa",
        "shipping_provider_id": "100000000000000001",
        "shipping_fee": "10000",
        "shipping_app_service_fee": "10000",
        "signature_fee": "10000"
      }
    ],
    "dimension": {
      "length": "10",
      "width": "10",
      "height": "10",
      "unit": "CM"
    }
  }
}

Bắt đầu dùng

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