沙箱测试 V2.0

（注意：登录Open Console后查看Test Account功能可判断是否为新沙箱，新沙箱则显示为Test Account-Sandbox v2）

沙箱环境是Open Platform提供给开发者的测试环境，提供了多种类型的测试账号与数据，开发者可以在沙箱环境完成大部分API场景的测试工作，沙箱提供了与线上基本一致的功能，但只覆盖核心场景，例如：商品管理、订单管理、物流发货等。

Sandbox V2支持范围：

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

本文档主要介绍Sandbox测试环境创建测试账号、测试订单和发货的过程。

点击Console>选择Test Account-Sandbox v2，网址为 创建测试账号

1.1 本地和跨境测试店铺

本地和跨境测试店铺在很多方面都有区别，例如：店铺类目、可用的运输渠道等其他特殊逻辑。建议开发者创建服务市场对应的测试店铺即可。

1.2 Merchant

中国卖家中心(CNSC)的测试，开发者可以选择“ Merchant"来创建测试主账户，并绑定商家和店铺。

2.1前置步骤：

1. 创建APP：

2. 创建Sandbox Account：

你可以选择帐号类型，可以创建shop或者merchant类型的测试账号：

2.2 Shop授权文档

授权步骤：

测试Partner_id见下图，具体授权过程，可参考授权相关文档，或者按照以下步骤。

1.使用授权链接，填上对应的partner_id:

https://open.sandbox.test-stable.shopee.com/auth?auth_type=seller&partner_id=***&redirect_uri=https%3A%2F%2Fwww.baidu.com%2F&response_type=code

Noti: 对于沙箱环境固定授权的URL（包含https://account.sandbox.test-stable.shopee.com），请使用Sandbox Shop Account进行登录，而不是live account。否则会报错“账号/密码验证失败”。

2.填好对应的Sandbox Account登录即可：

3. 点击授权会跳转到成功页面：

2.3 Merchant授权文档

测试Partner_id见下图，具体授权过程，可参考授权相关文档，或者按照以下步骤。

1.使用授权链接，填上对应的partner_id:

https://open.sandbox.test-stable.shopee.cn/auth?auth_type=seller&partner_id=**&redirect_uri=https%3A%2F%2Fwww.baidu.com%2F&response_type=code

2.点击“main account”进行merchant授权：

Noti:对于沙箱环境固定授权的URL（包含https://account.sandbox.test-stable.shopee.com），请使用Sandbox Merchat Account进行登录，而不是live account。否则会报错“账号/密码验证失败”。

3. 验证码为“123456” （如果出现）

4. 登录后勾选出需要授权的店铺：

5. 点击授权会跳转到成功页面：

3.1 Shop账号

3.1.1 登入卖家中心

点击Console>选择Test Account-Sandbox页面，点击创建好的测试店铺右侧的Login Seller Center进入卖家中心页面。

卖家中心页面显示如图：

3.1.2 创建测试商品

3.1.2.1 可选择从SellerCenter或通过Open API创建商品。

以下为通过Seller Centre创建测试商品:

填写所有需要的信息，选择保存和发布

3.1.2.2 成功创建商品后，seller center可查看我的商品(My Products)

3.1.3 创建测试订单

3.1.3.1

点击Console>选择Test Order页面，点击“Create Test Order”弹出造单弹窗

点击“Shop”下拉框，选择需要创建的shop

点击Item(s) 下的“Select Item”，选择需要创建的item，并点击“Confirm”

点击“Shipping Option”下拉框选择履约的渠道，并点击“Create”完成订单创建

3.1.3.2 测试订单创建完成

3.1.4 查看已创建订单

进入seller center，点击“My Orders”查看创建的订单

Note：在Console页面创建订单后，需要等待5分钟左右，才可以进行下一步操作

3.1.5 发货

点击Arrange shipment，选取发货方式(pickup/dropoff)后，自动生成一个跟踪号，此时订单状态为PROCESSED。

Note：请在“To Ship“ tab中操作发货，”All“ tab会有操作无法操作的情况

Note:不同地区测试所选的物流渠道不同，订单发货方式会不同。一般只提供drop off/pick up这两种发货方式。

3.1.6 打印面单

目前，在 Seller Center 暂不支持打印面单这一操作。若您有打印面单的需求，仅可通过 API 实现。

Note:面单仅可在订单发货成功后至订单状态为SHIPPED之前打印，不限制打印次数。

3.1.7 订单状态流转

测试环境中完成发货后，您可以进入Console->Test Order页面操作订单流转状态

3.1.7.1 点击“Pickup” 订单状态会自动变成“SHIPPED”

Note: 您需要在seller center完成Arrange Shipment或者调用/api/v2/logistics/ship_order，订单状态是PROCESSED时才可以点击“Pickup”

3.1.7.2 点击“Deliver”订单配送完成会变成为“TO_CONFIRM_RECEIVE”

