POST Create Return
Tạo yêu cầu trả hàng Shop Scope yêu cầu: seller.fulfillment.basicor seller.return_refund.basic Sử dụng API này để tạo yêu cầu hậu mãi do người bán khởi tạo cho một đơn hàng thay mặt cho người mua. Các loại yêu cầu được hỗ trợ là REFUND và RETURN_AND_REFUND. Trước khi gửi yêu cầu, hãy xác nhận rằng đơn hàng đủ điều kiện cho loại hậu mãi và phương thức trả hàng đã chọn. Sau khi yêu cầu được tạo, hãy sử dụng API tìm kiếm, trạng thái hoặc xét duyệt liên quan để tiếp tục quy trình hậu mãi. Version 202602
POST/return_refund/202602/returns
Request
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 | 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 | 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 | 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. |
| idempotency_key | string | Idempotency Key |
| shop_cipher Required | string | Sử 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 |
|---|---|---|
| order_id Required | string | Tiktok Shop order id |
| skus | []object | Skus |
| order_line_item_ids | []string | Chỉ định các order line ID cần đưa vào yêu cầu trả hàng. Nếu đơn hàng đã được tách thành nhiều gói, hãy sử dụng order line ID để tạo yêu cầu trả hàng. Nếu không cung cấp cả order_line_item_ids lẫn skus, mặc định là tất cả order line trong đơn hàng. Lưu ý: Đây là trường legacy, đối với các tích hợp mới hãy dùng order_line_list thay thế. |
| return_reason Required | string | Lý do của người bán để tạo yêu cầu trả hàng |
| return_type Required | string | Loại cần tạo: - REFUND- RETURN_AND_REFUND |
| refund_total | string | Tổng số tiền hoàn lại cho người mua. Tổng số tiền hoàn lại không được vượt quá số tiền có thể hoàn |
| currency | string | Tiền tệ cho việc hoàn tiền, phải giống với tiền tệ trong TikTok Ship Order. |
| shipment_type | string | Chỉ định phương thức vận chuyển trả hàng mà người mua sử dụng để gửi hàng trả lại cho người bán trong yêu cầu trả hàng. Các giá trị được hỗ trợ:- PLATFORM- BUYER_ARRANGE |
| handover_method | string | Tùy chọn. Chỉ áp dụng khi shipment_type là PLATFORM. Chỉ định phương thức bàn giao mà người mua sử dụng để trả hàng thông qua vận chuyển được nền tảng hỗ trợ. Các giá trị được hỗ trợ:- DROP_OFF- PICKUP |
| order_line_list | []object | Chỉ định các line item cần đưa vào yêu cầu trả hàng và hỗ trợ tách đơn hàng bundle. Trong một yêu cầu, sử dụng hoặc order_line_item_id cho các order line thông thường hoặc sub_order_line_item_id cho các sub-item của bundle. Lưu ý: Trường này hoàn toàn tương thích ngược với trường order_line_items_ids trước đây. |
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 | Request log |
| data | object | Thông tin trả hàng cụ thể |
Example
JSONEnable word wrap
Error Code
Xem các mã lỗi thường gặp
| Code | Message | | --- | --- | | 25001001 | Một tham số yêu cầu không hợp lệ đã được truyền. Vui lòng kiểm tra rằng bạn có đúng (các) loại và định dạng tham số. | | 25001003 | Trạng thái đơn hàng không hợp lệ. | | 25001010 | Một yêu cầu trả hàng đã hoàn tất, hoặc đơn hàng đã bị hủy. | | 25001011 | Một yêu cầu trả hàng đang được xử lý, hoặc đơn hàng đã bị hủy. | | 25001014 | Lý do trả hàng không xác định. Vui lòng đảm bảo bạn đang truyền một lý do trả hàng hợp lệ. | | 25001015 | Lý do trả hàng được cung cấp không thể được sử dụng bởi người bán. Vui lòng chọn một lý do trả hàng hợp lệ và thử lại. | | 25001020 | Lý do trả hàng được cung cấp hiện đang offline. Vui lòng chọn một lý do trả hàng khác. | | 25001021 | Lý do không khớp với trạng thái đơn hàng | | 25001028 | reverse lock failed | | 25001042 | Tạo gói hàng trả lại thất bại do lỗi nội bộ. | | 25001046 | Yêu cầu trả hàng thất bại do bị chặn bởi kiểm soát rủi ro của TikTok. | | 25001051 | Không được phép trả hàng hoặc hủy vì đơn hàng đã hoàn tất hoặc đã bị hủy | | 25005005 | Tổng số tiền hoàn lại lớn hơn số tiền có thể hoàn. | | 25005010 | Không thể hủy từng line item riêng lẻ trong yêu cầu này. | | 25005011 | (Các) line item được yêu cầu trả hàng hoặc hoàn tiền vượt quá giới hạn cho phép. | | 25020005 | Không có quyền xử lý đơn hàng này | | 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