v2.shop.get_shop_info
GET /api/v2/shop/get_shop_info
Dùng lệnh gọi này để lấy thông tin của gian hàng.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/shop/get_shop_info
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 |
Không có Tham số Yêu cầu.
Tham số Response
| Tên | Kiểu | Mẫu | Mô tả |
|---|---|---|---|
| shop_name | string | openapi_pshop_1 | Tên gian hàng. |
| region | string | TW | Khu vực gian hàng. |
| status | string | NORMAL | Trạng thái có thể áp dụng: BANNED (Bị cấm), FROZEN (Bị đóng băng), NORMAL (Bình thường). |
| sip_affi_shops | object[] | Danh sách thông tin gian hàng liên kết SIP.If you request for SIP primary shop,this field will be returned, if you request for SIP affiliate shop,this field won't be returned | |
| affi_shop_id | int64 | ID gian hàng liên kết. | |
| region | string | Affiliate Khu vực gian hàng. | |
| is_cb | boolean | true | Dùng trường này để cho biết gian hàng có phải là gian hàng xuyên biên giới hay không. |
| request_id | string | 0b8f39a76e6ada92247b416c768363ee | Mã định danh cho yêu cầu API, dùng để theo dõi lỗi. |
| auth_time | timestamp | 1610533441 | Thời gian gian hàng được ủy quyền cho đối tác. |
| expire_time | timestamp | 1642069441 | Dùng trường này để cho biết ngày hết hạn ủy quyền gian hàng. |
| is_sip | boolean | true | Trường này sẽ trả về "true" khi gian hàng chính SIP hoặc gian hàng liên kết gọi. |
| is_upgraded_cbsc | boolean | true | Dùng trường này để cho biết merchant đã được nâng cấp lên CBSC (bao gồm CNSC và KRSC) hay chưa. |
| merchant_id | int64 | 1000000400 | Shopee’s unique identifier for a merchant. If the shop won't under any merchant, then the value will be null. |
| shop_fulfillment_flag | string | PFF - 3PF Shop | Use this field to indicate the fulfillment type of current shop, the applicable values: **- Pure - FBS Shop:**Single mode, refer to Local/CB shops which only have Shopee official warehouse stock, orders are fulfilled by Shopee from Shopee official warehouse; **- Pure - 3PF Shop:**Single mode, refer to CB shops which only have local seller warehouse stock, orders are fulfilled by seller from local seller warehouse via local logistics channels; - PFF - FBS Shop: 1) Hybird mode, refer to Local shops which have both Shopee official warehouse stock and local seller warehouse stock, orders can be fulfilled by Shopee from Shopee official warehouse and can also fulfilled by seller from local seller warehouse via local logistics channels; 2) Hybrid mode, refer to CB shops which have both Shopee official warehouse stock and CB seller warehouse stock, orders can be fulfilled by Shopee from Shopee official warehouse and can also fulfilled by seller from CB seller warehouse via CB logistics channels; **- PFF - 3PF Shop:**Hybrid mode, refer to CB shops which have both local seller warehouse stock and CB seller warehouse stock, orders can be fulfilled by seller from local seller warehouse via local logistics channels and can also fulfilled by seller from CB seller warehouse via CB logistics channels; - LFF Hybrid Shop: Hybrid mode, refer to CB shops which have 3 types of stock: FBS stock (Shopee official warehouse stock), 3PF stock (CB seller own stock in the local market) and CB SLS stock (CB seller own stock in CN/HK/KR); - Others - Unknown: Returned when obtaining shop_fulfillment_flag information fails |
| is_main_shop | boolean | true | Xác định xem gian hàng hiện tại có phải là Gian hàng Nội địa được liên kết với Gian hàng Xuyên biên giới Trực tiếp hay không. |
| is_direct_shop | boolean | false | Xác định xem gian hàng hiện tại có phải là Gian hàng Xuyên biên giới Trực tiếp hay không. |
| linked_main_shop_id | int64 | 0 | Trả về ID Gian hàng Nội địa được liên kết với Gian hàng Xuyên biên giới Trực tiếp. |
| linked_direct_shop_list | object[] | Trả về danh sách Gian hàng Xuyên biên giới Trực tiếp được liên kết với Gian hàng Nội địa. | |
| direct_shop_id | int64 | 223009454 | ID Gian hàng Xuyên biên giới Trực tiếp. |
| direct_shop_region | string | SG | Khu vực Gian hàng Xuyên biên giới Trực tiếp. |
| is_one_awb | boolean | true | Use this filed to indicate if the shop is in 1-AWB whitelist. If is_one_awb return true, please use new AWB size (10cm x 15cm thermal paper) to print AWB. For more details, please refer to: https://open.shopee.com/announcements/1138?category=3&is_top=false |
| is_mart_shop | boolean | false | Cho biết gian hàng hiện tại có phải là Gian hàng Mart hay không. |
| is_outlet_shop | boolean | false | Cho biết gian hàng hiện tại có phải là Gian hàng Outlet hay không. |
| mart_shop_id | int64 | 1234567890 | (Chỉ trả về khi yêu cầu Gian hàng Outlet) Tham chiếu đến ID Gian hàng Mart mà Outlet này thuộc về. |
| outlet_shop_info_list | object[] | (Chỉ trả về khi yêu cầu Gian hàng Mart) Danh sách ID Gian hàng Outlet thuộc Gian hàng Mart này. | |
| outlet_shop_id | int64 | 1234567890 | ID Gian hàng Outlet. |