商品编码规范：全编码、半编码、P字段和K字段
说明云店AI商品全编码、半编码、P成本字段、K控价字段和短横线分段规则，帮助商品文件夹、图片、视频、表格及平台商品准确匹配。
商品编码用于告诉云店AI“这些图片、视频、表格和平台商品是不是同一款”。批量上架、表格整理、视频对应、跨平台匹配、文件夹关联和商品编辑都会不同程度地使用编码。
编码不规范不代表所有功能都完全不能用，但越依赖自动匹配，错配、漏配和价格无法识别的风险越高。
先记住三个硬重点
- 各段必须使用英文半角短横线
-分隔。 - 推荐使用六段式完整编码。
- 第3段和第4段固定为“厂家或档口”和“货号或款号”。
标准格式：
第1段-第2段-厂家或档口-货号或款号-P成本-K控价示例：
24361-GX-MC-66001-P130-K258对应含义：
24361 第1段：来源、网站、业务线或自定义前缀
GX 第2段：市场、渠道或自定义前缀
MC 第3段：厂家或档口
66001 第4段：货号、款号或商品编码
P130 第5段：成本或拿货价
K258 第6段：控价或参考售价“厂家或档口”是字段含义，不是在文件夹名中写斜杠 /。Windows文件夹名称也不能使用 /。
什么是六段式全编码
六段式全编码完整保留来源、厂家、货号、成本和控价：
24361-GX-MC-66001-P130-K258
HZ-RF-1C045-7701-P120-K238它最适合用在：
- 商品文件夹名称。
- 淘宝或抖店商品表的商家编码。
- 需要自动读取P成本、K控价的表格处理。
- 需要完整编码精确匹配的批量任务。
- 需要长期追踪同一商品来源和价格的资料。
为了保证识别稳定，商品文件夹名最好只放编码，不要在六段编码后继续追加商品名、颜色、备注或其它短横线段。
推荐：
24361-GX-MC-66001-P130-K258不推荐：
24361-GX-MC-66001-P130-K258-黑色外套
24361-GX-MC-66001-P130-K258_黑色外套追加内容可能让末尾K字段、SKU编码或完整编码匹配失效。商品名称、颜色和备注应写在类目属性文档、商品资料表或其它独立字段中。
没有P和K时的四段式
没有成本和控价时，可以保留前四段：
第1段-第2段-厂家或档口-货号或款号例如：
24361-GX-MC-66001这时系统仍能从第3、4段得到半编码 MC-66001，但不能从文件夹名读取P成本和K控价。
支持价格兜底的功能会使用页面设置或模板中的兜底值；不支持兜底的功能会要求你补充价格，或者把商品留给人工复核。不能把“某个上架页有兜底”理解成所有表格和平台任务都会自动补价。
什么是半编码
半编码是全编码的第3段和第4段：
厂家或档口-货号或款号例如：
全编码：24361-GX-MC-66001-P130-K258
半编码：MC-66001全编码：HZ-RF-1C045-7701-P120-K238
半编码：1C045-7701半编码常用于：
- 视频文件名与商品匹配。
- 淘宝和抖店商品互相核对。
- 不需要暴露成本和控价的外部资料。
- 支持半编码兜底的表格、文件夹和批量关联任务。
半编码不是所有功能通用的完整编码。只有功能说明明确支持半编码匹配时，才可以只提供两段；需要读取来源、完整商家编码或P/K价格的功能仍应使用四段或六段编码。
P字段和K字段怎么写
P字段表示成本或拿货价，K字段表示控价或参考售价。它们应各自成为独立的一段，并使用字母加整数：
P130
K258推荐：
24361-GX-MC-66001-P130-K258不要写成：
24361-GX-MC-66001-P130K258
24361-GX-MC-66001-P130.5-K258.5
24361-GX-MC-66001-成本130-控价258部分表格清洗可以识别“控价258”等旧文本，但商品文件夹解析按独立的 P数字、K数字 段最稳定。价格带小数时，请在页面或表格的价格字段中填写，不要改变商品文件夹的编码结构。
为什么必须使用英文短横线
多个正式脚本会先用英文短横线拆分编码，再读取第3、4段或P/K字段。因此下面这些写法不能视为等价：
正确：24361-GX-MC-66001-P130-K258
错误：24361_GX_MC_66001_P130_K258
错误：24361 GX MC 66001 P130 K258
错误：24361—GX—MC—66001—P130—K258
错误：24361-GX-MC_66001-P130-K258请使用键盘上的英文半角 -，不要使用中文破折号、下划线、空格或混合分隔符。
第1段和第2段是否重要
第1、2段可以按业务定义为网站、市场、来源、渠道或其它稳定前缀。多数半编码匹配主要看第3、4段，但完整编码匹配、跨系统回写和来源追踪仍会保留第1、2段。
建议同一业务长期使用相同规则，不要今天表示网站，明天又用同一个值表示店铺。
半编码必须保持唯一
同一个业务范围内，尽量不要让两款不同商品共用同一个“档口-货号”。
如果多个商品都是：
MC-66001视频、表格或文件夹匹配时可能出现多个候选，系统无法可靠判断应该对应哪一款。发现重复半编码时，应先修正源数据或人工确认，不要直接批量执行。
哪些功能最依赖编码
强依赖完整结构
- 需要从文件夹读取P成本或K控价的任务。
- 商品表格中的P/K清洗和价格安全检查。
- 需要完整商家编码精确回写的平台模板。
常用半编码兜底
- 视频文件与商品ID对应。
- 淘宝与抖店商品交叉匹配。
- 商品编辑时从外层商品编码寻找素材文件夹。
- 部分表格和剪辑记录关联。
编码不规范时仍可手动使用
- 单张图片或单个视频上传后由用户自己选择结果的功能。
- 不依赖商品文件夹自动匹配的在线生成任务。
- 用户手动指定路径、商品或价格的部分工具。
具体是否支持半编码、文件名包含匹配或价格兜底，以对应功能文档和预检结果为准。
使用前自检
开始批量任务前，抽查几个商品：
- 是否统一使用英文短横线。
- 第3段是否真的是厂家或档口。
- 第4段是否真的是货号或款号。
- P和K是否各自为独立段，并且数值正确。
- 是否有不同商品重复使用同一个半编码。
- 商品文件夹、表格和视频是否使用同一套编码。
- 扫描或预检显示的商品数量、半编码和价格是否符合预期。
先用少量商品确认匹配正确，再处理完整批次。
常见问题
第1段和第2段必须固定成某个名称吗
不需要固定成软件规定的文字，但同一商家应长期保持自己的统一含义和格式。
没有P和K会不会不能上架
不一定。支持兜底价格的上架功能仍可运行，但你必须核对兜底值；表格价格审核等功能可能把缺少P/K的商品留给人工复核。
只有“档口-货号”两段能不能用
支持半编码匹配的功能可以使用。需要完整编码、来源或价格的功能不适用。最稳妥的商品文件夹和商家编码仍是四段或六段。
文件夹名称能不能加商品名
不建议。当前部分解析器会把额外内容当成编码的一部分，导致K字段或完整编码匹配失败。商品名和备注请放到独立文档、表格字段或软件页面中。
为什么扫描结果的价格是兜底值
先检查文件夹名是否包含独立的 P数字 段、是否使用英文短横线，以及P段后面是否还有正确的分隔。编码正确但仍未读取时，查看当前功能是否启用了“从P字段读取价格”。