GET Lấy các giao dịch chưa được quyết toán
Lấy các giao dịch chưa được quyết toán Shop Scope yêu cầu: seller.finance.info API này cho phép partner truy xuất danh sách các giao dịch chưa được quyết toán (bao gồm Orders & Adjustments) được tạo bởi một seller, trả về phần phân tích chi tiết phí cho một danh sách order ID và adjustment ID. Hiện tại, API này chỉ trả về các giao dịch được tạo sau 2025.01.01. Khi một giao dịch đã được quyết toán, nó sẽ không còn được trả về bởi API này nữa, vui lòng lấy từ Get Statement Transaction API. **Lưu ý rằng tất cả dữ liệu trả về qua API này là số tiền ước tính có thể thay đổi trước khi quyết toán và chỉ có thể được sử dụng để seller tham khảo, số tiền quyết toán cuối cùng cho mỗi giao dịch chỉ có thể được cung cấp qua statement related API. Phiên bản 202507
GET/finance/202507/orders/unsettled
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 các API request đế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 API request. Developer có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| page_token | string | Một token mờ được sử dụng để truy xuất trang tiếp theo của một tập kết quả phân trang. Truy xuất giá trị này từ kết quả của next_page_token từ một response trước đó. Không cần thiết cho trang đầu tiên. |
| page_size | int | Số lượng kết quả được trả về trên mỗi trang. Mặc định: 20Phạm vi hợp lệ: [1-100] |
| sort_field Required | string | Các kết quả trả về sẽ được sắp xếp theo field được chỉ định. Chỉ hỗ trợ order_create_time. |
| sort_order | string | Thứ tự sắp xếp cho tham số sort_field. Mặc định: ASC Các giá trị có thể có:- ASC: Thứ tự tăng dần- DESC: Thứ tự giảm dần |
| search_time_ge | int | Lọc các statement để chỉ hiển thị những statement được tạo vào hoặc sau ngày và giờ được chỉ định. Unix timestamp. Lưu ý:statement_time_ge và statement_time_lt cùng nhau tạo thành điều kiện lọc thời gian tạo. - Nếu statement_time_ge được điền nhưng statement_time_lt để trống, statement_time_lt sẽ mặc định là thời gian hiện tại. - Nếu statement_time_lt được điền nhưng statement_time_ge để trống, statement_time_ge sẽ mặc định là 20250101. |
| search_time_lt | int | thời gian kết thúc của phạm vi tìm kiếm |
| 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 |
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 API response. |
| message | string | Các thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Request log |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext