POST Split Orders
Tách đơn hàng Shop Scope yêu cầu: seller.fulfillment.package.write Sử dụng API này để xác nhận việc tách đơn hàng. Lưu ý rằng
các cấp độ tách được hỗ trợ khác nhau tùy theo khu vực
:
- Một số khu vực hỗ trợ
tách ở cấp mặt hàng
(tách từng đơn vị riêng lẻ của cùng một SKU).
- Một số khu vực khác chỉ hỗ trợ
tách toàn bộ đơn vị
(tách các SKU khác nhau thành các gói riêng biệt).
Dưới đây là hai ví dụ về các cách tách được hỗ trợ:
Trường hợp 1: tách toàn bộ đơn vị
, áp dụng cho các đơn hàng ở BR, SEA, MX (người bán trong nước) Tách một đơn hàng của người mua gồm SKU A với số lượng 2 và SKU B với số lượng 1 thành hai gói riêng biệt:
Package 1
: tất cả các đơn vị của SKU A
- Package 2
: tất cả các đơn vị của SKU B
Trường hợp 2: tách ở cấp mặt hàng
, áp dụng cho các đơn hàng ở EU, JP, MX (người bán toàn cầu), UK, US Tách cùng nội dung đơn hàng đó thành ba gói riêng lẻ:
Package 1
: 1 đơn vị của SKU A
Package 2
: 1 đơn vị của SKU A
- Package 3
: 1 đơn vị của SKU B Version 202309
POST/fulfillment/202309/orders/{order_id}/split
Request
Path
| Properties | Type | Description |
|---|---|---|
| order_id Required | string | ID đơn hàng TikTok Shop. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền giá trị chính xác khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| splittable_groups Required | []object | Danh sách đầu vào của các nhóm có thể tách. |
| splittable_groups_v2 | []object | Tham số mới này hoàn toàn tương thích ngược với trường splittable groups trước đó và ngoài ra còn hỗ trợ tách đơn hàng dạng bundle, hãy sử dụng các sub items tương ứng |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu sự cố vẫn tiếp diễn sau nhiều lần thử, vui lòng liên hệ bộ phận hỗ trợ nền tảng. | | 21011005 | Tham số không hợp lệ. Vui lòng đảm bảo bạn đang truyền đúng (các) tham số yêu cầu. | | 21011035 | không cho phép tách đơn hàng |
Is this content helpful?Helpful
Not Helpful
PreviousNext