美客多up 模式刊登

### 刊登接口
请求参数

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
|family_name  | 商品名称 | 否  |   up 必填|
|category_id  | 目录id | 是 |  |
| currency_id | 币种id | 是 |  |
| available_quantity | 可用数量 | 是 |  |
| sale_terms | 销售条款 | 是 |  |
| buying_mode | 购买模式 | 是 |  |
| listing_type_id | 上市类型，对于全球站点，此值始终为gold_pro | 是 |  |
| condition | 商品状态 新,二手，由分类决定 | 是 |  |
| pictures | 图片 | 是 |  |
| attributes | 分类属性参数 | 是 |  |

返回参数

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
|  id| 商品id |  |  |
|  user_product_id| 用户商品id |  |  |

### 同步在线商品列表(保持一致)

```java
curl -X GET https://api.mercadolibre.com/users/1234/items/search?user_product_id=MLBU206642488 -H 'Authorization: Bearer $ACCESS_TOKEN'

{
   "seller_id": "1234",
   "results": [
       "MLB664681522",
       "MLB664648534",
       "MLB664648532",
       "MLB664635674"
   ],
   "paging": {
       "limit": 50,
       "offset": 0,
       "total": 4
   },
   "query": null,
   "orders": [
       … 
   ],
   "available_orders": [
      …
   ]
}

```

### 同步在线商品接口
请求参数

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
| user_product_id | 商品 id |  |  |

返回参数

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
| name | 商品 名称|  |  |
| user_id | 用户id|  |  |
| domain_id | domain_id|  |  |
| attributes | 属性|  |  |
| pictures | 图片|  |  |
| thumbnail | 缩略图|  |  |
| catalog_product_id | 目录产品id|  |  |
| family_id | family_id|  |  |
| tags | tags|  |  |

### 基础信息接口
```html
类目推荐：mdc-open-api-information-service/information/mercadolibre/getCategoryRecommendation
保修信息：mdc-open-api-information-service/information/mercadolibre/getProductWarranty
刊登类型：mdc-open-api-information-service/information/mercadolibre/getListingTypeByCategory
刊登费用：mdc-open-api-information-service/information/mercadolibre/getListingPrices
尺码表模板：mdc-open-api-information-service/information/mercadolibre/getChartsList

刊登类型，保修信息：这两个7天一次
刊登费用：页面刷新就会触发
尺码表模板：页面刷新触发或者客户手动触发
类目推荐：客户手动触发
```
### 编辑接口
1. 编辑本土商品

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
|family_name  |商品目录  |  否|  |
| productId | 本土商品id |  必填 |根据productId 进行更新  |
| deleted | 是否删除，true：删除，false，不删除 |否  |  |
| channels | 销售渠道 |否  |  |
| title | 商品标题 |否  |  |
| video_id | 视频URL |否  |  |
| attributes | 商品属性 |否  |  |
| pictures | 商品图片 |否  |  |
| price | 商品价格 |否  |  |
| listing_type_id | 刊登类型 |否  |  |
| status | 商品状态 |否  |  |
| available_quantity | 库存 |否  |  |
| sale_terms | 保修类型 |否  |  |

2. 编辑本土商品描述

| 字段 | 名称 | 是否必填 | 备注 |
| --- | --- | --- | --- |
| productId |本土商品id  |  是 | 根据productId 进行更新 |
| plain_text | 商品描述 | 否 |  |

up 模式SQL （ 表名添加下划线）

