POST Reject Return
Từ chối yêu cầu trả hàng Shop Scope bắt buộc: seller.return_refund.basic Sử dụng API này để từ chối yêu cầu trả hàng hoặc hoàn tiền của người mua. Quyết định hợp lệ phụ thuộc vào loại và trạng thái hiện tại của yêu cầu. Trước khi gọi API này, hãy đảm bảo yêu cầu vẫn đang chờ hành động của người bán phù hợp với quyết định bạn gửi. Version 202309
POST/return_refund/202309/returns/{return_id}/reject
Request
Path
| Properties | Type | Description |
|---|---|---|
| return_id Required | string | Mã định danh duy nhất của yêu cầu trả hàng sẽ bị người bán từ chối. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho 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 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 đế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 trên 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. |
| idempotency_key | string | Idempotency key là một giá trị duy nhất được tạo bởi client mà server sử dụng để nhận diện cùng một yêu cầu. Cách bạn tạo các key duy nhất tùy thuộc vào bạn, nhưng chúng tôi khuyên dùng UUID, hoặc một chuỗi ngẫu nhiên khác có đủ entropy để tránh trùng lặp. Idempotency key có thể dài tối đa 255 ký tự. |
| 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 |
|---|---|---|
| decision Required | string | Quyết định của người bán cho yêu cầu, các giá trị khả dụng:- REJECT_REFUND: người bán từ chối yêu cầu chỉ hoàn tiền- REJECT_RETURN: người bán từ chối yêu cầu trả-hàng-và-hoàn-tiền ban đầu- REJECT_RECEIVED_PACKAGE: người bán từ chối yêu cầu trả-hàng-và-hoàn-tiền sau khi người mua đã gửi hoặc bàn giao món hàng.- REJECT_REPLACEMENT: người bán từ chối yêu cầu đổi hàng |
| reject_reason Required | string | Lý do của người bán khi từ chối yêu cầu sau bán hàng. Sử dụng endpoint Get Decision Eligibility để lấy các tùy chọn từ chối hiện đang khả dụng cho cùng yêu cầu, và gửi tên lý do từ chối được trả về trong trường này. Lưu ý: Các quyết định và lý do từ chối khả dụng có thể thay đổi tùy theo trạng thái hiện tại của yêu cầu, vì vậy hãy lấy lại eligibility trước khi gọi API này. |
| comment | string | Bình luận của người bán về quyết định từ chối. Đây là nơi người bán cung cấp thêm thông tin về việc từ chối yêu cầu. |
| images | []object | Danh sách hình ảnh do người bán cung cấp để hỗ trợ cho quyết định từ chối yêu cầu trả hà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 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
Error Code
View common error codes
| Code | Message | | --- | --- | | 11050001 | invalid param | | 25001001 | An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format. | | 25001003 | Invalid order status. | | 25001014 | Unknown return reason. Please ensure you are passing a valid return reason. | | 25001016 | reverse reason not match action type | | 25001020 | The provided return reason is currently offline. Please select a different return reason. | | 25001028 | reverse lock failed | | 25001057 | reverse reason not match reason type | | 25001058 | reverse downstream data load error | | 25007002 | db access error | | 25007006 | Order not found. | | 25011010 | request has been transferred to platform operator | | 25011023 | forbid process authentic guarantee order | | 25011025 | Quick refund forbid reject receive. | | 25011026 | forbid process receive for FBT order | | 25011035 | could not reject parcel now | | 25020004 | decision not match reverse type | | 25020005 | No permission to process this order | | 25020008 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 25020010 | Aftersales has been approved and cannot be rejected. | | 25020011 | return already received | | 25020012 | status can't reject receive |
Is this content helpful?Helpful
Not Helpful
PreviousNext