POST Update Shipping Info
Cập nhật thông tin vận chuyển Shop Scope bắt buộc: seller.logistics Nếu người bán nhập sai mã vận đơn, API này cho phép người bán cập nhật mã vận đơn và đơn vị vận chuyển cho đơn hàng đã được giao đi.
- API này chỉ áp dụng cho các đơn hàng (hoặc kiện hàng) được giao bởi người bán.
- Nó chỉ được dùng để cập nhật mã vận đơn và đơn vị vận chuyển cho các kiện hàng đã được giao đi.
- Đối với các đơn hàng đã được tách để giao, vui lòng dùng Update Package Shipping Info API
.
Xin lưu ý rằng TikTok Shop chỉ cho phép người bán cập nhật thông tin vận chuyển trong vòng 72 giờ sau khi giao đi. Version 202309
POST/fulfillment/202309/orders/{order_id}/shipping_info/update
Request
Path
| Properties | Type | Description |
|---|---|---|
| order_id Required | string | ID đơn hàng TikTok Shop. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại đượ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 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. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Dùng property 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 |
|---|---|---|
| tracking_number Required | string | Mã vận đơn do đơn vị vận chuyển cung cấp. |
| shipping_provider_id Required | string | Xác định đơn vị vận chuyển sẽ giao kiện hàng. Vui lòng gọi Get Shipping Providers API để lấy (các) đơn vị vận chuyển khả dụ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 | | --- | --- | | 10007002 | Đơn hàng hiện tại không phải là đơn hàng blind box của người bán. | | 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. | | 21011001 | Không tìm thấy kiện hàng. Nếu lỗi vẫn tiếp diễn, vui lòng liên hệ nền tảng để được hỗ trợ. | | 21011004 | API này không thể được dùng để cập nhật thông tin vận chuyển kiện hàng cho các kiện hàng không được giao bởi người bán. | | 21011007 | Mục trong kiện hàng có yêu cầu hậu mãi, vui lòng xử lý yêu cầu hậu mãi trước. | | 21011022 | Mã vận đơn hoặc provider ID không hợp lệ. Vui lòng kiểm tra lại và thử lại. | | 21011028 | Kiện hàng không thuộc về shop hiện tại. | | 21011030 | Kiện hàng đã được giao thành công. Nếu bạn vẫn muốn cập nhật mã vận đơn, vui lòng liên hệ nền tảng để được hỗ trợ. | | 21011041 | Không thể hoàn tất thao tác khi đơn hàng đã bị hủy. | | 21011042 | Không thể hoàn tất thao tác khi đơn hàng đã bị hủy. | | 21011043 | Kiện hàng chưa được giao đi. | | 21011049 | Do giới hạn quy tắc của nền tảng, bạn không thể cập nhật mã vận đơn. | | 25001010 | Một yêu cầu trả hàng đã được hoàn tất, hoặc đơn hàng đã bị hủy. |
Is this content helpful?Helpful
Not Helpful
PreviousNext