GET Get Statements
Get Statements Shop Scope bắt buộc: seller.finance.info Truy xuất các sao kê được tạo cho một shop và thông tin sao kê chính dựa trên khoảng thời gian được chỉ định hoặc trạng thái thanh toán của chúng. Sử dụng API này để có cái nhìn tổng quan về các sao kê hằng ngày của bạn trong một khoảng thời gian, hoặc để biết những sao kê nào đã được thanh toán hoặc chưa. Để xem chi tiết các giao dịch, tham khảo Get Statement Transactions
hoặc Get Order Statement Transactions
. Áp dụng cho người bán ở tất cả các khu vực. Chỉ có dữ liệu sau ngày 2023-07-01. Version 202309
GET/finance/202309/statements
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được 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 guide 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. |
| statement_time_lt | int | Lọc các sao kê để chỉ hiển thị những sao kê được tạo trước ngày và giờ được chỉ định. Unix timestamp.Tham khảo ghi chú trong statement_time_ge để biết thêm thông tin sử dụng. |
| payment_status | string | Lọc các sao kê dựa trên trạng thái thanh toán.Các giá trị có thể có:- PAID: Khoản thanh toán đã được chuyển cho người bán.- FAILED: Chuyển khoản thanh toán thất bại.- PROCESSING: Khoản thanh toán đang được xử lý.Mặc định: Tất cả trạng thái được trả về. |
| 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] |
| page_token | string | Một token mờ (opaque) được dùng để truy xuất trang tiếp theo của tập kết quả phân trang. Lấy giá trị này từ next_page_token trong kết quả của một response trước đó. Không cần thiết cho trang đầu tiên. |
| sort_field Required | string | Các kết quả trả về sẽ được sắp xếp theo trường được chỉ định. Chỉ hỗ trợ statement_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 |
| statement_time_ge | int | Lọc các sao kê để chỉ hiển thị những sao kê đượ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_le cùng nhau tạo thành điều kiện lọc theo 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à thời gian sớm nhất của shop.Ví dụ:Vì các sao kê được tạo hằng ngày lúc 00:00 UTC, để truy xuất các sao kê cho khoảng thời gian từ ngày 5 đến ngày 10 tháng 10, hãy cấu hình các tham số như sau:- Đặt statement_time_ge thành 00:00 ngày 6 tháng 10 hoặc bất kỳ thời điểm nào trong ngày 5 tháng 10 (trừ 00:00).- Đặt statement_time_lt thành bất kỳ thời điểm nào trong ngày 11 tháng 10 (trừ 00:00). |
| 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 để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu 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 thông báo. |
| request_id | string | Log yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 36009003 | Lỗi nội bộ. Vui lòng thử lại. Nếu vấn đề 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