3. 淘宝 / 天猫
本篇从淘宝 / 天猫的商品准备讲到配置、发布和结果处理，按顺序完成即可。先完成2. 飞书连接，确认店智效能读到商品表字段。首次只用一个货号，先放入仓库，检查正确后再扩大批次。
1.1 商品准备
1.1.1 确认店铺
在店智效客户端中选中这家店铺，确认会员可用、店铺已绑定，平台、店铺名和店铺 ID 与商家后台当前登录的店铺一致。进入该店铺的“店铺工具 → 自动上新”，先在“配置”页完成飞书连接，看到正确的数据表和字段。
1.1.2 整理资料
一个货号代表一款商品，同款的颜色、尺寸等每一种实际组合为一个 SKU。飞书一行放一个 SKU，同款各行重复填写同一货号；商品级的标题和类目保持一致，价格和库存按各行实际情况填写。
| 货号 | 标题 | 类目 | 颜色 | 尺寸 | SKU 编码（选填） | 售价 | 库存 |
|---|---|---|---|---|---|---|---|
| SP-001 | 示例商品标题 | 本平台实际末级类目 | 黑色 | 小号 | SP-001-01 | 12.90 | 100 |
| SP-001 | 示例商品标题 | 本平台实际末级类目 | 黑色 | 大号 | SP-001-02 | 15.90 | 80 |
以上仅为结构示例。按实际商品填写，不生成不存在的规格；同款规格组合不能重复。SKU 编码为选填项，不使用时可以不建这一列；需要使用时再单独建列，不能代替货号。 价格不带“元”，货号、规格、售价等必填资料每行都要有值。两个平台共用商品表时，可以分别建平台标题、类目、售价列，映射到本平台对应列。
1.1.3 准备图片
选择本地素材时，选的是包含本批各货号文件夹的总目录，不是某一款的目录，也不是装着全部历史批次的大目录。
下图展示打开一个货号文件夹后的素材结构：数字命名的主图放在根目录，SKU 图、详情图分别放入对应子文件夹。“3比4”文件夹用于选填的 3:4 主图，不是必需素材。
文件夹名称必须与飞书货号完全相同。当前选择“未上传素材库”时，店智效会读取总目录下一层的全部货号文件夹，并自动使用“按素材货号”，所以总目录里只放本次要发的款。
货号目录根部按 1～5 数字命名准备五张主图，“详情”子文件夹至少一张。颜色等图片规格需要 SKU 图；只有尺码等不支持图片的规格时，可不设 SKU 图目录。同色多尺码共享同一颜色图，图片要与实际规格值对应，不能把所有颜色图混给每一行。
天猫按类目要求准备透明图，淘宝白底图按页面支持选填。3:4 主图为选填：有素材则上传；没有 3:4 图片或“3比4”文件夹为空时跳过，不会因缺少 3:4 图片报错。 如需提供，放在“3比4”子文件夹，按 1～5 编号，尺寸至少 750×1000。可选视频放在货号根目录或“视频”子文件夹，每款最多五个；没有视频可先不准备。
图片已在当前店铺素材库时，选择“已上传素材库”，每个货号应对应唯一且正确的素材目录，不再重复上传本地图片。已有图片模式也可单独选择“本地视频地址（选填）”。
先拿一个货号检查：飞书能找到全部 SKU、货号与素材名称一致、规格图片对应正确、售价库存准确。准备完成后再配置类目。
1.2 商品配置
1.2.1 基本字段
打开“淘宝／天猫 → 自动上新 → 配置”，在“固定配置”选择飞书中对应的列：
| 项目 | 选择什么 |
|---|---|
| 标题 | 当前平台使用的完整商品标题列 |
| 货号 | 同款 SKU 共用的货号列，与素材文件夹名称一致 |
| 类目 | 实际末级类目名称或完整类目路径列 |
| 店铺分类 | 本店分类列；不需要时留空 |
平台类目决定必填属性与发布表单；店铺分类只用于店内归类，二者不能互相代替。
1.2.2 类目属性
- 在“动态配置”点击“新增类目”，选到商品真实所属的最末一级。
- 读取当前类目的属性与模板；已有配置需要刷新时使用“更新类目资料”。
- 按红色必填标记补齐品牌、商品属性、SKU 和物流模板。
- 飞书类目值与保存的类目保持一致。同名末级类目有多个路径时，使用完整路径。
每个属性使用一种来源：各款不同的材质、风格等选择“飞书字段”；这份类目下确实相同的属性选择“固定值”。选择一侧会清空另一侧。
品牌必须选本店有权发布的真实选项；“无品牌”只有平台允许时才能使用。淘宝、天猫以及不同类目的可用属性可能不同，以当前店铺实际读取到的选项为准。
1.2.3 规格价格
- 销售规格 ：启用商品实际使用的颜色、尺码等规格，分别映射对应字段。必填规格要完整，启用的可选规格也要保证每行有值。
- 价格 ：选择实际售价列，每个 SKU 都要有有效数字。
- 库存 ：相同库存可填固定非负整数，不同库存选飞书列。固定 100 表示每个 SKU 为 100，不是整款合计 100。
- 商家编码（SKU 编码，选填） ：需要管理规格编码时映射自己的 SKU 编码列；它与颜色、尺码等销售规格分开，不代替货号。其他带必填标记的参数按类目要求配置。
- 图片 ：启用图片规格时检查每个颜色与 SKU 图的对应关系；同色不同尺码共用同一张颜色图。
类目提供单一自定义规格和标准多规格两种模式时，选择符合商品的一种。只使用飞书实际存在的规格组合，不拼出没有库存或素材的 SKU。
1.2.4 物流保存
淘宝选择本店“运费模板”，天猫选择本店“物流信息模板”，核对收费方式。按重量计费时填写平台要求的重量，注意字段单位，不把克数直接填入 kg 字段。
模板被删除或改名后重新选择。补齐必填项后保存类目及其余配置，再通过“编辑”重新打开，确认映射、规格、库存和模板都已保存。
1.3 批量上新
1.3.1 素材货号
进入“商品发布”，先选素材来源，再确认本次范围：
| 素材来源 | 怎么选择货号 |
|---|---|
| 未上传素材库 | 选择包含各货号文件夹的本批总目录；店智效自动使用“按素材货号”，读取下一层全部货号文件夹 |
| 已上传素材库 | 确认每个货号有唯一正确的素材目录，再选择“起止范围”或“指定货号” |
本地素材模式下，“起止范围”和“指定货号”会禁用。发现多出不准备发布的款，重新选择正确目录。已经上传图片但需要本地视频时，可另选“本地视频地址（选填）”。
已有素材模式中，连续编号可用起止范围，例如 SP-001 至 SP-020，两端前缀相同；零散款使用指定货号，一行一个或逗号分隔。范围内缺资料的款也会被检查并报告。飞书视图筛选不决定本次发布范围。
1.3.2 上架方式
| 上架位置 | 使用方式与结果 |
|---|---|
| 立刻上架 | 接口或流程上架；提交后确认到出售中 |
| 定时上架 | 当前使用流程上架，填写并核对日期、时间 |
| 放入仓库 | 接口或流程上架；先入仓库，便于检查后自行安排上架 |
这里没有独立“草稿箱”选项，想先检查请选择“放入仓库”。成功表示商品已确认到所选位置，并不表示全部在出售中。
接口上架由店智效准备资料并提交，流程上架会打开平台发布页填写、检查后提交；两种方式都是真实发布。
1.3.3 开始执行
- 核对店铺、飞书数据表、素材模式、货号数量、上架位置与方式。
- 定时上架再次核对日期和时间。
- 点击“立即发布”，查看当前货号与日志。
- 店智效先检查本批飞书 SKU 资料，再逐货号检查素材、类目、属性和销售信息，通过后提交。
普通单款资料错误会记录原因，其余有效款继续。登录失效、店铺身份变化或安全验证会停止整批。执行期间保持客户端和当前店铺登录可用，不切换账号、不干预正在填写的发布页。
1.4 结果与重试
1.4.1 看逐款记录
任务日志按货号显示时间、上架位置、方式、用时、执行结果和失败原因。一个批次可能同时出现成功、失败和待确认，逐行检查，不能只看顶部汇总。日志的上架位置是任务启动时的选择，后来修改页面选项不会改变旧记录。
| 结果 | 含义与下一步 |
|---|---|
| 发布成功 | 已按本次商品 ID 确认到所选位置；“放入仓库”也可能显示成功，到对应位置抽查 |
| 已提交，待核验 | 已取得提交回执，等待或尚未完成目标列表核对，先保留记录 |
| 待确认 | 提交或结果查询尚不明确，先核对原提交，不再创建一次 |
| 失败 | 阅读当前货号的具体原因，区分资料问题和平台状态问题，并先确认是否已提交 |
| 发布成功，素材待补传 | 商品已经发布，处理该商品的可选媒体问题，不重建整款商品 |
抽查标题、主图、SKU 图、规格价格、库存、类目及物流。在销售中找不到时，先看这次选的位置是否为仓库或定时上架。
1.4.2 核验原提交
平台可能已经创建商品，只是返回信息或列表查询暂时失败；此时重发同一个货号可能创建第二份。优先使用可用的“重新核验”，它查询原商品 ID 对应的目标列表，不再次读取飞书、上传图片或提交。
仍无法确认时，保留原记录、商品 ID 和失败原因，到当前店铺对应列表核对。不要清空日志、换提交方式或连续点击发布来绕过不确定结果。
1.4.3 修正失败原因
| 出错环节 | 处理位置 |
|---|---|
| 飞书货号或字段缺失 | 检查所选数据表、货号写法、同款全部 SKU 与应用权限；字段改动后重新读取并核对映射 |
| 类目、属性、品牌不匹配 | 回到本平台“配置”，检查实际类目和当前店铺可用选项，补齐必填项后保存 |
| 规格重复、价格库存无效 | 修正飞书对应行，确保组合唯一、售价为有效数字、库存符合本平台要求 |
| 图片缺失或不匹配 | 核对货号层级、主图和详情数量、SKU 对应关系、已有目录的唯一性 |
| 物流或重量错误 | 检查当前类目的物流类型、有效模板及所需重量；不要用另一店铺的模板 |
| 登录失效或安全验证 | 停止后先处理当前店铺登录与验证，再核对已经提交的货号；不会自动续跑 |
流程上架留下失败页面时，同时查看平台对具体字段的提示。关闭页面不能代替修正资料。
1.4.4 重试失败款
确认该货号未成功提交、问题已经修正后再放入下一批。已上传素材库模式可用“指定货号”只填这些款；本地素材模式选择仅包含这些款的本次总目录，重新核对数量。保留原始素材和成功商品资料，不为缩小范围删除原文件。
“停止任务”阻止后续步骤和新货号，不撤销已提交的商品；已经发出的提交先等结果。“全部清除”重置界面状态和日志，不会删除平台商品，也不会取消待确认提交的必要保护。