快工助手跨境电商知识与商机助手

[Important] Support Local Sellers’ Cross Border Direct Selling Mode

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/api-producttopic/api-shoptopic/changelogtopic/developertopic/openapi-updates

资料正文

§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:

  1. Shop Management:

a. In this new model, sellers will manage their Direct Shop within the Global Seller Center.

  1. 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.

  1. 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:

  1. 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.

  1. 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.

NameTypeDescription
is_main_shopbooleanIdentifies if the current shop is the Local Shop linked to a Cross Border Direct Shop.
is_direct_shopbooleanIdentifies if the current shop is a Cross Border Direct Shop.
linked_main_shop_idint64Returns the Shop ID of the Local Shop linked to the Cross Border Direct Shop.
linked_direct_shop_listobject[]Returns the list of Cross Border Direct Shops linked to the Local Shop.
> direct_shop_idint64Shop ID of the Cross Border Direct Shop.
> direct_shop_regionstringShop Region of the Cross Border Direct Shop.
  1. 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

  1. 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.

  2. 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.

  3. 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

APIAllow Direct Shop to Call API or Not
v2.product.get_categoryNo
v2.product.get_attributesYes
v2.product.get_recommend_attributeNo
v2.product.get_brand_listNo
v2.product.get_item_limitYes
v2.product.get_item_listYes
v2.product.get_item_base_infoYes
v2.product.get_item_extra_infoYes
v2.product.add_itemNo
v2.product.update_itemYes (Partial Field)
v2.product.delete_itemNo
v2.product.init_tier_variationNo
v2.product.update_tier_variationYes (Partial Field)
v2.product.get_model_listYes
v2.product.add_modelNo
v2.product.update_modelYes
v2.product.delete_modelNo
v2.product.unlist_itemNo
v2.product.update_priceYes
v2.product.update_stockNo
v2.product.boost_itemYes
v2.product.get_boosted_listYes
v2.product.get_item_promotionYes
v2.product.update_sip_item_priceNo
v2.product.search_itemYes
v2.product.category_recommendNo
v2.product.register_brandNo
v2.product.get_size_chart_listYes
v2.product.get_size_chart_detailYes
v2.product.get_item_violation_infoYes
v2.product.get_variationsYes
v2.product.get_aitem_by_pitem_idNo