```sql
CREATE TABLE `db_mercado_up_task` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
`company_id` int(11) NOT NULL DEFAULT '0' COMMENT '企业编号',
`shop_id` int(11) NOT NULL DEFAULT '0' COMMENT '店铺编号',
`family_name` varchar(500) NOT NULL DEFAULT '' COMMENT 'family_name系列名称',
`category_id` varchar(30) NOT NULL DEFAULT '' COMMENT '类目ID',
`attributes` text COMMENT '类目属性',
`description` text COMMENT '描述',
`buying_mode` varchar(50) NOT NULL DEFAULT '' COMMENT '购买模式',
`video_url` varchar(500) NOT NULL DEFAULT '' COMMENT '上传视频链接，必须添加 YouTube 视频链接',
`sale_terms` text COMMENT '质保信息',
`warranty` varchar(255) NOT NULL DEFAULT '' COMMENT '保修期信息',
`shipping` text COMMENT '物流信息',
`has_variation` tinyint(1) NOT NULL DEFAULT '2' COMMENT '是否是变体 1:是 2:否',
`currency` varchar(10) NOT NULL DEFAULT '' COMMENT '币种',
`site` varchar(10) NOT NULL DEFAULT '' COMMENT '站点',
`size_grid_id` varchar(50) NOT NULL DEFAULT '' COMMENT '尺码表id',
`state` tinyint(1) NOT NULL DEFAULT '2' COMMENT '是否可以刊登：1、是 2、否',
`flag` tinyint(3) NOT NULL DEFAULT '1' COMMENT '状态：1.待刊登 2.刊登中 6.刊登失败 7.部分子商品刊登失败 8:描述发布失败 9.刊登成功',
`is_timing` tinyint(1) NOT NULL DEFAULT '2' COMMENT '是否定时刊登 1是 2否',
`votobo_id` varchar(100) NOT NULL DEFAULT '' COMMENT '来源数据id',
`votobo_id_type` varchar(255) NOT NULL DEFAULT '' COMMENT '来源数据类型',
`votobo_id_platform` varchar(255) NOT NULL DEFAULT '' COMMENT '来源数据信息',
`source_url` varchar(500) NOT NULL DEFAULT '' COMMENT '来源url',
`remark` text COMMENT '备注',
`family_id` bigint(20) NOT NULL DEFAULT '' COMMENT 'family_id系列ID',
`user_product_id` varchar(100) NOT NULL DEFAULT '' COMMENT '用户商品id',
`product_id` varchar(100) NOT NULL DEFAULT '' COMMENT '商品id',
`error_reason` text COMMENT '错误信息',
`cecter_request_id` varchar(50) NOT NULL DEFAULT '' COMMENT '中台ID',
`sale_rule_id` int(11) DEFAULT NULL COMMENT '售价公式id',
`create_operate_id` int(11) DEFAULT NULL COMMENT '创建人',
`update_operate_id` int(11) DEFAULT NULL COMMENT '更新人',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
`max_quantity` int(11) NOT NULL DEFAULT '0' COMMENT '最大库存',
`min_quantity` int(11) NOT NULL DEFAULT '0' COMMENT '最小库存',
`max_price` decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '最大价格',
`min_price`decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '最小价格'
PRIMARY KEY (`id`),
KEY `idx_csf_id` (`company_id`,`shop_id`) COMMENT '企业店铺索引'
) COMMENT '美克多UP草稿表';

```

