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

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 Developer,

Please find below updates:

  1. Support model level order split

SplitOrder API adds a new request parameter "variation_id", which will support the seller split order in variation level.

The variation_id is required, if the item in the order doesn’t have variations, please input variation_id:0

Optimized API: shopee.order.SplitOrder

Effective Date on Live: 2020/10/16

  1. [CB] Response transfer warehouse info

When calling Init to fetch tracking_no and the shop hasn't set transfer warehouse address, it will return error message: “请您在发货前登录卖家中心确认默认的寄送的Shopee仓库和使用的寄送方式。操作方式:登入【卖家中心】→ 点击【物流】中的【物流设置】→ 确认。货拉拉类和自送仓库卖家仅需要确认您寄送的Shopee仓库即可"。

Optimized API: shopee.logistics.Init

Effective Date on Live: Lived

  1. Display deleted items in GetItemList

GetItemList add new request parameter “need_deleted_item” to fetch deleted item list or not.

Optimized API: shopee.item.GetItemsList

Effective Date on Live: Lived

  1. CB SIP whitelisted seller can modify Item Price

Whitelisted sellers can edit the item price of SIP A-item conveniently by themselves, when calling the below 4 interfaces. New field "item_price" needs to be added to the input parameters.

What's more, in the response, 4 types of error messages will be added regarding the Item Price:

-"item_price" should less than the "price".

-"item_price" can only be changed once a day.

-"item_price" cannot be edited when product is on promotion in affiliate shop.

-"item_price" cannot be edited when product is scheduled for a promotion in affiliate shop.

Optimized API: shopee.item.UpdatePrice/ shopee.item.UpdatePriceBatch/ shopee.item.UpdateVariationPrice/ shopee.item.UpdateVariationPriceBatch

Effective Date on Live: 2020/10/15

  1. Optimization error Msg when products participate in promotion

Effective Date on Live: 2020/10/15

尊敬的開發者

請留意以下變化

1.支持Model尺寸拆單

SplitOrder接口添加預設參數variation_id(必填,若需要拆單的訂單商品無variation_id,則variation_id傳0)支model尺寸拆單

API:shopee.order.SplitOrder

上線時間:2020年10月16日

2.發布接口新增轉運倉信息

對於開通灰名單權限的店鋪,使用未設置轉運倉地址的訂單調用初始接口獲取tracking_no時,返回提示信息:“请您在发货前登录卖家中心确认默认的寄送的Shopee仓库和使用的寄送方式。操作方式:登入【卖家中心】→ 点击【物流】中的【物流设置】→ 确认。货拉拉类和自送仓库卖家仅需要确认您寄送的Shopee仓库即可“。

API:shopee.logistics.Init

上線時間:已上線

  1. GetItemlist接口可獲取刪除狀態的商品

在調用GetItemlist接口時,可根據入參need_deleted_item的值判斷是否返回狀態為已刪除的商品

API:shopee.item.GetItemsList

上線時間:已上線

  1. CB SIP賣家開放編輯項目價格

將物品價格放權給賣家自己可以進行修改,在以下接口,入參都需要增加物品價格(非必填)。在返回的錯誤消息中會針對物品價格編輯的場景增加4種報錯信息,分別為:

商品價格需要小於商品原價

商品價格一天只能被變更一次

若此時A-shop中該商品正在促銷活動中,則不能修改商品價格

若此時A-shop中該商品即將要參與促銷活動,則不能修改商品價格

API:shopee.item.UpdatePrice / shopee.item.UpdatePriceBatch / shopee.item.UpdateVariationPrice / shopee.item.UpdateVariationPriceBatch

上線時間:2020年10月15日

5.關於參與促銷的item相關更新操作的錯誤消息

上線時間:2020年10月15日

#