[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:

  1. 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.

  1. 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.

  1. 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 APILocal Shop ManagementCross Border Direct Shop Management
Category (category_id)YesNo
Attribute (attribute)YesNo
Brand (brand)YesNo
Product Name (item_name)YesYes
Product Description (description)YesYes
Product Weight (weight)YesNo
Product Dimension (dimension)YesNo
Product Price (price)YesYes
Product Stock (stock)YesNo
Product Image and Video (image/video)YesYes
Product Pre-order (pre_order)YesNo
Product Days to Ship (days_to_ship)YesNo
Product Status (item_status)YesYes
Product Condition (condition)YesNo
Product SKU (item_sku)YesNo
Product Tier Variation Quantity (tier_variation structure)YesNo
Product Tier Variation Name and Option Name (name/option)YesYes
Product Logistics Info (logistic_info)-Yes
Product Dangerous Label (item_dangerous)YesNo
  1. 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 TimeERP Integration Target Completion DateRemark
All changes mentioned above24 Mar 2025Before 21 Apr 2025If 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启动了本土卖家跨境直营项目,支持本土卖家开设跨境直营店铺并售卖出口海外。

跨境直营模式关键要点:

  1. 店铺管理:

a. 在新的跨境直营模式中,直营店铺将由卖家自行管理。

  1. 商品/刊登管理:

a. 系统不允许卖家单独在直营店铺中创建商品以及修改商品的部分信息,卖家在本土店铺 (Main Shop) 创建/更新商品后,系统会自动同步在直营店铺 (Direct Shop) 中创建/更新商品。

b. 系统会提供推荐售价接口指引卖家定价。

  1. 订单管理、物流与营销:

a. 订单管理、物流履约、营销推广等其他部分,与普通的跨境店铺相同,卖家需要在直营店铺中进行管理。

具体更新如下:

  1. 授权与取消授权

a. 授权与取消授权页面将会展示本土店铺与跨境直营店铺之间的绑定关系,并且跨境直营店铺将展示 “Direct” 标签。

b. 卖家可以分别对本土店铺与跨境直营店铺进行授权与取消授权,两种店铺的授权关系是独立的,没有关联。

  1. 店铺类型判断

已有v2.shop.get_shop_info接口新增下述字段,用于判断店铺是否为跨境直营模式:

名称类型描述
is_main_shopboolean标识当前店铺是否为开设了跨境直营店铺的本土店铺
is_direct_shopboolean标识当前店铺是否为跨境直营店铺
linked_main_shop_idint64返回跨境直营店铺所绑定的本土店铺的Shop ID
linked_direct_shop_listobject[]返回本土店铺所开设的跨境直营店铺列表
>direct_shop_idint64跨境直营店铺的Shop ID
>direct_shop_regionstring跨境直营店铺的Shop Region
  1. 商品管理

系统不允许卖家单独在直营店铺中创建商品以及修改商品的部分信息,跨境直营店铺的商品由系统自动从本土店铺中同步而来,具体接口逻辑如下:

3.1 新接口对接

  1. 新增v2.product.get_direct_item_list接口,支持通过本土店铺的商品Item ID,获取跨境直营店铺的商品Item ID;

  2. 新增v2.product.get_main_item_list接口,支持通过跨境直营店铺的商品Item ID,获取本土店铺的商品Item ID;

  3. 新增v2.product.get_direct_shop_recommended_price接口,支持通过本土店铺的商品信息,获取跨境直营店铺的商品推荐价格。

3.2 已有接口调用限制

接口跨境直营店铺调用
v2.product.get_categoryNo
v2.product.get_attribute_treeYes
v2.product.get_recommend_attributeNo
v2.product.get_brand_listNo
v2.product.get_item_limitYes
v2.product.get_item_listYes
v2.product.get_item_base_infoYes
v2.product.get_item_extra_infoYes
v2.product.add_itemNo
v2.product.update_itemYes (Partial Field)
v2.product.delete_itemNo
v2.product.init_tier_variationNo
v2.product.update_tier_variationYes (Partial Field)
v2.product.get_model_listYes
v2.product.add_modelNo
v2.product.update_modelYes
v2.product.delete_modelNo
v2.product.unlist_itemNo
v2.product.update_priceYes
v2.product.update_stockNo
v2.product.boost_itemYes
v2.product.get_boosted_listYes
v2.product.get_item_promotionYes
v2.product.update_sip_item_priceNo
v2.product.search_itemYes
v2.product.category_recommendNo
v2.product.register_brandNo
v2.product.get_size_chart_listYes
v2.product.get_size_chart_detailYes
v2.product.get_item_violation_infoYes
v2.product.get_variationsYes
v2.product.get_aitem_by_pitem_idNo

【注意】对于允许调用的接口,部分字段禁止跨境直营店铺管理,可以查看 [3.3 商品字段管理限制]。

3.3 商品字段管理限制

我们将商品相关的字段分为三类:

  1. 只能通过本土店铺管理的字段: 这些字段无市场差异,例如类目、属性等,卖家通过更新本土店铺的商品,系统将会同步更新到跨境直营店铺的商品;

  2. 本土店铺和跨境直营店铺共同管理的字段:

这些字段可以有市场差异,例如商品名称和描述等,卖家可以选择通过本土店铺的商品进行更新,则系统将会经过翻译后同步更新到跨境直营店铺的商品,或者卖家可以单独更新跨境直营店铺的商品,则该更新只生效于跨境直营店铺的商品;

  1. 只能通过跨境直营店铺管理的字段:

这些字段不通过本土店铺管理,例如物流渠道。

商品字段本土店铺管理跨境直营店铺管理
类目 (category_id)YesNo
属性 (attribute)YesNo
品牌 (brand)YesNo
商品名称 (item_name)YesYes
商品描述 (description)YesYes
商品重量 (weight)YesNo
商品尺寸 (dimension)YesNo
商品价格 (price)YesYes
商品库存 (stock)YesNo
商品图片和视频 (image/video)YesYes
商品预售 (pre_order)YesNo
商品发货天数 (days_to_ship)YesNo
商品状态 (item_status)YesYes
商品条件 (condition)YesNo
商品SKU (item_sku)YesNo
商品变体数量 (tier_variation structure)YesNo
商品变体规格名称和变体名称 (name/option)YesYes
商品物流(logistic_info)-Yes
商品危险标识(item_dangerous)YesNo
  1. 店铺基础配置

a. 开设跨境直营店铺后,卖家需要先在本土店铺完成价格调整比例 (Market Price Adjustment Rate) 和服务费率 (Service Fee Rate) 的配置,才能创建商品。

b. 卖家可以通过本土店铺的商品信息同步设置,控制本土店铺的商品信息更新是否自动同步到跨境直营店铺的商品。

接口字段上线可对接时间ERP 对接时间要求备注
以上所有改动2025-03-242025-04-21之前完成对接如果没有及时完成对接,可能会对已经迁移至升级版卖家中心的跨境直营店铺的管理产生影响 (卖家的本土店铺不会收到影响)
#