POST Create First Mile Bundle
Tạo First Mile Bundle Seller 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à lấy bundle ID. Phiên bản 202407
POST/fulfillment/202407/bundles
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 các yêu cầu API tới 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 trên tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi sang giờ địa phương. |
Body
| Properties | Type | Description |
|---|---|---|
| order_ids Required | []string | ID của tất cả cá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, ở 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 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ị enum 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 | Số 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/202407/bundles?timestamp=1623812664&app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -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 thông báo. |
| 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 phổ biến
| 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