Note: 订单需要在“SHIPPED”状态下，才可以点击“Deliver”

3.2 Merchant账号

中国卖家中心(CNSC)的测试，开发者可以选择"China Merchant"来创建测试主账户，并绑定商家和店铺。

CNSC全称中国卖家中心，是为中国跨境卖家定制的卖家后台，卖家可以通过它管理多个店铺的商品、订单、营销等。CNSC的基本操作指南与介绍，请访问这里。

3.2.1 基础设置

Merchant测试账号创建完成后，通过“login Seller Center”登陆主账号，完成主账号和店铺的授权，并设置各个站点的汇率换算以及调价百分比，以利后续接口调试顺利进行，详细教程参考卖家学习中心：必做基础设置

Note:如需输入验证码(OTP),请输入"123456".

(登陆CNSC-->选择需要的平台基础货币单位-->完成弹窗设置-->点击确定）

设置平台基础货币单位和市场汇率：

(设置平台货币的市场汇率-->填写具体的汇率比例-->点击确定-->完成设置进入CNSC）

全球商品与店铺商品价格设置:

进入CNSC后，点击“全球商品”页面，弹出弹窗进行全球商品与店铺商品价格设置。

填写站点调价比例，活动服务费率等参数。可以通过“一件批量填充”应用到Main Account下的多个店铺。填写完成后 点击“开始升级全球商品”，即可完成设置：

全球商品首公里发货仓库设置

在Seller center中选择设置>店铺设定>物流设置>发货预报设置，设置完成后即可按照标准流程发货。

3.2.2 添加全球商品

3.2.2.1点击sidebar中的新增全球商品或在全球商品页面点击新增全球商品

3.2.2.2 新增全球商品详情（请按照您的需求填写并选择各项属性：创建全球商品）

3.2.3 全球商品与店铺商品

3.2.3.1添加及发布全球商品

点击保存并发布

3.2.3.2选择发布店铺

a.下图为选择新加坡站点的一个店铺（因region限制，不可发布的shop站点会进行置灰处理，请根据需要选择合适的全球商品信息）

b.确认店铺商品信息，无误后点击确认发布

c.查看发布记录

d.选择店铺商品即可查看发布的该商品

e.选择修改可更新商品(MPSKU)库存，价格等属性

3.2.3.3 MTSKU和MPSKU

全球商品(MTSKU)：MTSKU相当于父产品,虚拟商品，可以发布到多个区域，生成多个产品MPSKU。

店铺商品(MPSKU): item=商店商品。 买家可见的真实物品。

Note：MPSKUs会直接继承MTSKUs的基本信息，多个地区的MPSKUs和MTSKUs库存信息是一样的，卖家不再需要管理多个地区的同一产品的一些基本信息。卖家只需要修改 MTSKU的基本信息，系统可以自动同步修改所有已发布的MPSKU。

3.2.4 全球商品订单发货

a. 创建订单步骤与Local Shop 相同，可以参考 3.1.3 创建测试订单 和 3.1.4 查看已创建订单。

b. 创建订单步骤完成后，在 Test Account-Sandbox v2> China Merchant and CB Shops 下找到您的测试账号，并通过按钮“Login Seller Center”。 登陆成功后进入“My Order” 页面，并选择你创建的订单对应的站点和Shop。

c. 切换到对应的shop之后，您可以看到对应的订单,订单状态流转到“To Ship”后可以操作发货（在发货前请确定全球商品首公里发货仓库设置完成）。

d. 选择你的订单 点击 “Arrange Shipment”。

e. 选择你的订单 点击 “Arrange Shipment”，选择Drop-off方式，点击"Confirm"发货。（CB 渠道目前只支持Drop-off方式）

f. 发货后，订单会生成TN以及AWB，开发者可根据情况获取（目前仅支持API获取AWB）。

g. 最后回到Test Order 页面，通过点击“Pickup”和“Deliver” 完成模拟完成后续履约工作。 点击“Pickup”后订单会流转到“SHIPPED”状态。

点击“Deliver” 后订单会流转到“TO_CONFIRM_RECEIVE”状态。

h. 履约完成后订单无需您操作，会在一段时间后流转为“COMPLETED”状态，至此履约完成。

3.2.5 CNSC可测试接口

对接CNSC集中关注的接口均为商品管理相关，可测试的接口包含Merchant GlobalProduct 及MediaSpace下所有接口，其他测试与普通店铺无区别。

3.3 Push Mechanism

点击Console>选择Push Mechaniam页面，选择状态为Developing的APP，进入Set Push。

Sandbox环境中的Push Mechanism和生产环境有所不同，不再需要使用相关的操作才触发push。输入Test Call Back URL，点击“Verify and Save”完成验证后，只要点击对应Push Mechaniam后的“Push Test Data”即可接收到测试数据。