陈俊安-shopee交接

# # 官方文档地址
```
v1：https://open.shopee.com/documents/v1/Introduction?module=63&type=2
v2：https://open.shopee.com/documents/v2/Introduction?module=87&type=2
```
# # 负责的产品
梁丹

# # 项目
`mps-shopee-product`
`mdc-open-api-information`
`mdc-open-api-publish`
`mdc-open-api-product`

# # 流程
shopee 是攻坚期间开发的项目，流程上和结构上与现在新开发的平台有些区别。
1、基础信息

直调接口和推送的consumer都是在这一个项目。

> 全球的分类和属性是使用推送的方式给PHP数据（ShopeeSyncCategoryGlobalConsumer、ShopeeSyncAttributeGlobalConsumer），

> 本土的分类和属性是使用直调的接口给PHP获取数据（ShopeeV2ProductController.getCategory()、ShopeeV2ProductController.getCategoryAttribute()）

> 但是对于属性，正在切换为新的接口，全球的推送属性在consumer入口处可以看到调用了新的方法syncCategoryAttributeTree()，而本土的属性提供了新的接口调用（ShopeeV2ProductController.getCategoryAttributeTree()）

2、刊登
由 `mdc-open-api-publish` 入口存入刊登数据，并丢入队列，`mps-shopee-product` 从队列消费去调平台刊登。

全球刊登
> `ShopeePublishGlobalConsumer` 由这个消费者为入口，首先会把我们数据库的数据组装为平台需要的数据结构，组装的过程中我们会先把图片分别上传给平台获取到图片ID，然后把图片ID替换到刊登的数据中提交给平台，然后再上传变体数据（变体数据包含变体价格，变体层级结构等），然后再发布到客户需要发布的站点，发布站点这里有些不同，有一定的发布策略，详情可见代码注释，该策略由梁丹确认。

![](/media/202308/2023-08-22_153506_1946050.06933655991638377.png)

> 发布完成后还需要给商品设置尺码图，如果客户需要设置的话。这些都完成后就会把结果推送给广州的队列，由PHP进行消费。

> 本土站点的刊登同理，只是没有发布那一步。

3、在线商品
在线商品主要分为同步店铺商品和同步单个商品，同步店铺商品会调用获取商品列表的接口获取每页的商品ID，并把每个商品ID丢入同步单个商品的队列。
同步单个商品是调用平台获取商品详情的接口和获取变体信息的接口一起组装为一个商品保存和推送到广州的PHP队列，本土和全球的同步在线商品类似。
注意：shopee拉取商品是增量拉取。

# # 注意点
1、3pf 店铺问题
很多客户自己也搞不清楚哪个是3pf店铺，但是没有把3pf店铺授权到马帮的话页面不是展示多仓库存的填写，导致全球商品无法刊登。因此需要排查客户是否把3pf店铺授权到马帮。
1.1 如何确认哪些站点有3pf店铺
> 以下线上接口可以获取一个全球店铺下的仓库列表，除了CNZ，其他站点仓库也就代表该站点存在3pf店铺
```
https://mdc-open-api.mabangerp.com/mdc-open-api-publish-service/doc.html#/1.0/shopee%20%E5%88%8A%E7%99%BB%E5%95%86%E5%93%81%20global/getWarehouseListUsingPOST
```
1.2 如何知道客户是否将3pf店铺授权到马帮
> 以下sql可以快速查看客户是否授权了3pf店铺到马帮，其中extend2字段中存在is_3pf字段，只要有一个店铺的is_3pf字段为true就可以了，页面就会展示多仓库存的填写。
```
select extend2 from DB_Shop where companyId = 304493 and merchantId = 1303373 and tokenflag = 1 and status = 1
```

![](/media/202308/2023-08-28_104824_2122190.5607917333603895.png)

## 活动
> 状态表：mdc_platform_meta_base.t_common_shop_item