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

POST Update Tracking

Cập nhật thông tin theo dõi Shop Scope yêu cầu: seller.fbt.info API này quản lý thông tin theo dõi ở cấp độ thùng hàng (carton) cho các đơn hàng inbound. Nó sử dụng logic upsert để tạo bản ghi theo dõi mới hoặc ghi đè các mục hiện có khi cần. Chỉ những đơn hàng đã được vận chuyển nhưng chưa được đánh dấu là "Delivered" hoặc "Received" mới có thể được cập nhật, với giới hạn 5 lần chỉnh sửa cho mỗi thùng hàng. Version 202602

POST/fbt/202602/inbound_orders/tracking_update

Request

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 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 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 gán 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 sử 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 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
order_id RequiredstringĐịnh danh dạng số của đơn hàng inbound cần cập nhật thông tin theo dõi. Lưu ý: Chỉ cung cấp dãy số; không bao gồm tiền tố "IBR" (ví dụ, dùng 123456 thay vì IBR123456).
parcel_tracking_info[]objectThông tin theo dõi kiện hàng.

Example

CurlGoNode.jsJavaEnable word wrap

1234567891011121314curl-X POST 'https://open-api.tiktokglobalshop.com/fbt/202602/inbound_orders/tracking_update?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: application/json' -d '{ "order_id": "5766071177167344427", "parcel_tracking_info": [ { "provider_name": "FEDEX", "tracking_number": "889042812410", "carton_number": "C0001" } ]}'

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

{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

Error Code

Xem các mã lỗi phổ biến

| Code | Message | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu vấn đề 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. | | 39001002 | Yêu cầu hoặc tham số yêu cầu trống. Vui lòng kiểm tra lại các tham số đầu vào. | | 39015007 | Truy cập bị từ chối. API yêu cầu người bán phải được liên kết với đúng một merchant. | | 39015009 | SellerId đầu vào không hợp lệ | | 39015010 | Không tìm thấy đơn hàng inbound nào cho merchant. | | 39015015 | Danh sách thông tin theo dõi kiện hàng trống. | | 39015016 | Nhà cung cấp theo dõi không hợp lệ hoặc không được hỗ trợ. | | 39015017 | Số thùng hàng không hợp lệ hoặc bị thiếu. | | 39015018 | Cập nhật thông tin theo dõi cho đơn hàng inbound thất bại. Vui lòng kiểm tra rằng đơn hàng inbound đang ở trạng thái "Shipped" và thử lại. Nếu vấn đề vẫn tiếp diễn và nguyên nhân không rõ, vui lòng liên hệ bộ phận hỗ trợ nền tảng. | | 39015019 | Số theo dõi (tracking number) không hợp lệ hoặc bị thiếu. |

Nội dung này có hữu ích không?Hữu ích

Không hữu ích

PreviousNext