速卖通刊登业务文档

# 发布商品
速卖通19版: https://developers.aliexpress.com/doc.htm?docId=108348&docType=1
速卖通22版: https://open.aliexpress.com/doc/doc.htm?nodeId=27493&docId=118729#/?docId=502

### 前言
**速卖通的所有API接口都需要通过阿里聚石塔服务器调用。**因此速卖通接口调用服务是部署在聚石塔服务器内。然后在之前老版本前提下，我司服务器和聚石塔服务器中间还插入了一个**奇门云网关**，这也是速卖通维护的。但是在**新版本中就把奇门云网关撤销**了

### 一. 刊登准备工作
1. 已申请类目和品牌权限
暂不知道在哪里申请
2. 需要的服务模板已设置好
暂不知道在哪里设置
3. 需要的运费模板已设置好
暂不知道在哪里设置
4. 需要的尺码模板已设置好(可选)
暂不知道在哪里设置

### 二. 类目及属性
1. 类目
刊登商品的时候，是需要设置商品的类目id。因此需要把速卖通所有的类目都获取到并形成一颗树。调用接口的时候最开始的**第一级类目id是0**，后续就跟着返回的类目id作为参数进行递归查询

2. 属性
确定类目之后，通过上述类目id去获取对应类目属性。属性分为SKU属性和一般属性。SKU属性和一般属性分别放在aeop_ae_product_s_k_us 和 aeop_ae_product_propertys两个字段里面。然后获取类目属性的结果分别通过required和sku字段来确定是否必填，是否SKU属性
```json
{
      ...
      "spec": 2, ? <-- 对SKU属性很重要！
      "required": false,    <-- 重要！
      "keyAttribute": false,    <-- 重要！
      "sku": false,    <-- 重要！
      "id": 196,    <-- 重要！
      "values": [
        {
          "id": 134,
          "names": {
            "zh": "交流",
            "en": "AC"
          }
        },
        ...
      ],
      "names": {
        "zh": "输出类型",
        "en": "Output Type"
      },
      "inputType": "STRING",
      "attributeShowTypeValue": "list_box"
    }
```

required：这个属性对当前类目来说是否是必须的，如果是必须的，不填会导致发布商品失败。
sku：这个属性是否是SKU属性，非SKU属性又称为一般属性。
spec: 发布商品时，每个SKU里SKU属性的排列顺序很重要。如果一个商品的SKU由多个SKU属性组合而成，那么它们必须按照该SKU属性的spec值按升序排列

### 三. 图片更替流程
1. 图片
发布商品时，上传数据里面所有携带图片url的字段都要替换成速卖通的域名。而这就需要分别从各个字段里面去获取图片url地址，然后重新上传到速卖通图片银行里面拿到返回的速卖通地址进行替换。**注意: 图片银行是有容量限制的，需要运营每隔一个周期去审查一下容量或申请扩容**

2. 视频
以前的速卖通是不支持直接上传视频的，都需要在后台去手动建一个视频商品，然后在发布真正商品的时候去获取视频商品详情里的视频id，最后进行发布。现在新版就提供了API, 发布完商品以后通过新增商品主图短视频API进行更新，把短视频url(也需要转成速卖通域名)直接发布到商品上。

### 四. 刊登流程

![](https://amazon-professionnal-1253885479.cos.ap-hongkong.myqcloud.com/20221026/sync_1666752242849.png)

### 五. 遗留问题
1. Redis任务如何触发
2. 车模检测
3. 各个模板如何设置
4. 币种权限
5. 奇门云地址
6. 聚石塔地址

该文档未编写完毕, 暂目前只是结合小部分理解