Mercadolibre 全球、本土业务说明文档

# Mercadolibre 调度中心 业务文档

## 一、Mercadolibre 平台接口文档

> 全球接口文档：https://global-selling.mercadolibre.com/devsite/items-and-searches-global-selling、
>
> 本土接口文档（需要哪个国家，找对应国家国旗）：https://developers.mercadolibre.com/

## 二、业务线

### 刊登商品

#### 全球刊登

全球刊登流程：

- 刊登全球商品

- 发布到各个站点（墨西哥、巴西、哥伦比亚、智利）
- 发布站点商品描述

#### 本土刊登

本土刊登流程：

- 刊登本土
- 发布本土描述

#### 刊登注意事项

- 刚刊登完全球商品，马上发布站点商品的时候，会报错 `is not a cbt item`，这种情况在发布站点商品代码中有重新丢入队列，重新发布操作，直到发布完成。
- 全球刊登结果推送，里面分三部分内容：全球刊登结果、发布站点结果、发布站点描述结果。
- 具体代码如何区分？global下面的是全球刊登消费者、local下面是本土刊登

### 在线商品信息

#### 全球

全球商品拉取流程：

- 调用全球店铺商品列表
- 获取全球单个商品
- 获取全球商品和站点商品映射关系，查到全球商品对应的站点商品
- 获取站点单个商品

#### 本土

本土商品拉取流程：

- 调用本土商品列表接口
- 获取本土单个商品接口

注意事项：

- 全球、本土店铺商品拉取都要区分1000个商品以上、以下，接口不一样
- 全球、本土商品拉下来需要把图片处理为800 * 800 大小
- 全球、本土商品需要单独调用描述接口，获取描述
- 总之：商品详情需要调用接口非常多，接口都有5次重试，如果还是失败，要捕获异常，不能影响调用下一个接口获取数据。

### 编辑商品

#### 全球

全球编辑包括：

- 修改全球商品详情
- 修改站点商品详情
- 修改站点商品描述

#### 本土

本土编辑包括：

- 编辑本土商品详情
- 编辑本土商品描述

### 拉取相关基础信息

#### 全球、本土

基础信息包括：

- 一级类目拉取
- 二级类目拉取
- 属性拉取

#### 注意事项：

- 美客多基础信息全球和本土接口一样，类目和类目属性只需要传不同站点即可

## 三、代码线

### 刊登商品

#### 涉及项目：

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

#### 涉及到的表：

- TIDB：mps_mercadolibre_task (全球刊登表)
- TIDB：mps_mercadolibre_publish_task (全球发布站点表)
- mps_mercadolibre_local_task (本土刊登表)

#### 具体流程

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

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

##### 推送流程

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

### 在线商品信息

#### 涉及项目：

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

#### 涉及到的表

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

#### 具体流程

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

#### 推送流程

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

### 编辑商品

#### 涉及项目

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

#### 涉及到的表

无

#### 具体流程

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

### 拉取相关基础信息

#### 涉及项目

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

#### 涉及到的表

- mps_mercadolibre_category_attributes （类目属性表）
- mps_mercadolibre_category （类目表）

## 四、流程图

### 在线访问地址

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

### 刊登

### 在线商品

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

### 基础信息拉取

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