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

Significant OpenAPI Updates

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/changelogtopic/developertopic/uncategorized

资料正文

§1 Significant OpenAPI Updates

Dear Developers,

Please find the below updates:

1.Singapore Seller Center/Open API will implement the following logic for the below logistics channels(you may find additional information:https://seller.shopee.sg/edu/article/5879)

  • For shop level logistics channel configuration:

If channel B is enabled, channel A will also automatically be enabled

If channel B is disabled, there is no impact to channel A

If channel A is disabled, channel B will also automatically be disabled

  • For item level logistics channel configuration:

If channel B is enabled, channel A will also automatically be enabled

If channel B is disabled, there is no impact to channel A

If channel A is disabled, channel B will also automatically be disabled

If channel A is not enabled on shop level, channel B cannot be enabled, an error response will be received: “Sorry you can't enable this channel since the related {logistics_name} on shop level is disabled. Please enable the related {logistics_name} on shop level first.”

API Involved:

  • shopee.logistics.UpdateShopLogistics
  • item.Add
  • item.UpdateItem

Effective Date on Live: Lived

  1. Shopee has provided 3PL masking to improve both buyer and seller’s experience. With the introduction of checkout(masked) channel and fulfillment channel, there will be 3 new response parameters added in the logistics.GetLogistics API: logistics_description, is_force_enabled, mask_channel_id.
  • logistics_description: for checkout channels, this field indicates its corresponding fulfillment channels.
  • is_force_enabled: indicates whether the logistic channel is force enabled on Shop Level. If true, sellers cannot close this channel.
  • mask_channel_id: Indicate the parent logistic channel ID. If it’s 0, it indicates the channel is a checkout(masked) channel; if it’s not 0, indicate the channel is a fulfillment channel and has a checkout channel(checkout channel’s channel_id equals this mask_channel_id) on top of it. Multiple channels may share the same mask_channel_id.

Related APIs:

  • shopee.logistics.GetLogistics
  • shopee.logistics.UpdateShopLogistics

Effective Date on Live: 2021.03.04

More Materials:

TH 3PL Masking for sellers:

https://seller.shopee.co.th/edu/article/3863

ID 3PL Masking for sellers:

https://seller.shopee.co.id/edu/article/6112

3.For the wholesale item, when the seller sets the wholesale quantity information, the original logic is the minimum count should be less than the maximum count. Now the minimum count can be equal to the maximum count. It means the minimum count should be less than or equal to the maximum count.

Related APIs:

  • shopee.item.Add
  • shopee.item.UpdateItem

Effective Date on Live: Lived

  1. For the CrossBorder (CB) SIP Affiliated shop (A shop) order, when calling the GetOrderDetails API, the variation_original_price in the response data will be the settlement price in Primary shop (P shop) currency. And the variation_discounted_price will return null for CB SIP A shop order.

Related API:

  • shopee.orders.GetOrderDetails

Effective Date on Live: 2021.03.11

  1. For some whitelist TW sellers, the maximum of split order allowed will be increased from 5 to 30.

Related API:

  • shopee.order.SplitOrder

Effective Date on Live: 2021.03.11

尊敬的開發者:

請留意以下更新

1.新加坡站點上線關聯物流渠道邏輯信息如下(涉及Open API/Seller Centre,关于新加坡站点关联物流渠道详细信息请参考:https://seller.shopee.sg/edu/article/5879 ):

  • 對於Shop Level物流更新信息匯總:

如果調用接口將物流渠道B開啟,關聯物流渠道A也會自動開啟

如果調用接口將物流渠道B關閉,不會影響關聯物流渠道A

如果調用接口將物流渠道A關閉,關聯物流渠道B也會自動被關閉

  • 對於Item Level物流渠道更新信息匯總:

如果調用接口將物流渠道B開啟,關聯物流渠道A也會自動開啟

如果調用接口將物流渠道B關閉,不會影響關聯物流渠道A

如果調用接口將物流渠道A關閉,關聯物流渠道B也會自動被關閉

如果物流渠道A在shop level沒有開啟時,當單獨開啟關聯物流渠道B時會失敗,接口返回error_message樣例如下:“Sorry you can't enable this channel since the related {logistics_name} on shop level is disabled. Please enable the related {logistics_name} on shop level first.”

影響接口:

shopee.item.Add

shopee.item.UpdateItem

shopee.logistics.UpdateShopLogistics

上線日期:已上線

  1. Shopee将会通过3PL masking来提升买家与卖家的购物体验,相应地OpenAPI也会支持店铺在物流渠道的配置以支持3PL masking。在增加checkout(masked)渠道和fulfillment渠道概念的前提下,在GetLogistics接口新增三个返参字段:logistics_description, is_force_enabled, mask_channel_id.
  • logistics_description: 对于checkout(masked)渠道,此字段会返回其下对应的fulfillment渠道
  • is_force_enabled: 用于标识该渠道是否在店铺维度被强制开启;若为true,则卖家不能关闭此渠道
  • mask_channel_id: 用于表明checkout(masked)渠道与fulfillment渠道的从属关系。当此字段返回0时,说明该渠道是masked chennel;当返回为非0时说明该渠道是fulfllment渠道且有上一级与其对应的checkout(masked)渠道(此mask_channel_id值会等于对应checkout(masked)渠道的channel_id值)。

相关接口:

  • shopee.logistics.GetLogistics
  • shopee.logistics.UpdateShopLogistics

上线时间:2021.03.04

3.对于批发商品,卖家在设置批发数量信息时,原始逻辑是最小数量应小于最大数量。现改为最小数量可以小于或等于最大数量。

相关接口:

  • shopee.item.Add
  • shopee.item.UpdateItem

上线时间:已上线

  1. 对于CrossBorder (CB) SIP 子站点订单,在调用GetOrderDetails接口时,返回参数中的variation_original_price字段将会以SIP主店铺(P Shop)的货币单位返回商品的结算价,返回参数中的variation_discounted_price字段将会返回为空值。

影响接口:

  • shopee.orders.GetOrderDetails

上线时间:2021.03.11

  1. 对于部分白名单的台湾卖家,允许的最大拆包数量会由5提高到30。该优化目前只支持1.0的拆包接口,2.0会在后期支持该功能。

影响接口:

  • shopee.order.SplitOrder

上线时间:2021.03.11

#