```sql
CREATE TABLE `db_mercado_up_task_variation` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
`company_id` int(11) NOT NULL DEFAULT '0' COMMENT '企业编号',
`shop_id` int(11) NOT NULL DEFAULT '0' COMMENT '店铺编号',
`task_id` bigint(20) NOT NULL DEFAULT '0' COMMENT '草稿主键',
`sku` varchar(255) NOT NULL DEFAULT '' COMMENT 'sku',
`channels` varchar(50) NOT NULL DEFAULT '0.00' COMMENT '渠道',
`listing_type_id` varchar(50) NOT NULL DEFAULT '' COMMENT '刊登类型',
`price` decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '价格',
`available_quantity` int(11) NOT NULL DEFAULT '0' COMMENT '可用库存',
`pictures` text COMMENT '图片',
`attributes` text COMMENT 'sku属性如gtin sku 主要是刊登用',
`attribute_combinations` text COMMENT '变体属性',
`bar_code` varchar(50) NOT NULL DEFAULT '' COMMENT '商品条码 upc ean gtin',
`package_length` int(10) DEFAULT NULL COMMENT '包裹长度',
`package_width` int(10) DEFAULT NULL COMMENT '包裹宽度',
`package_height` int(10) DEFAULT NULL COMMENT '包裹高度',
`package_weight` decimal(10,2) unsigned DEFAULT NULL COMMENT '包裹重量',
`weight_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '重量单位 默认:g',
`size_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '尺寸单位 默认:cm',
`size_grid_row_id` varchar(100) NOT NULL DEFAULT '' COMMENT '尺码表行id',
`flag` tinyint(3) NOT NULL DEFAULT '1' COMMENT '状态：1.待刊登 2.刊登中 6.刊登失败 7.部分子商品刊登失败 8:描述发布失败 9.刊登成功',
`error_reason` text COMMENT '错误信息',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_cs_id` (`company_id`,`shop_id`) COMMENT '企业店铺索引',
KEY `idx_cst_id` (`company_id`,`shop_id`,`listing_type_id`) COMMENT '企业店铺刊登类型索引',
KEY `idx_cid_tid` (`task_id`) COMMENT '主表id索引'
)COMMENT '美克多UP草稿子表';

