POST Calculate Refund
Tính toán hoàn tiền Shop Scope bắt buộc: seller.return_refund.basic Sử dụng API này để ước tính số tiền có thể hoàn cho yêu cầu hủy, hoàn tiền, hoặc trả hàng và hoàn tiền. Ước tính phụ thuộc vào request_type, reason_name đã chọn và các mặt hàng được nhắm tới. Đối với các trường hợp trả hàng và hoàn tiền, ước tính cũng có thể phụ thuộc vào phương thức vận chuyển trả hàng đã chọn. Phiên bản 202602
POST/return_refund/202602/refunds/calculate
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 seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
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 tới TTS, bạn phải ký chúng để TTS có thể nhận dạng người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng trên tất cả các yêu cầu API. Nhà phát triển có thể chuyển đổi giá trị này sang giờ địa phương. |
| 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ề response 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. |
| request_type Required | string | Loại yêu cầu- CANCEL- REFUND- RETURN_AND_REFUNDLưu ý: các loại yêu cầu khác nhau được dùng cho các tình huống hậu mãi khác nhau. Ngoài ra, các loại yêu cầu khác nhau có thể có số tiền hoàn khác nhau, vì chính sách tính số tiền hoàn là khác nhau. |
| shipment_type | string | Cách người mua gửi mặt hàng cho người bán trong một yêu cầu trả hàng, có thể là:- PLATFORM- BUYER_ARRANGE |
| handover_method | string | Phương thức bàn giao mà người mua chọn sử dụng khi trả hàng cho người bán qua nền tảng- DROP_OFF: người mua gửi gói hàng tại điểm thu nhận của dịch vụ logistics.- PICKUP: dịch vụ logistics đến lấy gói hàng của người mua. |
| reason_name Required | string | Lý do của người bán để tạo một yêu cầu trả hàng. Sử dụng endpoint Get Aftersale Eligibility để lấy các lý do hiện có, và gửi tên lý do được trả về trong trường này. |
| order_line_item_ids | []string | TikTok Shop order line item ids. |
| skus | []object | skus |
| order_line_list | []object | Tham số mới này hoàn toàn tương thích ngược với trường order_line_items_ids trước đó và ngoài ra hỗ trợ tách đơn hàng bundle, sử dụng các sub item tương ứ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 response của API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong response của 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
View common error codes
| Code | Message | | --- | --- | | 25001001 | An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format. | | 25007006 | Order not found. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext