中小商家零门槛对接淘宝C店天猫通用预售系统实操技术指南

前置准备：对接前必须完成的2项基础配置

1. 注册并开通淘宝开放平台账号

访问淘宝开放平台地址 https://open.taobao.com，完成以下步骤：

• 注册企业账号：使用淘宝店铺绑定的企业支付宝注册，个人C店需升级为企业店铺或注册淘宝云码服务商账号（但中小商家推荐优先用绑定主店铺的企业支付宝）
• 创建应用：进入控制台→应用管理→创建应用，选择「自用型应用」，应用场景选「电商交易」，应用标签选「淘宝C店/天猫通用」
• 获取密钥：应用创建后30分钟内，在「应用详情→应用密钥」页面生成App Key和App Secret，请立即保存至本地加密文件夹，密钥仅显示1次

2. 完成店铺授权绑定

进入「应用详情→授权管理」，点击「获取授权码」，用主店铺淘宝账号登录授权，授权成功后获取Access Token和Refresh Token，同样保存至本地加密文件夹（Access Token有效期30天，Refresh Token有效期180天）

零代码对接：使用淘宝官方云码API测试工具验证核心接口

1. 打开淘宝云码API测试工具

访问淘宝云码官方工具地址 https://open.taobao.com/apitools/apiTools.htm?apiId=27119，自动跳转至「taobao.tbk.item.presell.add 单品预售设置」接口测试页

2. 填写接口参数并测试

请严格按顺序填写必填参数，所有参数值需替换为您的真实信息：

• App Key：粘贴前置准备中获取的自用型应用App Key
• App Secret：粘贴前置准备中获取的自用型应用App Secret
• Session：粘贴前置准备中获取的主店铺Access Token
• item_id：选择您要设置预售的商品数字ID（可在商品详情页URL中找到，例如https://detail.tmall.com/item.htm?id=1234567890中的1234567890）
• presell_start_time：设置预售开始时间，格式为YYYY-MM-DD HH:MM:SS（例如202X-12-01 00:00:00）
• presell_end_time：设置预售结束时间，格式同上，需晚于开始时间至少1小时
• presell_price：设置预售定金金额，格式为整数或保留2位小数的正数（例如19.9或50）
• presell_discount：设置尾款优惠金额，格式同上（无优惠填0）
• presell_final_pay_start_time：设置尾款支付开始时间，格式同上，需晚于预售结束时间至少1分钟
• presell_final_pay_end_time：设置尾款支付结束时间，格式同上，需晚于尾款开始时间至少1小时
• presell_type：选择预售类型，普通预售填1，阶梯预售填2（本指南仅演示普通预售）

填写完成后，点击页面底部的「提交测试」按钮，若返回以下JSON格式数据，则接口调用成功：

```json { "tbk_item_presell_add_response": { "request_id": "abcdef123456", "result": { "code": 0, "message": "success", "data": { "item_id": 1234567890 } } } } ```

低代码落地：使用Python实现批量商品预售设置

1. 环境准备

请确保电脑已安装Python 3.8及以上版本，未安装的访问Python官网下载安装包：https://www.python.org/downloads/，安装时勾选「Add Python to PATH」

2. 安装淘宝开放SDK

打开电脑终端（Windows按Win+R输入cmd，Mac按Command+空格输入Terminal），执行以下命令：

```bash pip install top-sdk-python ```

3. 编写批量设置脚本

在桌面新建一个名为「taobao_presell.py」的Python文件，右键用记事本或VS Code打开，复制以下完整代码并替换真实参数：

```python from top.api.base import TopClient from top.api import TbkItemPresellAddRequest - 替换为您的真实信息 - APP_KEY = "您的App Key" APP_SECRET = "您的App Secret" ACCESS_TOKEN = "您的主店铺Access Token" 批量设置的商品列表，格式为[[商品ID, 定金, 尾款优惠, 预售开始, 预售结束, 尾款开始, 尾款结束]] ITEM_LIST = [ [1234567890, 19.9, 5.0, "202X-12-01 00:00:00", "202X-12-10 23:59:59", "202X-12-11 00:00:00", "202X-12-15 23:59:59"], [0987654321, 50.0, 10.0, "202X-12-01 00:00:00", "202X-12-10 23:59:59", "202X-12-11 00:00:00", "202X-12-15 23:59:59"] ] - def set_presell(client, item_info): req = TbkItemPresellAddRequest() req.item_id = item_info[0] req.presell_start_time = item_info[3] req.presell_end_time = item_info[4] req.presell_price = item_info[1] req.presell_discount = item_info[2] req.presell_final_pay_start_time = item_info[5] req.presell_final_pay_end_time = item_info[6] req.presell_type = 1 try: resp = client.execute(req, session=ACCESS_TOKEN) if hasattr(resp, "tbk_item_presell_add_response") and resp.tbk_item_presell_add_response.result.code == 0: print(f"商品{item_info[0]}预售设置成功") else: print(f"商品{item_info[0]}预售设置失败：{resp.tbk_item_presell_add_response.result.message}") except Exception as e: print(f"商品{item_info[0]}接口调用异常：{str(e)}") if __name__ == "__main__": client = TopClient(APP_KEY, APP_SECRET) for item in ITEM_LIST: set_presell(client, item) ```

4. 运行脚本

打开终端，进入桌面目录（Windows输入cd Desktop，Mac输入cd ~/Desktop），执行以下命令：

```bash python taobao_presell.py ```

终端会依次显示每个商品的设置结果，若显示“预售设置成功”，可登录淘宝卖家中心→宝贝管理→出售中的宝贝，点击对应商品的「编辑宝贝」按钮，在「预售设置」模块验证配置是否正确。

常见问题及解决方案

• 问题1：接口返回code=10000，message=“权限不足”
  解决方案：检查应用是否为「自用型应用」，是否用「主店铺淘宝账号」完成授权，是否正确选择了「电商交易」场景和「淘宝C店/天猫通用」标签
• 问题2：接口返回code=20000，message=“参数格式错误”
  解决方案：检查时间格式是否为YYYY-MM-DD HH:MM:SS，金额格式是否为正数且保留最多2位小数，商品ID是否为纯数字
• 问题3：Access Token失效
  解决方案：用Refresh Token重新获取Access Token，可使用淘宝云码API测试工具的「taobao.user.session.refresh」接口
• 问题4：脚本运行后终端提示“ModuleNotFoundError: No module named 'top'”
  解决方案：重新执行pip install top-sdk-python命令，若仍失败，尝试使用国内镜像源：pip install top-sdk-python -i https://pypi.tuna.tsinghua.edu.cn/simple