todo 需要把香港中台的cecter_request_id回写进去，根据这个id 来更新
```
todo 同步在线商品需要考虑新老版本并行情况如何处理
```sql
CREATE TABLE `db_mercado_up_online` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
`company_id` int(10) NOT NULL DEFAULT '0' COMMENT '企业编号',
`shop_id` int(10) NOT NULL DEFAULT '0' COMMENT '店铺编号',
`family_id` bigint(20) NOT NULL DEFAULT '' COMMENT 'family_id系列ID',
`user_product_id` varchar(100) NOT NULL DEFAULT '' COMMENT '用户商品id',
`product_id` varchar(100) NOT NULL DEFAULT '' COMMENT '商品id',
`sku` varchar(255) NOT NULL DEFAULT '0' COMMENT 'sku',
`family_name` varchar(500) NOT NULL DEFAULT '' COMMENT 'family_name系列名称',
`title` varchar(500) NOT NULL DEFAULT '' COMMENT '标题',
`category_id` varchar(50) NOT NULL DEFAULT '' COMMENT '分类ID',
`listing_type_id` varchar(50) NOT NULL DEFAULT '' COMMENT '刊登类型',
`price` decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '价格',
`available_quantity` int(10) NOT NULL DEFAULT '0' COMMENT '可用库存',
`thumbnail` varchar(500) NOT NULL DEFAULT '' COMMENT '缩略图',
`pictures` text COMMENT 'sku图',
`attributes` text COMMENT '商品属性包含变体属性',
`descriptions` text COMMENT '描述',
`site` varchar(10) NOT NULL DEFAULT '' COMMENT '站点',
`channels` varchar(50) NOT NULL DEFAULT '' COMMENT '销售渠道',
`product_status` varchar(50) NOT NULL DEFAULT '' COMMENT '商品在线状态',
`sub_status` varchar(255) DEFAULT NULL COMMENT '商品子状态',
`buying_mode` varchar(50) NOT NULL DEFAULT '' COMMENT '购买模式',
`goods_condition` varchar(50) NOT NULL DEFAULT '' COMMENT '物品状况',
`currency` varchar(10) NOT NULL DEFAULT '' COMMENT '币种',
`sale_terms` text COMMENT '质保信息',
`warranty` varchar(255) NOT NULL DEFAULT '' COMMENT '保修期信息',
`video_url` varchar(500) NOT NULL DEFAULT '' COMMENT '视频',
`shipping` text COMMENT '物流信息',
`size_grid_id` varchar(50) NOT NULL DEFAULT '' COMMENT '尺码表id',
`size_grid_row_id` varchar(100) NOT NULL DEFAULT '' COMMENT '尺码表行id',
`charts_detail` longtext COMMENT '尺码详情',
`tags` varchar(500) NOT NULL DEFAULT '' COMMENT '商品提示标签',
`bar_code` varchar(50) NOT NULL DEFAULT '' COMMENT '商品条码 upc ean gtin',
`package_length` int(10) DEFAULT NULL COMMENT '包裹长度',
`package_width` int(10) DEFAULT NULL COMMENT '包裹宽度',
`package_height` int(10) DEFAULT NULL COMMENT '包裹高度',
`package_weight` decimal(10,2) unsigned DEFAULT NULL COMMENT '包裹重量',
`weight_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '重量单位 默认:g',
`size_unit` varchar(10) NOT NULL DEFAULT '' COMMENT '尺寸单位 默认:cm',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '马帮创建时间',
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '马帮修改时间',
`create_timel` datetime DEFAULT NULL COMMENT '平台创建时间',
`update_timel` datetime DEFAULT NULL COMMENT '平台修改时间',
`create_oper_id` int(11) NOT NULL DEFAULT '0' COMMENT '创建人',
`update_oper_id` int(11) NOT NULL DEFAULT '0' COMMENT '修改人',
`claim_status` tinyint(1) NOT NULL DEFAULT '2' COMMENT '认领状态 1是2否',
`stock_sku` varchar(200) DEFAULT NULL COMMENT '匹配的库存SKU',
`stock_type` tinyint(3) NOT NULL DEFAULT '2' COMMENT 'SKU类型:1、组合sku 2、库存sku',
`stock_match_status` tinyint(3) NOT NULL DEFAULT '1' COMMENT '库存SKU匹配状态 1、未匹配 2、待确认 3、已匹配',
`operation_type` tinyint(3) NOT NULL DEFAULT '2' COMMENT '商品状态 1、确认不同步 2、解除不同步',
`source_url` varchar(500) NOT NULL DEFAULT '' COMMENT '来源url',
`remark` text COMMENT '备注',
`sold_quantity` int(10) NOT NULL DEFAULT '0' COMMENT '销量',
`permalink` varchar(1000) NOT NULL DEFAULT '' COMMENT '商品链接',
PRIMARY KEY (`id`),
KEY `idx_csp_id` (`company_id`,`shop_id`,`product_id`) COMMENT '企业店铺商品id索引',
KEY `idx_csf_id` (`company_id`,`shop_id`,`site`) COMMENT '企业店铺站点索引',
KEY `idx_csf_id` (`company_id`,`shop_id`,`listing_type_id`) COMMENT '企业店铺刊登类型索引',
KEY `idx_cs_id` (`company_id`,`stock_sku`) COMMENT '企业库存sku索引'
) COMMENT '美客多UP在线商品表';

```
### 香港中台sql 调整
```sql
ALTER TABLE `mdc_product_task`.`mps_mercadolibre_local_task` 
ADD COLUMN `family_id` bigint(11) NOT NULL DEFAULT 0 COMMENT 'family_id' AFTER `update_time`,
ADD COLUMN `family_name` varchar(255) NOT NULL DEFAULT '' COMMENT 'family_name' AFTER `family_id`,
ADD COLUMN `user_product_id` varchar(255) NOT NULL DEFAULT '' COMMENT 'user_product_id(比family_id 低一级，但又比product_id 高一级)' AFTER `family_name`,
ADD COLUMN `relate_task_id` bigint(11) NOT NULL DEFAULT 0 COMMENT '用该字段判断是否是同一个商品(跟平台返回的 family_id 1 比 1)' AFTER `user_product_id`;

todo 除了业务逻辑以外类参考 ozon 来处理。
```

todo 在请求通道平台的时候，香港中台需要根据一个relate_task_id for 循环请求刊登接口，然后把一组里面的 10 条数据都消化处理完再推送消息到广州服务。