POST Tạo First Mile Bundle (V2)
Tạo First Mile Bundle (V2) Shop Scope yêu cầu: seller.fulfillment.basic Nếu bạn gửi nhiều kiện hàng đến kho TikTok Shop trong một first-mile bundle duy nhất, bạn có thể dùng API để tạo first-mile bundle trên TikTok Shop và nhận về bundle ID. Phiên bản 202510
POST/fulfillment/202510/first_mile_bundle
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller lấy từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng 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 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 dùng cho tất cả các yêu cầu API. Lập trình viên có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Dùng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi 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 |
|---|---|---|
| order_ids Required | []string | Các ID của tất cả đơn hàng được gửi trong một first-mile bundle duy nhất. Các đơn hàng phải tuân theo các ràng buộc:- Mỗi đơn hàng phải tồn tại và ở trạng thái RTS và đã in nhãn vận chuyển.- Các đơn hàng được gửi bởi cùng một seller.- Các đơn hàng thuộc về một nhóm khu vực dịch vụ TikTok Shop duy nhất. Các nhóm là: - Group 1: PH, SG, MY, VN, TH, và JP. - Group 2: DE, FR, IT, ES.Bạn không thể tạo first mile bundle cho các đơn hàng US/UK bằng API này. |
| handover_method Required | string | Cách bạn gửi first-mile bundle. Các giá trị liệt kê có thể có là:- PICKUP: Bạn dùng dịch vụ logistic do TikTok Shop cung cấp để gửi bundle.- DROP_OFF: Bạn liên hệ nhà cung cấp logistic và gửi bundle. Nhà cung cấp logistic phải được đăng ký tại TikTok Shop. |
| shipping_provider_id | string | ID nhà cung cấp logistic trong TikTok Shop. Bắt buộc khi handover_method == DROP_OFF. |
| tracking_number | string | Mã tracking logistic của bundle. Bắt buộc khi handover_method == DROP_OFF. |
| phone_tail_number | string | 4 chữ số cuối của số điện thoại người gửi. Bắt buộc khi handover_method == DROP_OFF. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678910111213curl-X POST 'https://open-api.tiktokglobalshop.com/fulfillment/202510/first_mile_bundle?timestamp=1623812664&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'content-type: application/json' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -d '{ "order_ids": [ "578967030217083407" ], "handover_method": "PICKUP", "shipping_provider_id": "7463353253533", "tracking_number": "SF1244442424", "phone_tail_number": "1234"}'
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
{"code":0,"data":{"first_mile_bundle_id":"BA123444534","url":"https://open-fs-va.tiktokshop.com/doc_tts/object/28b05?skipCookie=true&timeStamp=1721272360&sign=ef63cd6","errors":[{"code":10007014,"message":"invalid package id","detail":{"order_id":"578967030217083407"}}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | Trống. Không có mã lỗi logic nghiệp vụ. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext