v2.account_health.get_penalty_point_history
GET /api/v2/account_health/get_penalty_point_history
Lấy hồ sơ điểm phạt được tạo ra trong quý hiện tại.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/account_health/get_penalty_point_history
Tham số chung
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| partner_id | int | 1 | ID đối tác được cấp sau khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu. |
| timestamp | timestamp | 1610000000 | Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | Token dùng để truy cập API, xác định quyền của bạn đối với API. Có thể dùng nhiều lần và hết hạn sau 4 giờ. |
| shop_id | int | 600000 | Mã định danh duy nhất của Shopee cho một gian hàng. Tham số bắt buộc cho hầu hết các API. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2 |
Tham số Request
| Tên | Kiểu | Bắt buộc | Mẫu | Mô tả |
|---|---|---|---|---|
| page_no | int32 | False | 1 | Specifies the page number of data to return in the current call. Starting from 1. if data is more than one page, the page_no can be some entry to start next call. Default is 1. |
| page_size | int32 | False | 10 | Each result set is returned as a page of entries. Use the "page_size" filters to control the maximum number of entries to retrieve per page (i.e., per call), and the "page_no" to start next call. This integer value is used to specify the maximum number of entries to return in a single "page" of data. The limit of page_size if between 1 and 100. Default is 10. |
| violation_type | int64 | False | 5 | Applicable values: 5: High Late Shipment Rate 6: High Non-fulfilment Rate 7: High number of non-fulfilled orders 8: High number of late shipped orders 9: Prohibited Listings 10: Counterfeit / IP infringement 11: Spam 12: Copy/Steal images 13: Re-uploading deleted listings with no change 14: Bought counterfeit from mall 15: Counterfeit caught by Shopee 16: High percentage of pre-order listings 17: Confirmed Fraud attempts (total) 18: Confirmed Fraud attempts per week (All with vouchers only) 19: Fake return address 20: Shipping fraud/abuse 21: High No. of Non-responded Chat 22: Rude chat replies 23: Request buyer to cancel order 24: Rude reply to buyer's review 25: Violate Return/Refund policy 101: Tier Reason 3026: Misuse of Shopee’s IP 3028: Violate Shop Name Regulations 3030: Direct transactions outside of the Shopee platform 3032: Shipping empty / incomplete parcels 3034: Severe Violations on Shopee Feed 3036: Severe Violations on Shopee LIVE 3038: Misuse of Local Vendor Tag 3040: Use of misleading shop tag in listing image 3042: Counterfeit / IP Infringement test 3044: Repeat Offender - IP infringement and Counterfeit listings 3046: Violation of Live Animals Selling Policy 3048: Chat Spam 3050: High Overseas Return Refunds Rate 3052: Privacy breach in buyer's review reply 3054: Order Brushing 3056: porn image 3058: Incorrect Product Categories 3060: Extremely High Non-Fulfilment Rate 3062: Penalty of Affiliate Tiếp thị Solution (AMS) Overdue Invoice Payment 3064: Government-related listing 3066: Listing invalid gifted items 3068: High non-fulfilment rate (Next Day Delivery Orders) 3070: High Late Shipment Rate (Next Day Delivery Orders) 3072: OPFR Violation Value 3074: Direct transactions outside Shopee platform via chat 3090: Prohibited Listings-Extreme Violations 3091: Prohibited Listings-High Violations 3092: Prohibited Listings-Mid Violations 3093: Prohibited Listings-Low Violations 3094: Counterfeit Listings-Extreme Violations 3095: Counterfeit Listings-High Violations 3096: Counterfeit Listings-Mid Violations 3097: Counterfeit Listings-Low Violations 3098: Spam Listings-Extreme Violations 3099: Spam Listings-High Violations 3100: Spam Listings-Mid Violations 3101: Spam Listings-Low Violations 3145: Return/Refund Rate (Non-integrated Channel) 4130: Poor Product Quality |
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| error | string | Cho biết loại lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| message | string | Cho biết chi tiết lỗi nếu xảy ra lỗi. Rỗng nếu không có lỗi. | |
| request_id | string | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. | |
| response | object | ||
| penalty_point_list | object[] | The penalty point records generated in the current quarter. | |
| issue_time | timestamp | 1728552398 | Thời gian điểm phạt được phát hành. |
| latest_point_num | int32 | 0 | The latest penalty points issued under current penalty point record. If seller raised appeal for this penalty point record and the appeal has been approved and Shopee adjusted the penalty point, then the original_point_num returns the penalty point before the adjustment, and latest_point_num returns the penalty point after the adjustment. |
| original_point_num | int32 | 1 | The original penalty points issued under current penalty point record. If seller raised appeal for this penalty point record and the appeal has been approved and Shopee adjusted the penalty point, then the original_point_num returns the penalty point before the adjustment, and latest_point_num returns the penalty point after the adjustment. |
| reference_id | int64 | 764539404640322244 | ID tham chiếu cho hồ sơ điểm phạt này. |
| violation_type | int32 | 5 | Applicable values: 5: High Late Shipment Rate 6: High Non-fulfilment Rate 7: High number of non-fulfilled orders 8: High number of late shipped orders 9: Prohibited Listings 10: Counterfeit / IP infringement 11: Spam 12: Copy/Steal images 13: Re-uploading deleted listings with no change 14: Bought counterfeit from mall 15: Counterfeit caught by Shopee 16: High percentage of pre-order listings 17: Confirmed Fraud attempts (total) 18: Confirmed Fraud attempts per week (All with vouchers only) 19: Fake return address 20: Shipping fraud/abuse 21: High No. of Non-responded Chat 22: Rude chat replies 23: Request buyer to cancel order 24: Rude reply to buyer's review 25: Violate Return/Refund policy 101: Tier Reason 3026: Misuse of Shopee’s IP 3028: Violate Shop Name Regulations 3030: Direct transactions outside of the Shopee platform 3032: Shipping empty / incomplete parcels 3034: Severe Violations on Shopee Feed 3036: Severe Violations on Shopee LIVE 3038: Misuse of Local Vendor Tag 3040: Use of misleading shop tag in listing image 3042: Counterfeit / IP Infringement test 3044: Repeat Offender - IP infringement and Counterfeit listings 3046: Violation of Live Animals Selling Policy 3048: Chat Spam 3050: High Overseas Return Refunds Rate 3052: Privacy breach in buyer's review reply 3054: Order Brushing 3056: porn image 3058: Incorrect Product Categories 3060: Extremely High Non-Fulfilment Rate 3062: Penalty of Affiliate Tiếp thị Solution (AMS) Overdue Invoice Payment 3064: Government-related listing 3066: Listing invalid gifted items 3068: High non-fulfilment rate (Next Day Delivery Orders) 3070: High Late Shipment Rate (Next Day Delivery Orders) 3072: OPFR Violation Value 3074: Direct transactions outside Shopee platform via chat 3090: Prohibited Listings-Extreme Violations 3091: Prohibited Listings-High Violations 3092: Prohibited Listings-Mid Violations 3093: Prohibited Listings-Low Violations 3094: Counterfeit Listings-Extreme Violations 3095: Counterfeit Listings-High Violations 3096: Counterfeit Listings-Mid Violations 3097: Counterfeit Listings-Low Violations 3098: Spam Listings-Extreme Violations 3099: Spam Listings-High Violations 3100: Spam Listings-Mid Violations 3101: Spam Listings-Low Violations 3145: Return/Refund Rate (Non-integrated Channel) 4130: Poor Product Quality |
| total_count | int32 | 8 | Tổng số hồ sơ điểm phạt. |