shopee v2 平台流程梳理

# 简介
```Shopee``` 是东南亚及中国台湾地区的电商平台，2015 年在新加坡成立以来，在东南亚有七个站点，台湾、马来西亚、菲律宾、新加坡、泰国、越南和印度尼西亚，在拉丁美洲主要有四个站点，分别是巴西、墨西哥、哥伦比亚和智利。

# 商户
通过 ```v2.merchant.get_merchant_info``` 接口可以获取shopee一个商户的信息，我理解为一个商户代表使用shopee服务的一个个体或一个企业，形式上以一个shopee账号的形式展现。
```
merchant_name => 商户名称
is_cnsc => 是否升级到cnsc
merchant_currency => 商品的货币单位（中国商家目前支持人民币和美元。韩国商家目前支持韩元和美元）
merchant_region => 商户所在区域
is_upgraded_cbsc => 是否升级到 cbsc
```

> 1、从该接口返回的信息可以看出 shopee 对于商户的管理方式上也进行了升级，引入了```cbsc（cb seller center）```的概念，CB 不是一个国家，而是 CB 认证成员国，包含了一大部分的国家。以往的管理方式为每个站点一个卖家中心，如果一个商户存在多个站点的店铺，想要把同一个商品卖到多个站点，操作起来是很麻烦的。而现在，对于中国卖家，shopee 使用 ```CNSC``` 来为用户管理多个站点，极大的方便了商户对商品的管理。对于韩国卖家，对应有 ```KRSC```。

# 店铺
通过 ```v2.shop.get_shop_info``` 接口可以获取shopee一个店铺的店铺信息。
```
shop_name => 店铺名称。
region => 店铺所属站点。
status => 店铺所属状态（BANNED：禁用, FROZEN：冻结, NORMAL：正常）。
is_cb => 是否为跨境店铺。
is_cnsc => 是否升级到 CNSC。
shop_cbsc => 账号卖家类型（CNSC：中国跨境卖家、KRSC：韩国跨境卖家、UNUPGRADED：未升级）。
is_sip => 是否为 SIP 店铺（当当前店铺为 SIP 主店铺或附属店铺，返回 TRUE）。
sip_affi_shops => 如果当前店铺为 SIP 主店铺，则该字段返回该 SIP 主店铺下的附属店铺。
```
> 1、从该店铺信息的接口不难看出，一个确定的店铺属于一个确定的站点，一个店铺确定为跨境店或本土店。对于中国卖家而言，用户可能存在还```未升级为 cnsc 的店铺``` 和 ```已经升级 cnsc 的店铺```。是否为跨境店铺和是否升级为cnsc店铺之间并不冲突，跨境店/本土店为店铺的类型，cnsc 则是中国卖家对于商品管理的一种方式。

> 2、其次，从 API 返回的数据看，店铺还存在 ```P 店铺``` 的概念。```P 店铺``` 也就是 ```SIP （Shopee International Platform）店铺``` ，```SIP 店铺``` 和 ```非 SIP 店铺``` 最大的区别在于店铺由谁来管理，一般商户通过一系列申请后获取到的店铺为```非 SIP 店铺```，通常也称为```自营店```，这样的店铺用户需要自己管理备货、上架、优化、服务、发货等。而 ```SIP 店铺```，是由 Shopee 来管理运营的店铺，卖家只需要开通台湾站或者马来西亚站之后，开通 SIP 即可同时开通其他的站点，卖家只要自己备货、发货即可，极大提升运营效率。

> 3、再者，对于```P 店铺``` 而言，其下还存在 ```A 店铺``` 的概念。```A 店铺（Affiliate 店铺）``` 也被称为 ```SIP 附属店铺```。这些店铺也是由 Shopee 平台管理运营。对于一个 SIP 主店铺，其下一般会存在多个站点的的 A 店铺。

![](/media/202211/未命名文件_1669643163.png)

# 店铺授权
![](/media/202212/2022-12-02_201812_221731.png)

# 媒体信息（MediaSpace）
用户商品中的视频数据、图片数据等可以通过以下接口上传。（shopee 创建的商品中的媒体文件必须是平台的 URL 链接）
```v2.media_space.upload_image``` => 上传图片
```v2.media_space.init_video_upload``` => 初始化视频上传
```v2.media_space.upload_video_part``` => 视频分片上传
```v2.media_space.complete_video_upload``` = > 完成视频上传
```v2.media_space.get_video_upload_result``` = > 获取视频上传结果
```v2.media_space.cancel_video_upload``` = > 取消视频上传

# 商品
商品的管理分为 ```Global Product``` 和 ```Product```。```Global Product``` 是用于 CNSC 全球商品的管理，```Product``` 用于本土店商品的管理。

