Wish 业务文档

# Wish 调度中心 业务文档

## 一、Wish V3 平台接口文档

> Wish V3 接口文档 ：https://developer.ebay.com/DevZone/XML/docs/Reference/eBay/StandardListingIndex.html

## 二、业务线

### 刊登商品

刊登就是把商品信息上传到对应的平台，供用户购买。Wish 刊登流程比较简单，变体和主商品是放在一起，只需要调用一个接口就可以直接刊登。

#### 刊登商品流程：

刊登：构建并上传商品信息 ---> 调用平台接口刊登（[Create a product](https://merchant.wish.com/documentation/api/v3/reference#operation/createProduct)）

#### 刊登需要注意的事项：

依次构建 名字 title、描述、品牌ID、状况、最大数量、父sku、参考值、单位、默认商品价格、主图、额外图、视频、标签、变体、msrp、运费、仓库发货，必填信息都填上，然后调用平台接口刊登。

### 在线商品信息

拉取商品主要分为两种，拉取用户店铺的全部商品，拉取店铺的某一个商品，其主要目的是将用户店铺后台的商品或者将最新的商品信息同步到我们系统中进行管理。

#### 拉取店铺商品

##### 拉取店铺商品流程

拉取店铺商品总流程：需要拉取商品的店铺任务 --> 根据当前店铺调平台接口获取具体商品数据 --> 将数据存入数据库并提供给ERP系统进行展示

拉取店铺商品，调用 Wish平台 [List product](https://merchant.wish.com/documentation/api/v3/reference#operation/listProductsSync) 接口，然后拿到 商品List记录。

#### 拉取单个商品

##### 拉取单个商品流程

拉取单个商品流程：单个商品ID --> 根据当前店铺调平台接口获取具体商品详细数据 --> 将数据存入数据库并提供给ERP系统进行展示

根据 Wish 平台商品ID，调用平台 [Get a product ]( https://merchant.wish.com/documentation/api/v3/reference#operation/getProduct) 接口，获取单个商品的详细信息。

同步单个商品推送的地方，目前是采用批量推送，这种方式比较节省CPU，费内存，目前是60s推送一批，具体代码如下：

![image-20230824211736492](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230824211736492.png)

![image-20230824211801346](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20230824211801346.png)

### 编辑商品

编辑商品包含更新商品信息、新增变体、搜索标签、同步单个商品直调接口、商品上下架、删除商品、更新默认运费、更新商品第一英里运费、获取商品第一英里运费、物流信息、更新价格、更新库存。

法国 EPR 包括 创建EPR、更新EPR、获取EPR List、获取一个 EPR、删除EPR、关联EPR、获取关联EPR。

德国 EPR 也包括 创建EPR、更新EPR、获取EPR List、获取一个 EPR、删除EPR、关联EPR、获取关联EPR。

上面提到的这十几个接口，这些接口都是直接调用平台的。

### 拉取相关基础信息

Wish 拉取基础信息包含（品牌、颜色、货币、目的地国家、促销活动、仓库）等。

#### 拉取基础信息流程

拉取基础信息任务 --> 调用平台接口拉取对应的基础信息 --> 将基础信息保存DB并推送给PHP供刊登使用

## 三、代码线

### 刊登商品

#### 涉及项目：

- mdc-open-api-publish（刊登对外接口总控程序）（香港）
- mps-product-allproducer（定时任务总控程序）（定时刊登）（香港）
- mdc-wish-product（wish核心项目）（香港）
- mabang-push-message（推送中间程序）（香港）
- mabang-receive-message（推送中间程序）（广州）

#### 涉及到的表：

- TIDB：t_wish_task

#### 具体流程

##### 调平台接口的统一流程：

- PHP或者第三方调用中台接口，进入 mdc-open-api-publish 或者 mps-product-allproducer，校验参数，保存TIDB刊登数据表，然后把刊登ID放入RocketMQ中；
- mdc-wish-product 程序中，刊登消费者去消费 刊登消息，然后根据刊登ID去数据库查询刊登详细数据；
- 组装详细的刊登入参，必填的参数都填上；
- 然后调用平台接口，拿到返回结果，刊登ID;
- 记录刊登成功和失败结果，分别记录到对应的数据表中；
- 推送刊登结果，成功或者失败结果都推送给PHP。

##### 推送流程

刊登完成后需要推送刊登情况，首先将信息推送到 mabang-push-message 中，mabang-push-message中消费者拿到数据后再调 mabang-receive-message 接口将数据丢过去，最后再由 mabang-receive-message 推给PHP的rabbitMQ队列。

### 在线商品信息

#### 涉及项目：

- mdc-open-api-product-service（在线商品对外接口总控程序）（香港）
- mdc-wish-product（wish核心项目）（香港）
- mabang-push-message（推送中间程序）（香港）
- mabang-receive-message（推送中间程序）（广州）

#### 涉及到的表

- TIDB：t_product_shop_item （同步店铺调度中心表）
- MongoDB：tb_product （存放单个商品的商品表）

#### 具体流程

- PHP或者第三方调用中台接口，进入mdc-open-api-product-service，调用同步店铺商品，或者同步单个店铺商品接口，然后校验参数，然后将店铺信息或者需要同步的商品ID放入RocketMQ中；
- mdc-wish-product 程序中，同步店铺消费者、同步单个商品消费者去消费消息；
- 组装详细调用接口入参数据；
- 同步店铺接口，调用平台接口，然后会将单个商品ID推送到同步单个商品的RocketMQ中，同步单个商品接口会拿着商品ID去调用平台接口；
- 记录单个商品到 MongoDB 数据库;
- 推送店铺信息，推送单个商品信息给PHP；

#### 推送流程

参考上面，刊登推送流程，流程是一样的。

### 编辑商品

#### 涉及项目

- mdc-open-api-product-service（在线商品对外接口总控程序）（香港）
- mdc-wish-product（新蛋核心项目）（香港）

#### 涉及到的表

无

#### 具体流程

目前这下面列出的接口都是通过 Fegin 直调来调用对应的接口。

##### 更新商品信息

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateProduct发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateProduct接收参数 --> 并调用平台接口。

##### 新增变体

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/addProduct发送请求 --> mdc-wish-product的 Controller接口 /product/v3/addProduct接收参数 --> 并调用平台接口。

##### 搜索标签

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/searchTags发送请求 --> mdc-wish-product的 Controller接口 /product/v3/searchTags接收参数 --> 并调用平台接口。

##### 同步单个商品直调接口

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/syncProductFeign发送请求 --> mdc-wish-product的 Controller接口 /product/v3/syncProductFeign接收参数 --> 并调用平台接口。

##### 商品上架

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/productOnline发送请求 --> mdc-wish-product的 Controller接口 /product/v3/productOnline接收参数 --> 并调用平台接口。

##### 商品下架

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/productOffline发送请求 --> mdc-wish-product的 Controller接口 /product/v3/productOffline接收参数 --> 并调用平台接口。

##### 删除商品

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/deleteProduct发送请求 --> mdc-wish-product的 Controller接口 /product/v3/deleteProduct接收参数 --> 并调用平台接口。

##### 更新默认运费

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateDefaultShipping发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateDefaultShipping接收参数 --> 并调用平台接口。

##### 更新商品第一英里运费

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateFirstShippingOption发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateFirstShippingOption接收参数 --> 并调用平台接口。

##### 获取商品第一英里运费

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/getFirstShippingOption发送请求 --> mdc-wish-product的 Controller接口 /product/v3/getFirstShippingOption接收参数 --> 并调用平台接口。

##### 物流信息

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/productOffline发送请求 --> mdc-wish-product的 Controller接口 /product/v3/productOnline 接收参数 --> 并调用平台接口。

##### 更新价格

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updatePrice发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updatePrice接收参数 --> 并调用平台接口。

##### 更新库存

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateStock发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateStock接收参数 --> 并调用平台接口。

##### 法国 EPR 包括 创建EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/createUniqueNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/createUniqueNum接收参数 --> 并调用平台接口。

##### 法国 更新EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateUniqueNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateUniqueNum接收参数 --> 并调用平台接口。

##### 法国 获取EPR List

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/listUniqueNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/listUniqueNum接收参数 --> 并调用平台接口。

##### 法国 获取一个 EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/getOneUniqueNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/getOneUniqueNum 接收参数 --> 并调用平台接口。

##### 法国 删除EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/deleteUniqueNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/deleteUniqueNum接收参数 --> 并调用平台接口。

##### 法国 关联EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateProductComplianceStatus发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateProductComplianceStatus接收参数 --> 并调用平台接口。

##### 法国 获取关联EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/getProductComplianceStatus发送请求 --> mdc-wish-product的 Controller接口 /product/v3/getProductComplianceStatus接收参数 --> 并调用平台接口。

##### 德国 EPR 也包括 创建EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/createEprRegistrationNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/createEprRegistrationNum接收参数 --> 并调用平台接口。

##### 德国 更新EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateEprRegistrationNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateEprRegistrationNum接收参数 --> 并调用平台接口。

##### 德国 获取EPR List

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/listEprRegistrationNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/listEprRegistrationNum接收参数 --> 并调用平台接口。

##### 德国 获取一个 EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/getOneEprRegistrationNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/getOneEprRegistrationNum接收参数 --> 并调用平台接口。

##### 德国 删除EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/deleteEprRegistrationNum发送请求 --> mdc-wish-product的 Controller接口 /product/v3/deleteEprRegistrationNum接收参数 --> 并调用平台接口。

##### 德国 关联EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/updateGermanyProductComplianceStatus发送请求 --> mdc-wish-product的 Controller接口 /product/v3/updateGermanyProductComplianceStatus接收参数 --> 并调用平台接口。

##### 德国 获取关联EPR

调用流程：mdc-open-api-product-service 的Controller入口 /product/wish/getGermanyProductComplianceStatus发送请求 --> mdc-wish-product的 Controller接口 /product/v3/getGermanyProductComplianceStatus接收参数 --> 并调用平台接口。

### 拉取相关基础信息

#### 涉及项目

- mdc-open-api-information （基础信息对外接口总控程序）（香港服务器）
- mdc-wish-meta（wish基础信息核心项目）（香港服务器）
- mabang-push-message（推送中间程序）（香港服务器）
- mabang-receive-message（推送中间程序）（广州服务器）

#### 涉及到的表

- 品牌（mdc_wish_publish_brand）
- 颜色（mdc_wish_publish_color）
- 货币（mdc_wish_publish_currencies）
- 目的地国家（mdc_wish_publish_destination_countries）
- 促销活动（mdc_wish_publish_promotions）
- 仓库（mdc_wish_publish_warehouses）

#### 具体流程

##### 品牌

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncBrand发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_BRAND_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

##### 颜色

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncColor发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_COLOR_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

##### 货币

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncCurrencies发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_CURRENCIES_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

##### 目的地国家

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncDestination发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_DESTINATION_COUNTRIES_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

##### 促销活动

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncPromotions发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_PROMOTIONS_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

##### 仓库

调用流程：mdc-open-api-information-service 的Controller入口 /information/wish/sync/syncWarehousesConsumer发送请求 --> mdc-wish-meta 的 RocketMQ 消费者，Tipic：INFORMATION_SYNC_PRODUCT_WAREHOUSES_WISH 结束消息 --> 调用平台接口，保存对应数据库，并推送给PHP。

## 四、流程图

### 在线访问地址

> 流程图在线访问地址：https://www.processon.com/view/link/63199d02e401fd5080d03190

### 刊登商品

![image-20220908154402630](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20220908154402630.png)

![image-20220908154428606](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20220908154428606.png)

### 在线商品

![image-20220908154507422](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20220908154507422.png)

### 商品编辑

![image-20220908162319458](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20220908162319458.png)

### 拉取基础信息

![image-20220908154532019](https://happysnail.oss-cn-beijing.aliyuncs.com/Mabang/image-20220908154532019.png)