v2.sbs.get_stock_movement

GET /api/v2/sbs/get_stock_movement

Get Seller Center，Stock Movement page data

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/sbs/get_stock_movement

Tham số chung

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi 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 mọi 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. 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 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

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. If empty, the default value 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. If empty, the default value is 10. The value should be between 1 and 20.
start_time	string	True	2025-02-01	Start date in YYYY-MM-DD format. Only data within the past 1 year can be queried, and the time range must not exceed 90 days.
end_time	string	True	2025-02-24	End date in YYYY-MM-DD format. Only data within the past 1 year can be queried, and the time range must not exceed 90 days.
whs_ids	string	False	IDL,IDG	Multiple warehouse_id values should be separated by commas.
category_id_l1	int64	False	100002	L1-level category_id. You need to call the get_category API to retrieve the first-level category_id.
sku_id	string	False	900626944_15359986
item_id	string	False	900626944
item_name	string	False		Product Name Filter
variation	string	False
whs_region	string	True	CN	Warehouse Region. Enum values: BR, CN, ID, MY, MX, TH, TW, PH, VN, SG If do not pass, will get error "block by gateway due to invalid cid"

Tham số Response

Tên	Kiểu	Mẫu	Mô tả
error	string		Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
message	string		Indicate error details if hit error. Empty if no error happened.
request_id	string		Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
response	object		Detail informations you are querying.
total	int32	3
start_time	string	2025-02-01
end_time	string	2025-02-24
query_end_time	string	2025-02-24
item_list	object[]		Data list of item sku
warehouse_item_id	string	900626944	Warehouse item id; To indicate an unique item in a warehouse one warehouse item id can match with multiple shop_item_id
item_name	string	跨境商品测试00002 - 1666171567	item name
item_image	string	http://img.ws.mms.shopee.sg/08b3fc410c8eaa7e3f52b06b486a8658	item image
sku_list	object[]		Data list of mtsku
mtsku_id	string	900626944_15359986	mtsku id
model_id	string	15359986	model sku id
variation	string	Orange,Large
fulfill_mapping_mode	int32	0	0-Null；1-Bundle SKU；2-Parent SKU
barcode	string	11fsfsf
whs_list	object[]		Info of whs
whs_id	string	CNN	Whs id
start_on_hand_total	int64	50	Total warehouse inventory at the start time
inbound_total	int64	0	Inbound quantity to the warehouse during the selected time period.
outbound_total	int64	0	Outbound quantity from the warehouse during the selected time period
adjust_total	int64	0	Inventory adjustment quantity in the warehouse during the selected time period
end_on_hand_total	int64	50	Total warehouse inventory at the end time.
start_qty	object		Inventory information at the start time.
start_on_hand_total	int64	50	sku number at the start time
start_sellable	int64	47	Number of sellable SKUs at the start time
start_reserved	int64	3	Number of reserved SKUs at the start time.
start_unsellable	int64	0
end_qty	object
end_on_hand_total	int64	50	Total inventory at the end time.
end_sellable	int64	47
end_reserved	int64	3
end_unsellable	int64	0
inbound_qty	object		Inbound information during the selected time period
inbound_total	int64	0	Total inbound quantity during the selected time period
inbound_my	int64	0	Total merchant procurement quantity during the selected time period.
inbound_returned	int64	0	Total number of SKUs returned by buyers and received into the warehouse during the selected time period.
outbound_qty	object
outbound_total	int64	0	Total outbound quantity during the selected time period.
outbound_sold	int64	0	"Total sold quantity during the selected time period."
outbound_returned	int64	0	Total merchant return quantity during the selected time period.
outbound_disposed	int64	0	Total disposal quantity during the selected time period.
adjust_qty	object		"SKU change information during the selected time period."
adjust_total	int64	0	"Total number of SKU changes during the selected time period."
adjust_lost_found	int64	0	"Total quantity of lost or recovered items during the selected time period."
adjust_trans_whs	int64	0	Total quantity of transfer orders created by the warehouse during the selected time period
shop_sku_list	object[]
shop_sku_id	string		shop level sku_id shop_sku_id="item_id" _ "model_id"
shop_item_id	string		shop_item_id="item_id" in Product Module
shop_model_id	string		shop_model_id= item level model_id

Không có ví dụ yêu cầu.