POST Tải Lên Chứng Từ Vận Chuyển Và Thông Tin Theo Dõi
Tải Lên Chứng Từ Vận Chuyển Và Thông Tin Theo Dõi Shop Required scope: Sử dụng API này để tải lên chứng từ vận chuyển trả hàng, mã theo dõi và đơn vị vận chuyển cho người mua.
Version 202405
POST/return_refund/202405/returns/shipping_documents
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: multipart/form-data |
| 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 đều 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 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. |
| return_ids Required | []string | Định danh của một lần trả hàng cụ thể. |
| return_id_type | string | Chỉ định loại ID nào đã được truyền vào trường return_ids liên quan. (Nếu loại id không được chỉ định, giá trị mặc định sẽ là SKU_RETURN_ORDER.)Possible values:- RMA- SKU_RETURN_ORDER |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Nếu 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 qua API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| return_shipping_label | file | Nhãn vận chuyển trả hàng. |
| return_qr_code | file | Mã QR trả hàng. |
| tracking_number Required | string | Mã theo dõi vận chuyển trả hàng do người bán cung cấp cho người mua. |
| return_provider_id Required | string | ID đơn vị vận chuyển trả hàng do người bán cung cấp cho người mua. |
Example
CurlGoNode.jsJavaEnable word wrap
12345678curl-X POST 'https://open-api.tiktokglobalshop.com/return_refund/202405/returns/shipping_documents?app_key=38abcd&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1623812664&shop_cipher=GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3&return_ids=4035309948547270559&return_id_type=RMA' -H 'x-tts-access-token: TTP_pwSm2AAAAABmmtFz1xlyKMnwg74T2GJ5s0uQbS8jPjb_GkdFVCxPqzQXSyuyfXdQa0AqyDsea2tYFNVf4XeqgZHFfPyv0Vs659QqyLYfsGzanZ5XZAin3_ZkcIxxS0_In6u6XDeU96k' -H 'content-type: multipart/form-data' -F 'return_qr_code=@"file"' -F 'return_shipping_label=' -F 'tracking_number=TTHERMES2882481596119090868' -F 'return_provider_id=6599541761693270018'
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 | Nhật ký yêu cầu |
| data | object | Thông tin trả hàng cụ thể |
Example
JSONEnable word wrap
{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
Error Code
View common error codes
| Code | Message | | --- | --- | | 25021022 | Đơn trả hàng đã tải lên chứng từ vận chuyển. Vui lòng không tải lên lại. | | 25021023 | Lỗi định dạng chứng từ trả hàng. Vui lòng kiểm tra định dạng chứng từ, chỉ có thể tải lên file PDF. | | 25023001 | Return IDs không hợp lệ. | | 25023002 | Return ID không thuộc về người bán này. Vui lòng không tải lên lại. | | 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. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext