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

[Important] About Ending Maintenance for Sandbox and Upgrading to Sandbox V2

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/platform-function-updates

资料正文

§1 [Important] About Ending Maintenance for Sandbox and Upgrading to Sandbox V2

Dear Developers,

To improve the long-term testing experience in the Sandbox environment (hereinafter referred to as V1), we have created a new sandbox called Sandbox V2 (hereinafter referred to as V2). During the testing phase, V2 operates under a whitelist system, accessible only to selected developers, to gradually verify its stability and compatibility. Current evaluations show that Sandbox V2 greatly exceeds V1 in stability, maintainability, and performance. It better supports developers testing core scenarios such as product management, order management, and logistics fulfillment. As a result, we have decided to open Sandbox V2 to all developers.

Key changes to note after the upgrade:

Data in the V1 sandbox cannot be transferred to the new sandbox. After upgrading, all data in the V1 sandbox will be lost. Please note:

  • Data in the sandbox v1 will be fully deleted.
  • Recreate test accounts, products, and orders in the new V2 sandbox.
  • Update your Test Partner ID and Test Partner Key. The Request URL for the V2 Sandbox API will also be updated.

For detailed operational steps, please consult our test guide documentation: https://open.shopee.com/developer-guide/644. We plan to perform this switch on September 15th, when you will be able to use our new sandbox version in the OP console. Below is an overview of the changes in Sandbox V2.

Sandbox V2 Update Log:

Sandbox V2 Support Scope:

PortalModulesFeaturesRemark
ConsoleShopCreate test shop account
ConsoleOrderCreate test order
ConsolePushPush test data
Seller CenterProductCreate and manage the global SKU
Seller CenterProductPublish and manage the shop SKU
Seller CenterOrderOrder
Seller CenterOrderShip OrderPrinting AWB in Seller Center is not currently supported. Please use the Open API for printing.
Open APIProductAll APIsCan Be Called via the API Test Tools in the Console You can also call it yourself using the Regions: https://openplatform.sandbox.test-stable.shopee.sg/. Chinese Mainland: https://openplatform.sandbox.test-stable.shopee.cn/.
Open APIGlobal ProductAll APIs
Open APIMedia SpaceAll APIs
Open APIOrderAll APIs
Open APILogisticsAll APIs
Open APIFirst MileAll APIs
Open APIShopAll APIs
Open APIMerchantAll APIs
PushSupports receiving partial push test data. For details, refer to the Sandbox Push Mechanism Support Scope.

(If you need additional features supported by the sandbox, please submit a support ticket with your specific use case and requirements.)

Sandbox Push Mechanism Support Scope:

Push CategoryPush MechanismPush Code
Product Pushbanned_item_push6
Product Pushreserved_stock_change_push8
Product Pushvideo_upload_push11
Product Pushbrand_register_result13
Product Pushviolation_item_push16
Product Pushshopee_auto_correct_item_push17
Product Pushitem_price_update_push22
Product Pushitem_scheduled_publish_failed_push27
Order Pushorder_trackingno_push4
Order Pushorder_status_push3
Order Pushshipping_document_status_push15
Order Pushbooking_status_push23
Order Pushbooking_trackingno_push24
Order Pushbooking_shipping_document_status_push25
Order Pushpackage_fulfillment_status_push30
Order Pushcourier_delivery_binding_status_push37
Marketing Pushpromotion_update_push9
Marketing Pushitem_promotion_push7
Shopee Pushshop_authorization_push1
Shopee Pushshop_authorization_push2
Shopee Pushshopee_updates5
Shopee Pushshop_penalty_update_push28
Webchat Pushwebchat_push10
Return Pushreturn_updates_push29
Fulfillment by Shopee Pushfbs_sellable_stock36
Fulfillment by Shopee Pushfbs_br_invoice_error_push33
Fulfillment by Shopee Pushfbs_br_block_shop_push34
Fulfillment by Shopee Pushfbs_br_block_sku_push35
Fulfillment by Shopee Pushfbs_br_invoice_issued_push31
Fulfillment by Shopee Pushfbs_br_shop_enrollment_status_push32

