陈俊安-mercadolibre交接

# # 官方文档地址
```
// 本土刊登、广告
https://developers.mercadolibre.com/
```
# # 负责的产品
李珣

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

# # 流程
美客多主要负责广告和本土刊登广州程序的处理逻辑。

![](/media/202308/2023-08-28_110343_1860090.8372533263364115.png)

1、广告
广告业务的广州程序直接对接的前端，接口在 `mdc-mercadolibre-product` 项目的 `MercadolibreCampaignController` 中，提供了以下五个接口：
```
1）商品列表：分类查询商品列表，支持单个企业下的多个店铺同时查询
2) 获取支持站点：返回支持的站点
3) 获取店铺信息：获取当前企业的店铺
4) 同步店铺指标：目前只是我们自己内部使用，未开放给客户
5) 手动同步店铺商品
```

同步指标的接口目前是异步的，因此不能重复调用。用户我们内部给客户补拉数据使用的。又杨磊改进后，支持多企业多店铺拉取，内部会异步进行企业和店铺分组同步日期区间内的指标数据。

2、本土刊登
`mdc-mercadolibre-product` 项目中包含分类同步、分类属性同步、刊登、同步店铺商品、获取刊登结果等业务。
2.1 刊登
PHP 通过 `mdc-iapi-product` 项目中的公共创建商品接口提交任务ID给我们广州的程序，我们读取任务数据组装为中台接口的格式请求中台，拿到中台ID保存到刊登任务表。

2.2 同步店铺商品/同步单个商品
内部：
同步店铺商品：```MercadolibreSyncShopProductPublicConsumer```
同步单个商品：```MercadolibreSyncProductPublicConsumer```

外部（香港推送）：
单个商品详情：```SyncProductResultConsumerPublic```
单个商品详情（页面点击）：```SyncSingleProductResultConsumerPublic```

香港推送的店铺推送结果也在单个商品推送的队列中，只是通过actionType 字段做区分，如果值为shop_update，则是店铺同步结果的消息，其他则为商品详情消息

![](/media/202308/2023-08-28_110837_6292730.4891388344779558.png)

3、定时任务

![](/media/202308/2023-08-28_111228_9075510.8170069758185187.png)

3.1 刊登结果获取
用于处理长时间卡刊登中的任务，如果没有收到刊登结果的推送则主动向中台获取，但是只会处理24小时之内卡刊登中的。

3.2 指标数据同步
当天只会获取昨天的指标数据。

3.3 店铺活动同步
每天拉取店铺活动数据及其活动下商品数据。