来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [Important] Support Local Sellers’ Cross Border Direct Selling Mode
Dear Developers,
We are excited to announce the launch of Global Seller Center to support local sellers’ Cross Border Direct Selling initiative.
This new model allows local sellers to open Direct Cross Border Shop, sell products overseas, and manage both Local and Cross Border Shop within the new Global Seller Center.
Key Aspects of the Cross Border Direct Selling in Global Seller Center:
- Shop Management:
a. In this new model, sellers will manage their Direct Shop within the Global Seller Center.
- Product/ Listing Management:
a. The system does not allow sellers to create or modify certain product information from Direct Shop directly.
b. Once a product is created or updated in the Local Shop (Main Shop), the system will automatically synchronize these changes in the Cross Border Shop (Direct Shop).
c. A Price Recommended API will guide sellers in setting prices for Cross Border Shop.
- Order Management, Logistics, and Marketing:
a. These aspects will be managed similarly to regular Cross Border Shop, requiring sellers to handle them directly in the Direct Shop.
Detailed Updates:
- Authorization and Deauthorization:
a. The authorization and deauthorization page will display the binding relationship between Local and Cross Border Direct Shop.
b. The Cross Border Direct Shop will be labeled as "Direct".
c. Sellers can independently authorize and deauthorize both local and Cross Border Direct Shop.
d. The authorization relationships are separate.
- Shop Type Identification:
The existing v2.shop.get_shop_info API will include new fields to enable determination if a shop is operating under the Cross Border Direct Selling model.
| Name | Type | Description |
|---|---|---|
| is_main_shop | boolean | Identifies if the current shop is the Local Shop linked to a Cross Border Direct Shop. |
| is_direct_shop | boolean | Identifies if the current shop is a Cross Border Direct Shop. |
| linked_main_shop_id | int64 | Returns the Shop ID of the Local Shop linked to the Cross Border Direct Shop. |
| linked_direct_shop_list | object[] | Returns the list of Cross Border Direct Shops linked to the Local Shop. |
| > direct_shop_id | int64 | Shop ID of the Cross Border Direct Shop. |
| > direct_shop_region | string | Shop Region of the Cross Border Direct Shop. |
- Product/ Listing Management
a. The system does not allow sellers to directly create or modify certain product information in the Direct Shop.
b. Products for Cross Border Direct Shops are automatically synchronized from the Local Shop.
c. The specific API logic is as follows:
3.1 New API Introduced
-
Added v2.product.get_direct_item_list API, which allows retrieval of Cross Border Direct Shop product Item IDs using the Local Shop's product Item ID.
-
Added v2.product.get_main_item_list API, which allows retrieval of Local Shop product Item IDs using the Cross Border Direct Shop's product Item ID.
-
Added v2.product.get_direct_shop_recommended_price API, which provides recommended price for Cross Border Direct Shop products based on Local Shop product information.
3.2 Existing API Call Restrictions
| API | Allow Direct Shop to Call API or Not |
|---|---|
| v2.product.get_category | No |
| v2.product.get_attributes | Yes |
| v2.product.get_recommend_attribute | No |
| v2.product.get_brand_list | No |
| v2.product.get_item_limit | Yes |
| v2.product.get_item_list | Yes |
| v2.product.get_item_base_info | Yes |
| v2.product.get_item_extra_info | Yes |
| v2.product.add_item | No |
| v2.product.update_item | Yes (Partial Field) |
| v2.product.delete_item | No |
| v2.product.init_tier_variation | No |
| v2.product.update_tier_variation | Yes (Partial Field) |
| v2.product.get_model_list | Yes |
| v2.product.add_model | No |
| v2.product.update_model | Yes |
| v2.product.delete_model | No |
| v2.product.unlist_item | No |
| v2.product.update_price | Yes |
| v2.product.update_stock | No |
| v2.product.boost_item | Yes |
| v2.product.get_boosted_list | Yes |
| v2.product.get_item_promotion | Yes |
| v2.product.update_sip_item_price | No |
| v2.product.search_item | Yes |
| v2.product.category_recommend | No |
| v2.product.register_brand | No |
| v2.product.get_size_chart_list | Yes |
| v2.product.get_size_chart_detail | Yes |
| v2.product.get_item_violation_info | Yes |
| v2.product.get_variations | Yes |
| v2.product.get_aitem_by_pitem_id | No |
[Important] For the APIs that are allowed to be called, certain fields are restricted from being changed/updated via Cross Border Direct Shop directly. Please refer to [3.3 Product/Listing Field Management Restrictions]
3.3 Product/Listing Field Management Restrictions
We categorize product-related fields into three types:
- Fields managed only through the Local Shop:
a. These fields have no market differences, such as category and attributes.
b. When sellers update products in the Local Shop, the system will automatically synchronize these updates to the Cross Border Direct Shop.
- Fields managed by both local and Cross Border Direct Shops:
a. These fields may have market differences, such as product name and description.
b. Sellers can choose to update through the Local Shop, and the system will translate and synchronize these updates to the Cross Border Direct Shop.
c. Alternatively, sellers can update these fields in the Cross Border Direct Shop directly, and these updates will only apply to this specific Cross Border Direct Shop.
- Fields managed only through the Cross Border Direct Shop:
a. These fields are not managed through the Local Shop, such as logistics channels.
| Product Fields in API | Local Shop Management | Cross Border Direct Shop Management |
|---|---|---|
| Category (category_id) | Yes | No |
| Attribute (attribute) | Yes | No |
| Brand (brand) | Yes | No |
| Product Name (item_name) | Yes | Yes |
| Product Description (description) | Yes | Yes |
| Product Weight (weight) | Yes | No |
| Product Dimension (dimension) | Yes | No |
| Product Price (price) | Yes | Yes |
| Product Stock (stock) | Yes | No |
| Product Image and Video (image/video) | Yes | Yes |
| Product Pre-order (pre_order) | Yes | No |
| Product Days to Ship (days_to_ship) | Yes | No |
| Product Status (item_status) | Yes | Yes |
| Product Condition (condition) | Yes | No |
| Product SKU (item_sku) | Yes | No |
| Product Tier Variation Quantity (tier_variation structure) | Yes | No |
| Product Tier Variation Name and Option Name (name/option) | Yes | Yes |
| Product Logistics Info (logistic_info) | - | Yes |
| Product Dangerous Label (item_dangerous) | Yes | No |
- Shop Basic Configuration
a. After setting up a Cross Border Direct Shop, sellers must first configure the Market Price Adjustment Rate and Service Fee Rate in the Local Shop before they can create Cross Border products.
b. Sellers can control whether product information updates from the Local Shop are automatically synchronized to the Cross Border Direct Shop by configuring the Product Information Synchronization Settings in the Local Shop.
| API Field(s) | Release Time | ERP Integration Target Completion Date | Remark |
|---|---|---|---|
| All changes mentioned above | 24 Mar 2025 | Before 21 Apr 2025 | If the changes/ integration isn't completed on time, it may affect the management of Cross Border Direct Shop that has migrated to the upgraded Global Seller Center. Local Shop will not be affected by this change. |
尊敬的开发者,
Shopee启动了本土卖家跨境直营项目,支持本土卖家开设跨境直营店铺并售卖出口海外。
跨境直营模式关键要点:
- 店铺管理:
a. 在新的跨境直营模式中,直营店铺将由卖家自行管理。
- 商品/刊登管理:
a. 系统不允许卖家单独在直营店铺中创建商品以及修改商品的部分信息,卖家在本土店铺 (Main Shop) 创建/更新商品后,系统会自动同步在直营店铺 (Direct Shop) 中创建/更新商品。
b. 系统会提供推荐售价接口指引卖家定价。
- 订单管理、物流与营销:
a. 订单管理、物流履约、营销推广等其他部分,与普通的跨境店铺相同,卖家需要在直营店铺中进行管理。
具体更新如下:
- 授权与取消授权
a. 授权与取消授权页面将会展示本土店铺与跨境直营店铺之间的绑定关系,并且跨境直营店铺将展示 “Direct” 标签。
b. 卖家可以分别对本土店铺与跨境直营店铺进行授权与取消授权,两种店铺的授权关系是独立的,没有关联。
- 店铺类型判断
已有v2.shop.get_shop_info接口新增下述字段,用于判断店铺是否为跨境直营模式:
| 名称 | 类型 | 描述 |
|---|---|---|
| is_main_shop | boolean | 标识当前店铺是否为开设了跨境直营店铺的本土店铺 |
| is_direct_shop | boolean | 标识当前店铺是否为跨境直营店铺 |
| linked_main_shop_id | int64 | 返回跨境直营店铺所绑定的本土店铺的Shop ID |
| linked_direct_shop_list | object[] | 返回本土店铺所开设的跨境直营店铺列表 |
| >direct_shop_id | int64 | 跨境直营店铺的Shop ID |
| >direct_shop_region | string | 跨境直营店铺的Shop Region |
- 商品管理
系统不允许卖家单独在直营店铺中创建商品以及修改商品的部分信息,跨境直营店铺的商品由系统自动从本土店铺中同步而来,具体接口逻辑如下:
3.1 新接口对接
-
新增v2.product.get_direct_item_list接口,支持通过本土店铺的商品Item ID,获取跨境直营店铺的商品Item ID;
-
新增v2.product.get_main_item_list接口,支持通过跨境直营店铺的商品Item ID,获取本土店铺的商品Item ID;
-
新增v2.product.get_direct_shop_recommended_price接口,支持通过本土店铺的商品信息,获取跨境直营店铺的商品推荐价格。
3.2 已有接口调用限制
| 接口 | 跨境直营店铺调用 |
|---|---|
| v2.product.get_category | No |
| v2.product.get_attribute_tree | Yes |
| v2.product.get_recommend_attribute | No |
| v2.product.get_brand_list | No |
| v2.product.get_item_limit | Yes |
| v2.product.get_item_list | Yes |
| v2.product.get_item_base_info | Yes |
| v2.product.get_item_extra_info | Yes |
| v2.product.add_item | No |
| v2.product.update_item | Yes (Partial Field) |
| v2.product.delete_item | No |
| v2.product.init_tier_variation | No |
| v2.product.update_tier_variation | Yes (Partial Field) |
| v2.product.get_model_list | Yes |
| v2.product.add_model | No |
| v2.product.update_model | Yes |
| v2.product.delete_model | No |
| v2.product.unlist_item | No |
| v2.product.update_price | Yes |
| v2.product.update_stock | No |
| v2.product.boost_item | Yes |
| v2.product.get_boosted_list | Yes |
| v2.product.get_item_promotion | Yes |
| v2.product.update_sip_item_price | No |
| v2.product.search_item | Yes |
| v2.product.category_recommend | No |
| v2.product.register_brand | No |
| v2.product.get_size_chart_list | Yes |
| v2.product.get_size_chart_detail | Yes |
| v2.product.get_item_violation_info | Yes |
| v2.product.get_variations | Yes |
| v2.product.get_aitem_by_pitem_id | No |
【注意】对于允许调用的接口,部分字段禁止跨境直营店铺管理,可以查看 [3.3 商品字段管理限制]。
3.3 商品字段管理限制
我们将商品相关的字段分为三类:
-
只能通过本土店铺管理的字段: 这些字段无市场差异,例如类目、属性等,卖家通过更新本土店铺的商品,系统将会同步更新到跨境直营店铺的商品;
-
本土店铺和跨境直营店铺共同管理的字段:
这些字段可以有市场差异,例如商品名称和描述等,卖家可以选择通过本土店铺的商品进行更新,则系统将会经过翻译后同步更新到跨境直营店铺的商品,或者卖家可以单独更新跨境直营店铺的商品,则该更新只生效于跨境直营店铺的商品;
- 只能通过跨境直营店铺管理的字段:
这些字段不通过本土店铺管理,例如物流渠道。
| 商品字段 | 本土店铺管理 | 跨境直营店铺管理 |
|---|---|---|
| 类目 (category_id) | Yes | No |
| 属性 (attribute) | Yes | No |
| 品牌 (brand) | Yes | No |
| 商品名称 (item_name) | Yes | Yes |
| 商品描述 (description) | Yes | Yes |
| 商品重量 (weight) | Yes | No |
| 商品尺寸 (dimension) | Yes | No |
| 商品价格 (price) | Yes | Yes |
| 商品库存 (stock) | Yes | No |
| 商品图片和视频 (image/video) | Yes | Yes |
| 商品预售 (pre_order) | Yes | No |
| 商品发货天数 (days_to_ship) | Yes | No |
| 商品状态 (item_status) | Yes | Yes |
| 商品条件 (condition) | Yes | No |
| 商品SKU (item_sku) | Yes | No |
| 商品变体数量 (tier_variation structure) | Yes | No |
| 商品变体规格名称和变体名称 (name/option) | Yes | Yes |
| 商品物流(logistic_info) | - | Yes |
| 商品危险标识(item_dangerous) | Yes | No |
- 店铺基础配置
a. 开设跨境直营店铺后,卖家需要先在本土店铺完成价格调整比例 (Market Price Adjustment Rate) 和服务费率 (Service Fee Rate) 的配置,才能创建商品。
b. 卖家可以通过本土店铺的商品信息同步设置,控制本土店铺的商品信息更新是否自动同步到跨境直营店铺的商品。
| 接口字段 | 上线可对接时间 | ERP 对接时间要求 | 备注 |
|---|---|---|---|
| 以上所有改动 | 2025-03-24 | 2025-04-21之前完成对接 | 如果没有及时完成对接,可能会对已经迁移至升级版卖家中心的跨境直营店铺的管理产生影响 (卖家的本土店铺不会收到影响) |