#### 全球商品（Global Product）
> 一般跨境卖家都会有一个全球店铺来管理多个站点店铺的商品，全球店铺不属于任何有一个站点，只可以创建和管理商品，不能出单和发货。在创建商品之前，可以通过以下接口获取创建一个商品需要填写基础数据信息和限制。
```v2.global_product.get_category``` => 商品分类
```v2.global_product.get_attributes``` => 分类属性（和商品所属分类相关）
```v2.global_product.get_brand_list``` => 品牌
```v2.global_product.get_global_item_limit``` => 创建商品的限制（价格范围、库存范围、商品名称长度范围、商品描述长度范围、橱窗图图片数量、商品变体数量等）
```v2.global_product.get_dts_limit``` => 发货天数限制（和商品所属分类相关）
```v2.global_product.support_size_chart``` => 是否支持尺码图（和商品所属分类相关）

> 有了这些创建商品的限制之后，选择好相应的分类，按照要求填写好数据后可以通过```v2.global_product.add_global_item``` 接口提交数据创建一个全球商品。当然平台还会有一些其他的限制，比方说标题和描述只能填写中文或英文，因为当商品发布到子站点时，会使用 Shopee 的翻译模型，当使用了特殊符号或其他语言时，该翻译模型可能会出现一些意外的错误。

> 当上一步没有出现错误时，我们即创建好了一个商品，但是只是还不够的，这个接口只是提交了一个商品具备的主要信息，还需要告诉平台有哪些变体、尺码图等信息。
```v2.global_product.init_tier_variation``` => 当我们第一次为商品上传变体结构时，可以通过该接口来初始化商品的变体，该接口上传时需要注意商品的层级结构。
```v2.global_product.update_size_chart``` => 如果商品所属的分类支持尺码图，可以通过该接口创建尺码图。

> 通过这些步骤，已经成功创建了一个全球商品，但是全球商品是不能直接售卖的，需要发布到一个确定的站点店铺才能售卖，这个店铺必须是升级了 cbsc 的站点店铺，可以通过```v2.global_product.create_publish_task``` 接口来发布。如果对发布到站点的商品没有特殊化要求的话，只需要传少量的数据就可完成发布，但是该接口对于平台来说是一个异步的接口，该接口只返回一个任务ID，我们需要使用该任务 ID 通过 ```v2.global_product.get_publish_task_result``` 接口来获取发布结果。

> 全球商品发布到站点后，站点商品会有一个新的商品ID，这个商品就是可以被售卖的商品了，我们可以通过```v2.global_product.get_global_item_id``` 接口来获取一个站点商品锁关联的全球商品的ID。

> 另外我们还可以通过 ```v2.global_product.get_publishable_shop``` 接口来查询一个全球商品在哪些店铺发布成功了。

> 此外，shopee 还提供了一些其他接口来管理商品的管理。
```v2.global_product.get_global_item_list``` => 获取当前全球店铺的全球商品ID列表
```v2.global_product.get_global_item_info``` => 通过全球商品ID获取全球商品的信息
```v2.global_product.update_global_item``` => 更新全球商品的基础商品信息（关联的站点商品也会一起更新）
```v2.global_product.delete_global_item``` => 删除全球商品（关联的站点商品也会一起删除）
```v2.global_product.update_tier_variation``` => 更新全球商品的变体层级（关联的站点商品也会一起更新）
```v2.global_product.update_price``` => 更新商品的价格（关联的站点商品也会一起更新）
```v2.global_product.update_stock``` => 更新商品的库存（关联的站点商品也会一起更新）```值得一提的是，这里设置的库存并不会平分给各个站点的商品，而是直接给每个站点也设置一样的值```

![](/media/202211/企业微信截图_16697055622082_1669705590.png)

# 订单
> 拆单：当一笔订单中包含多个商品的时候，拆单功能可以帮助卖家根据每个商品的准备情况和货物位置，分别安排发货。

![](/media/202212/2022-12-03_162826_640638.png)

# 发货
> 发货参数包含三种：pick up/drop off/no intergrated
> ```Pick up```：非快递寄送，渠道上门揽收，首公里仅渠道"logistics_channel_name": "shopee"（"logistics_channel_id": 813）支持pickup。
> ```Drop off```：快递寄送，送至渠道网点，首公里渠道中除"logistics_channel_name": "shopee"（"logistics_channel_id": 813）和"logistics_channel_name": "Self Deliver"（"logistics_channel_id": 0）外，其他渠道均为 dropoff。
> ```No intergrated```: 非集成渠道，用户自己填写运单号。
> ```Self deliver```：自送卖家，不使用第三方物流， "logistics_channel_name": "Self Deliver"。

![](/media/202212/2022-12-03_204947_452727.png)

# 退货
> 退货一般由买家提供方案，并发起退货，由卖家确认，如果卖家觉得方案不合理，也可以提供卖家的方案，让买家确认，如果双方对此都有争议，可以提交证据等信息到争议中心。

![](/media/202212/2022-12-03_212302_030672.png)