Chuyển tới nội dung chính

POST Cập nhật thông tin vận chuyển gói hàng

Cập nhật thông tin vận chuyển gói hàng Shop Scope bắt buộc: seller.fulfillment.basic 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 gói hàng đã được giao đi. Lưu ý: API này chỉ áp dụng cho các đơn hàng (hoặc gói 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 gói hàng đã được giao đi. Version 202309

POST/fulfillment/202309/packages/{package_id}/shipping_info/update

Request

Path

PropertiesTypeDescription
package_id RequiredstringID gói hàng TikTok Shop.

Header

PropertiesTypeDescription
content-type RequiredstringLoại được phép: application/json
x-tts-access-token RequiredstringGiá 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

PropertiesTypeDescription
app_key RequiredstringMỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được cấp cho app của bạn.
sign RequiredstringChữ 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 RequiredintUnix timestamp GMT (UTC+00:00). Timestamp này được dùng trong 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.
shop_cipher RequiredstringSử 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

PropertiesTypeDescription
tracking_number RequiredstringMã vận đơn do đơn vị vận chuyển cung cấp.
shipping_provider_id RequiredstringXác định đơn vị vận chuyển sẽ giao gói 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

PropertiesTypeDescription
codeintMã trạng thái thành công hoặc thất bại được trả về trong phản hồi API.
messagestringThô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_idstringLog yêu cầu
dataobjectThô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 gói 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 gói hàng cho các gói hàng không được giao bởi người bán. | | 21011007 | Mặt hàng trong gói hàng có yêu cầu sau bán, vui lòng xử lý yêu cầu sau bán trước. | | 21011022 | Mã vận đơn hoặc ID đơn vị vận chuyển không hợp lệ. Vui lòng kiểm tra lại và thử lại. | | 21011028 | Gói hàng không thuộc về shop hiện tại. | | 21011030 | Gói 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ợ. | | 21011042 | Không thể hoàn tất thao tác khi đơn hàng đã bị hủy. | | 21011043 | Gói 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. | | 21011050 | Mã vận đơn chỉ có thể được cập nhật trong một số giờ nhất định. | | 21011051 | Mã vận đơn chỉ có thể được cập nhật một lần. | | 21011052 | Mã vận đơn chỉ có thể được cập nhật một số lần giới hạ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