4. 1688
本篇从1688的商品准备讲到配置、发布和结果处理，按顺序完成即可。先完成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 准备图片
选择本地素材时，选的是包含本批各货号文件夹的总目录，不是某一款的目录，也不是装着全部历史批次的大目录。
1688 的主图、SKU 图和详情图统一准备为 JPG（.jpg）格式，单张不超过 5 MB。 已有 PNG 等图片须实际另存或导出为 JPG，不能只修改文件扩展名。
下图展示打开一个货号文件夹后的素材结构。图中是转换前的 PNG 素材，上传前请先转成 JPG。
文件夹名称必须与飞书货号完全相同。当前选择“未上传素材库”时，店智效会读取总目录下一层的全部货号文件夹，并自动使用“按素材货号”，所以总目录里只放本次要发的款。
主图放在货号目录根部，至少五张；SKU 图片放入“SKU”子文件夹，详情图片放入“详情”子文件夹，详情至少一张。以上图片均使用 JPG 格式。原生页面使用四个主图槽和一个白底槽时，第五张图片用于白底槽，要按实际要求准备。
3:4 主图为选填素材，不是必需项。 有需要时放在货号目录的“3比4”子文件夹，同样使用 JPG 格式，1:1 主图继续放在货号根目录。
- 类目支持 3:4，且有 3:4 素材： 默认优先使用 3:4，同时上传 1:1 主图。
- 没有 3:4 素材，或“3比4”文件夹为空： 使用并上传 1:1 主图，不会因缺少 3:4 图片报错。
- 类目不支持 3:4，即使有 3:4 素材： 自动跳过 3:4 图片，不报错，只上传并使用 1:1 主图。
SKU 图按当前启用的图片规格或 SKU 顺序对应。同色多尺寸共用颜色图；按编号准备时核对店智效实际采用的 SKU 顺序（有编码按编码、无编码按 SKU 名称排序），按规格值准备时核对该值首次出现顺序，不能只看资源管理器当前排序。
图片已经在 1688 图片空间时，选“已上传素材库”，按货号查找唯一同名相册。自己整理的相册按“主图-1～主图-5”“SKU-1、SKU-2……”和“详情-1、详情-2……”连续命名，不缺号、不重名。由店智效上传并保留完整记录的素材，按原文件对应关系核验。
先拿一个货号检查：飞书能找到全部 SKU、货号与素材名称一致、规格图片对应正确、售价库存准确。准备完成后再配置类目。
1.2 商品配置
1.2.1 基本字段
进入“1688 → 自动上新 → 配置”，对应好标题、货号与类目：
| 项目 | 填写原则 |
|---|---|
| 标题 | 选择适用于 1688 的商品标题列 |
| 货号 | 同款 SKU 共用，与素材文件夹或相册名称一致 |
| 类目 | 对应本平台已保存的末级类目名称或完整路径 |
| 店铺分类 | 选填，本店分类，与平台发布类目分开 |
1.2.2 类目属性
- 在“动态配置”点击“新增类目”，选到商品真实所属的最末一级。
- 读取属性，按红色必填标记补齐。
- 不同商品值不同的属性选择“飞书字段”，确实相同的属性选择“固定值”；选择一侧会清空另一侧。
- 父属性影响后续项目时，选好后点击“更新类目属性”，再填写新出现的项目。
固定选项从平台读取的列表中选，只有允许自定义的项目才输入文字。同名末级类目有多条路径时，在飞书使用完整路径。
1.2.3 规格单位
- 规格 ：启用真实的颜色、尺寸等规格，各行有对应值，不能出现重复组合。
- 价格 ：映射 1688 售价列，第一档价格与规格价格以它为基础。
- 库存 ：映射库存列或填写固定正整数；固定 100 表示每个 SKU 为 100。
- SKU 编码（选填） ：不使用时不选飞书字段；需要时映射自己的编码列，选定后保证各行完整且不重复。
- 计量单位 ：选择类目允许的实际单位，确认售价与包装信息对应个、件或套。
SKU 图可以按 SKU 逐行准备，也可按启用的图片规格值准备。编号图核对店智效实际采用的 SKU 顺序（有编码按编码、无编码按 SKU 名称排序）；按颜色提供时核对颜色首次出现的顺序。同色多尺寸共用同一张颜色图，不凭文件夹当前显示顺序猜测对应关系。
1.2.4 运费分类
| 运费方式 | 怎么配置 |
|---|---|
| 使用运费模板 | 选择本店实际使用的模板 |
| 运费指导模板 | 选择对应类型的模板，不与普通模板混用 |
| 卖家承担运费 | 确认本批确实由卖家承担 |
按重量计费的模板要提供正数重量。模板被删除、改名或类型改变后重新选择，店智效不会自动改用第一个模板。
店铺分类不需要时留空。需要时映射飞书列，填写唯一一级名称或最多两级完整路径，例如“发饰 / 发夹”。“/”表示父子关系。同名分类有歧义时用完整路径；缺失分类可能在本店创建，先核对拼写。
1.3 价格规则
1.3.1 起订与阶梯价
第一档价格读取飞书的售价，第一档起批数量就是最小起订量，填正整数。同款 SKU 同价时按数量报价，可设置后续阶梯；不同 SKU 售价不同时按规格报价，保留各规格价格。
二、三档都以第一档售价为基础，用两步加减乘除计算。例如第一档为 10 元：
| 档位 | 数量与公式 | 单价 |
|---|---|---|
| 第一档 | 2 件起，价格来自飞书 | 10.00 元 |
| 第二档 | 10 件起，第一档 × 0.95 ＋ 0 | 9.50 元 |
| 第三档 | 50 件起，第一档 × 0.90 ＋ 0 | 9.00 元 |
这是格式示例，不是建议售价；另一款第一档为 20 元时，同样公式得到 19 元和 18 元。
数量逐档增大，算出的单价逐档降低。启用一档要填完整数量与公式，不跳过第二档直接填第三档，不除以零；只用一档时后两档保持未启用／留空。价格按两位小数检查，四舍五入后相同也需要调整。修改飞书价格后，再检查当前款的阶梯关系和利润。
1.3.2 尺寸重量
各款不同选择“从飞书读取”，分别映射长、宽、高、重量；确实相同时可“统一填写”。长度为 cm，重量为 g，0.2 kg 应填 200 g。按重量计费必须有正数重量。按套销售时，售价、尺寸和重量都要对应一套。
1.3.3 服务设置
“支持混批”“破损包赔”“少货必赔”“坏单包赔”等影响真实商品承诺，按本店能承担的服务选择。当前发布配置使用 48 小时发货时效，先确认货源能履约。
保存类目时会一起校验主字段与价格阶梯，按提示修正具体字段。保存成功后重新打开“编辑”，核对规格、售价、库存、计量单位、运费与服务；用一款真实售价算完各档，再进入发布。
1.4 批量上新
1.4.1 素材货号
图片在电脑上： 选“未上传素材库”，选择包含本批各货号文件夹的总目录。店智效自动使用“按素材货号”，读取下一层全部货号；起止范围和指定货号禁用，先核对数量，不混入历史批次。
图片数量、格式和 SKU 对应关系按本篇“准备图片”核对，尤其不要遗漏第五张白底槽图片。
店智效轮到当前货号才检查、上传其素材；本店上传记录、本地文件与远端图片对应时才复用。同名相册、图片变化或结果不明先核对错误原因，不连续重复上传。
图片已在 1688 图片空间： 选“已上传素材库”，每个货号对应唯一同名相册。手工相册连续命名“主图-1～主图-5”“SKU-1、SKU-2……”和“详情-1、详情-2……”，检查图片数量、顺序与规格。具体图片要求见本篇“准备图片”。
已有素材模式可用同前缀的起止范围，或一行一个的指定货号。本地模式使用所选目录读出的货号。飞书视图筛选不改变任务范围。
1.4.2 上架方式
| 位置 | 最终状态 |
|---|---|
| 直接上架 | 确认到本店“销售中”列表 |
| 草稿箱 | 确认草稿已保存，不作为在售商品 |
接口上架与流程上架都支持两个位置：接口方式准备商品资料后直接提交；流程方式打开平台页面填写、检查后提交。二者都是真实操作。
1.4.3 开始执行
核对店铺、数据表、素材来源、货号数量、上架位置与方式后，点击“立即发布”。店智效先检查整批飞书资料，再逐款检查相册、属性、SKU、价格、物流与服务，确认后提交。当前货号和图片上传进度会显示在状态与日志中。
普通单款资料错误记录后继续其余有效款；登录失效、店铺变化、会员账号切换或安全验证停止整批。执行中不换账号、不关闭店铺工作区、不干预正在填写的发布页。
1.5 结果与重试
1.5.1 看逐款记录
任务日志按货号显示时间、上架位置、方式、用时、执行结果和失败原因。一个批次可能同时出现成功、失败和待确认，逐行检查，不能只看顶部汇总。日志的上架位置是任务启动时的选择，后来修改页面选项不会改变旧记录。
| 结果 | 含义与下一步 |
|---|---|
| 发布成功 | 已按本次商品 ID 确认到销售中，进入商品页抽查内容 |
| 草稿已保存 | 已确认保存到草稿箱，还没有在售；从草稿继续发布前，重新核对运费、服务保障与店铺分类，平台可能未完整恢复这些项 |
| 已提交，待核验 | 已取得提交回执，等待或尚未完成目标列表核对，先保留记录 |
| 待确认 | 提交或结果查询尚不明确，先核对原提交，不再创建一次 |
| 失败 | 阅读当前货号的具体原因，区分资料问题和平台状态问题，并先确认是否已提交 |
抽查标题、主图、SKU 图、规格价格、库存、类目及物流，同时核对起订量与阶梯价格。在销售中找不到时，先看这次选的位置是否为草稿箱。
1.5.2 核验原提交
平台可能已经创建商品，只是返回信息或列表查询暂时失败；此时重发同一个货号可能创建第二份。优先使用可用的“重新核验”，它查询原商品或草稿 ID 对应的目标列表，不再次读取飞书、上传图片或提交。
仍无法确认时，保留原记录、商品 ID 和失败原因，到当前店铺对应列表核对。不要清空日志、换提交方式或连续点击发布来绕过不确定结果。
1.5.3 修正失败原因
| 出错环节 | 处理位置 |
|---|---|
| 飞书货号或字段缺失 | 检查所选数据表、货号写法、同款全部 SKU 与应用权限；字段改动后重新读取并核对映射 |
| 类目、属性、品牌不匹配 | 回到本平台“配置”，检查实际类目和当前店铺可用选项，补齐必填项后保存 |
| 规格重复、价格库存无效 | 修正飞书对应行，确保组合唯一、售价为有效数字、库存符合本平台要求 |
| 图片缺失或不匹配 | 核对货号层级、主图和详情数量、SKU 对应关系、已有目录／相册的唯一性 |
| 起订量或阶梯价错误 | 数量逐档增大，实际价格逐档降低；检查两位小数舍入后是否相等 |
| 物流或重量错误 | 检查当前类目的物流类型、有效模板及所需重量；不要用另一店铺的模板 |
| 登录失效或安全验证 | 停止后先处理当前店铺登录与验证，再核对已经提交的货号；不会自动续跑 |
流程上架留下失败页面时，同时查看平台对具体字段的提示。关闭页面不能代替修正资料。
1.5.4 重试失败款
确认该货号未成功提交、问题已经修正后再放入下一批。已上传素材库模式可用“指定货号”只填这些款；本地素材模式选择仅包含这些款的本次总目录，重新核对数量。保留原始素材和成功商品资料，不为缩小范围删除原文件。
“停止任务”阻止后续步骤和新货号，不撤销已提交的商品或草稿；已经发出的提交先等结果。“全部清除”重置界面状态和日志，不会删除平台商品，也不会取消待确认提交的必要保护。