v2.ams.get_validation_list

GET /api/v2/ams/get_validation_list

Retrieve the seller's AMS validation bill

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/ams/get_validation_list

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được gán 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 để chỉ định thời gian 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 truy cập API, dùng để xác định quyền của bạn đối với API. Có thể sử 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 cửa 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

No Request Parameters Set.

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string	error_auth	Loại lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
message	string	Invalid access_token	Chi tiết lỗi nếu có lỗi xảy ra. Trống nếu không có lỗi.
request_id	string	b937c04e554847789cbf3fe33a0ad5f1	Mã định danh của yêu cầu API dùng để theo dõi lỗi.
response	object
validation_list	object[]
validation_id	string	363636002508	Mã định danh duy nhất of the billing entry.
payment_method	int32	1	Payment method. Các giá trị áp dụng: 1 = Online 2 = Offline
validation_month	int32	202508	Billing month in the format YYYYMM (e.g., 202405).
campaign_source	string	ShopeeManaged	Source of campaign setup. Các giá trị áp dụng: ShopeeManaged Seller
online_bill	object		Billing details when payment method is Online.
total_amount	float	300.0	Total commission amount for the billing month.
bill_status	int32	2	Billing Status. Các giá trị áp dụng: 1 = Pending 2 = Completed 3 = In process 4 = To pay via payment link 5 = Manual completed 6 = To Be Settled Offline
deducted_amount	float	300.0	Commission amount already deducted.
ams_credit_deducted_amount	float	200.0	Commission amount paid using AMS Credits
pending_amount	int64	0	Commission amount pending deduction.
offline_bills	object[]		Danh sách billing details when payment method is Offline, grouped by order placement month.
order_place_month	int32	202507	Order placement month in the format YYYYMM.
total_amount	float	420.5	Total commission amount = commission_amount_after_tax + ams_credit_deducted_amount.
commission_amount	float	200.0	Offline commission amount before tax.
commission_amount_after_tax	float	220.0	Offline commission amount including tax.
ams_credit_deducted_amount	float	200.5	Commission amount already paid using AMS Credits.

Unirest.setTimeouts(0, 0); HttpResponse<String> response = Unirest.get("https://partner.shopeemobile.com/api/v2/ams/get\_validation\_list?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp") .asString();<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://partner.shopeemobile.com/api/v2/ams/get\_validation\_list?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => array( 'Content-Type: application/json' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; curl --location --request GET 'https://partner.shopeemobile.com/api/v2/ams/get\_validation\_list?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp' import requests url = "https://partner.shopeemobile.com/api/v2/ams/get\_validation\_list?access\_token=access\_token&partner\_id=partner\_id&shop\_id=shop\_id&sign=sign&timestamp=timestamp" payload={} headers = { } response = requests.RPCRequest("GET",url,headers=headers, data=payload, allow_redirects=False) print(response.text)

, "offline_bills": [ { "order_place_month": 202507, "total_amount": 420.5, "commission_amount": 200, "commission_amount_after_tax": 220, "ams_credit_deducted_amount": 200.5 } ] } ] } }