陈俊安-ozon交接

# # 官方文档地址
```
// 商品
https://docs.ozon.ru/api/seller/zh/#section/Seller-API
// 广告
https://docs.ozon.ru/api/performance/
```
# # 负责的产品
万钰洁

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

# # 流程
1、基础信息
ozon 的基础信息分为分类、分类属性、属性选项
> 由 `mps-ozon-product` 项目同步然后推送到广州的 `mdc-ozon-product` 消费，其中，分类和分类属性可以通过传入不同的语言拉取到对应语言的数据，因此不用翻译，但是属性选项没有支持多语言，因此属性选项需要翻译。

为了在白天降低数据库的压力，我们在同步分类后屏蔽了推送拉取属性的代码，并在每天晚上手动丢入队列去拉取属性和属性选项。使用以下接口手动拉取：
```
https://mdc-open-api.mabangerp.com/mdc-open-api-information-service/doc.html#/1.0/ozon%20%E5%9F%BA%E7%A1%80%E4%BF%A1%E6%81%AF/syncCategoryAttributeUsingPOST
```

为了加快拉取的速度，我们把分页的页容量设置为最大5000，因此在同步基础信息时内存占用会较大，平均同步全量的基础信息一般需要一周以上。

另外，还有一个关键的点就是由于品牌的数据量巨大，我们单独从属性选项提出来拉取了，单独拉取平台也需要大约1周。其中处理的代码如下：

`OzonConsumerServiceImpl.pushSyncAttributeValues()`

以下代码只拉取品牌属性选项：

![](/media/202308/2023-08-28_113545_6012160.22907249250969075.png)

品牌则跳过翻译：
![](/media/202308/2023-08-28_113625_5191280.6746847210491059.png)

2、刊登
刊登的流程比较中规中矩，PHP丢入任务到```mdc-iapi-product```项目，
`mdc-ozon-product` 项目进行消费并组装为中台的刊登接口入参，这里需要注意的是由于平台没有主子商品的概念，提交给中台时一个子商品会是一个任务，因此，广州的子刊登表中会有中台ID和刊登结果。
中台的 `mps-ozon-product` 项目刊登时将批量任务一起提交给平台刊登（平台接口是支持的），一起获取结果。

> `注意`：ozon 刊登和更新是对平台是一个接口，因此我们是不允许客户对同一个sku重复刊登的，限制方法是通过在线列表接口查询对应的sku是否存在，已存在则不允许再刊登。

3、在线商品
同步店铺商品/同步单个商品的流程也比较中规中矩，PHP丢入任务到```mdc-iapi-product```项目，
`mdc-ozon-product` 项目进行消费并调用中台的同步接口，中台在同步单个商品时会调用多个接口来获取完整的描述信息，代码如下：

![](/media/202308/2023-08-28_115859_0067300.8583915161965299.png)

# # 注意点
1、刊登平台没有返回错误信息
> 这种情况一般是传给平台的数据不太正确，例如商品标题不符合要求（标题只能是俄文，其他语言和表情符号都不可以）等。
```
{
    "result": {
        "items": [
            {
                "offer_id": "04182300783_led flashlight",
                "product_id": 0,
                "status": "failed",
                "errors": []
            }
        ],
        "total": 1
    }
}
```

2、刊登经常出现在pending中很久的情况，甚至有一直在pending的任务
> 一般是平台的原因导致的，暂无解决方案。（可以重新刊登试下）

3、刊登后的商品的状态不明确，报错信息也不明确（比如描述报错类型不正确）
> 一般需要看描述是否有特殊字符或奇怪的html标签等等。

4、ozon 目前新老版本同时在运行，但是数据库表不在一起，因此查询数据需要分开查询。（一般是让客户使用新版）

> 在线商品存放的是es和tidb，页面展示的是es的，
线上es地址：https://es-bw0h8nc0.kibana.tencentelasticsearch.com:5601/login
账密：kandeng/bDAenXPy0YaxjHxC2nLe
内网es地址：http://192.168.2.20:5601/login
账密：elastic/C7tn1bSt773PY5sPzQ1