Note: Some modules are unavailable in the sandbox, so you can only test the push message.

If you encounter sandbox issues, please submit a Ticket for assistance.

尊敬的开发者,

为提升Sandbox(以下称 V1)环境的测试长期体验,我们构建了一个新的沙箱环境 Sandbox V2(以下称V2)。在测试阶段,V2 环境采取白名单机制,仅向部分开发者开放,以便逐步验证其稳定性与兼容性。当前已经验证 Sandbox V2 在稳定性,可维护性和性能方面均显著优于 V1。可以更好的支持开发者测试核心心场景,例如:商品管理、订单管理、物流发货等,因此我们决定全量开放Sandbox V2。

升级后需注意的主要变化:

V1沙箱中的数据无法与新沙箱互通,升级后V1沙箱数据均不会保留,您需要注意:

  • 旧沙箱中的数据将被完全删除。
  • 在V2新沙箱内重新创建测试账号、商品和订单。
  • 更新您的 Test partner ID 和Test Partner Key ,V2 Sandbox API的 Request URL也会更新。

具体操作步骤请参考我们的测试指引文档:https://open.shopee.com/developer-guide/644

我们计划在9月15日进行本次切换,届时您将可以在OP console中体验我们的新版沙箱。以下为Sandbox V2 变化简介:

Sandbox V2 变更内容

Sandbox V2支持范围:

PortalModulesFeaturesRemark
ConsoleShopCreate test shop account
ConsoleOrderCreate test order
ConsolePushPush test data
Seller CenterProductCreate and manage the global SKU
Seller CenterProductPublish and manage the shop SKU
Seller CenterOrderOrder
Seller CenterOrderShip Order暂不支持卖家中心打印面单 请使用Open API打印
Open APIProductAll APIs通过Console中API Test Tools进行调用。 或使用以下连接调用: Regions: https://openplatform.sandbox.test-stable.shopee.sg/ 用。 Chinese Mainland: https://openplatform.sandbox.test-stable.shopee.cn/
Open APIGlobal ProductAll APIs
Open APIMedia SpaceAll APIs
Open APIOrderAll APIs
Open APILogisticsAll APIs
Open APIFirst MileAll APIs
Open APIShopAll APIs
Open APIMerchantAll APIs
Push支持接收部分push测试数据 具体见Sndbox Push Mechanism支持范围

(如果有更多需要沙箱支持的功能,请提工单反馈您的具体使用场景和诉求)

Sndbox Push Mechanism支持范围:

Push CategoryPush MechanismPush Code
Product Pushbanned_item_push6
Product Pushreserved_stock_change_push8
Product Pushvideo_upload_push11
Product Pushbrand_register_result13
Product Pushviolation_item_push16
Product Pushshopee_auto_correct_item_push17
Product Pushitem_price_update_push22
Product Pushitem_scheduled_publish_failed_push27
Order Pushorder_trackingno_push4
Order Pushorder_status_push3
Order Pushshipping_document_status_push15
Order Pushbooking_status_push23
Order Pushbooking_trackingno_push24
Order Pushbooking_shipping_document_status_push25
Order Pushpackage_fulfillment_status_push30
Order Pushcourier_delivery_binding_status_push37
Marketing Pushpromotion_update_push9
Marketing Pushitem_promotion_push7
Shopee Pushshop_authorization_push1
Shopee Pushshop_authorization_canceled_push2
Shopee Pushshopee_updates5
Shopee Pushshop_penalty_update_push28
Webchat Pushwebchat_push10
Return Pushreturn_updates_push29
Fulfillment by Shopee Pushfbs_sellable_stock36
Fulfillment by Shopee Pushfbs_br_invoice_error_push33
Fulfillment by Shopee Pushfbs_br_block_shop_push34
Fulfillment by Shopee Pushfbs_br_block_sku_push35
Fulfillment by Shopee Pushfbs_br_invoice_issued_push31
Fulfillment by Shopee Pushfbs_br_shop_enrollment_status_push32

Note: 部分模块还没有再沙箱开放,因此你只可以测试test push message。

如果您在沙箱的使用中遇到任何的问题,可以麻烦你通过 工单 获取支持。

#