[{"data":1,"prerenderedAt":152},["ShallowReactive",2],{"help-article-product-import::zh":3,"help-tree-article::zh":31},{"model":4,"slug":8,"title":9,"summary":10,"body":11,"i18n":12,"sortOrder":16,"status":17,"category":20,"publishedAt":30,"helpKey":8},{"id":5,"createdAt":6,"updatedAt":7},"8","2026-08-08T03:43:01.409541Z","2026-08-08T07:32:34.411367Z","product-import","批量导入产品","用 Excel \u002F CSV 一次建好或改好很多条产品：下载模板、填写、上传、核对映射、看结果。","# 批量导入产品\n\n一条条建太慢的时候，用导入：一张表格一次最多 1000 行，既能新建、也能更新已有产品。\n\n入口在产品列表右上角的**导入**按钮。\n\n## 一、先下载模板\n\n进到导入页后点**下载模板**（如果弹出一个选择框，按需勾选后点「下载」）。拿到的 `.xlsx` 里：\n\n- **第 1 行是列标题**，请不要改动它 —— 上传后系统正是靠它自动对应字段的。\n- **第 2 行是示例行**，照着它的格式填。\n- **加粗 + 浅黄色底的列是必填的**，只有两列：**货号**和**产品名称**。\n- 部分列（品牌、分类、标签、单位、是\u002F否 这类）带**下拉选项**，可以直接选，也可以自己填编码。\n\n> ⚠️ **填完记得把第 2 行的示例删掉**，否则它会被当成一条真实数据导进去。\n\n## 二、在表格里填写\n\n- **一行 = 一个产品。**\n- **货号是这条产品的唯一标识，必填。** 再次导入相同货号，会**更新**原来那条，而不是新建一条 —— 这正是批量改价、批量补资料的做法。\n- **不需要的列可以整列删掉**，不影响其它列；不删也行，上传后在映射那一步把它设成「— 不导入此列 —」即可。\n- **分类是选填的**，没填的产品会归到「未分类」。\n- **价格列填纯数字**（如 `0`、`12.5`），不要带货币符号。\n- **图片可以直接嵌在单元格里**（Excel \u002F WPS 的「置于单元格中」），一行最多 9 张。注意：**带图片的行会替换该产品已有的全部图片**，不是追加。\n- 一次最多 **1000 行**；超了会在下一步被拦下并提示行数过多。\n\n## 三、上传\n\n支持 `.xls`、`.xlsx` 和 `.csv`。把文件拖到虚线框里，或者点一下选择文件。\n\n![导入页](https:\u002F\u002Fapi.b2bdirect.online\u002Fapi\u002Fv1\u002Fhelp-media\u002F62ad0995-6da3-4df1-a70f-9cb74fb25c6b)\n\n页面下方的**可导入以下列**列出了这次能导的全部列，带 `*` 的就是必填项 —— 不确定某个字段能不能导，看这里最快。\n\n上传完会自动进入下一步，不用点「下一步」。\n\n## 四、核对字段映射\n\n![字段映射](https:\u002F\u002Fapi.b2bdirect.online\u002Fapi\u002Fv1\u002Fhelp-media\u002F37c3536c-e74f-47c5-90a9-73f1eb352e2b)\n\n最上面是文件前几行的预览，确认读到的内容没错位。系统会按表头自动把你的每一列对到系统字段（模板下载下来直接填的话，这一步通常全对）。这一步要做三件事：\n\n1. **逐行核对对应关系。** 对得不准的直接改；不需要导入的列选「**— 不导入此列 —**」。\n2. **选「当记录已存在时」怎么处理** —— 也就是遇到货号已存在的行时：\n   - **更新已存在（upsert）** —— 默认。用表格里的值覆盖原记录。\n   - **跳过已存在** —— 原记录原样不动。\n   - **冲突则失败** —— 这一行直接记为失败。\n3. 如果映射了价格列，会多出一个**录入价口径**：选**税前价**（不含税）或**含税价**，系统据此反算另一边和税额。这个选择对本次导入的所有价格列生效。\n\n点**下一步**。常见的拦截提示：\n\n- **必填字段未映射：xxx** —— 货号或产品名称没对上。\n- **字段被映射了多次：xxx** —— 两列指向了同一个系统字段。\n- **第 3、7 行的必填项「产品名称」未填写，请补齐后重新导入。** —— 表格里有空着的必填格。\n\n## 五、解析引用\n\n品牌、分类、一级\u002F二级标签这类列，填的是名称，系统要把它对应到已有记录上。如果你映射了这类列，就会多出这一步（没有的话会自动跳过，直接开始导入）。\n\n![解析引用](https:\u002F\u002Fapi.b2bdirect.online\u002Fapi\u002Fv1\u002Fhelp-media\u002Fc1f9180a-8759-4e01-8f5c-c7020888f300)\n\n每个**不同的值**占一行（不是每条数据一行），右边是状态：\n\n- **已解析**（绿）—— 唯一匹配上了，已经自动填好，核对一下即可。\n- **待确认**（黄）—— 匹配到多条同名记录，需要你指定是哪一条。\n- **未找到**（红）—— 系统里没有这个名称。\n\n**高亮的行必须逐个处理完，「开始导入」才可点。** 处理方式有两种：从下拉里选一条记录，或者 —— 仅限选填的列 —— 勾上**留空**，表示这些行的这个字段就空着。\n\n## 六、看结果\n\n![导入结果](https:\u002F\u002Fapi.b2bdirect.online\u002Fapi\u002Fv1\u002Fhelp-media\u002F6e000e28-7bfd-466a-b99e-e41e4fc8ed7d)\n\n顶部四个计数：**新建 \u002F 更新 \u002F 跳过 \u002F 失败**。下面逐行列出**行号 \u002F 状态 \u002F 错误**，成功的行也在里面。\n\n**行号是表格里的物理行号**（标题行算第 1 行，所以第一条数据是第 2 行），方便你回到原文件对着改。\n\n导入是**逐行独立**的：一行出错不会影响其它行，成功的照样入库。所以失败了不用整个重来 —— 按错误提示把那几行改好，**用同一份文件再导一次**即可：默认的「更新已存在」会把已经成功的行原样更新，不会重复建。\n\n想接着导下一批，点**再导入一个文件**。\n\n## 七、只想批量换图片？\n\n那用另一个入口：产品列表右上角的**导入图片**。把图片按**货号**或**条形码**命名后整批拖进去，系统自动挂到对应产品上；同一产品多张图加数字后缀（`REF`、`REF-1`、`REF-2`）。\n",[13],{"lang":14,"data":15},"ZH",{"body":11,"description":10,"name":9},25,{"value":18,"label":19},"HELP_STATUS_PUBLISHED","已发布",{"model":21,"slug":25,"name":26,"description":27,"sortOrder":28,"status":29},{"id":22,"createdAt":23,"updatedAt":24},"2","2026-08-08T01:49:44.695458Z","2026-08-08T07:32:34.167715Z","product","产品管理","产品从建档、编辑、上架到删除的完整流程。",20,{"value":18,"label":19},"2026-08-08T03:43:01Z",{"rows":32},[33,62],{"category":34,"articles":41},{"model":35,"slug":38,"name":39,"status":40},{"id":36,"createdAt":37,"updatedAt":37},"1","2026-08-07T10:17:00.584516Z","getting-started","使用说明",{"value":18,"label":19},[42,53],{"model":43,"slug":45,"title":46,"sortOrder":47,"status":48,"category":49,"publishedAt":52,"helpKey":45},{"id":36,"createdAt":37,"updatedAt":44},"2026-08-07T10:34:12.486727Z","invoice","发票说明",10,{"value":18,"label":19},{"model":50,"slug":38,"name":39,"status":51},{"id":36,"createdAt":37,"updatedAt":37},{"value":18,"label":19},"2026-08-07T10:17:00Z",{"model":54,"slug":56,"title":57,"sortOrder":28,"status":58,"category":59,"publishedAt":52,"helpKey":56},{"id":22,"createdAt":37,"updatedAt":55},"2026-08-07T10:34:20.336877Z","tax-category","收税规则说明（税类）",{"value":18,"label":19},{"model":60,"slug":38,"name":39,"status":61},{"id":36,"createdAt":37,"updatedAt":37},{"value":18,"label":19},{"category":63,"articles":66},{"model":64,"slug":25,"name":26,"description":27,"sortOrder":28,"status":65},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},[67,80,92,98,111,124,138],{"model":68,"slug":72,"title":73,"summary":74,"sortOrder":47,"status":75,"category":76,"publishedAt":79,"helpKey":72},{"id":69,"createdAt":70,"updatedAt":71},"3","2026-08-08T01:49:44.762143Z","2026-08-08T07:32:34.258258Z","product-getting-started","产品管理：开始之前","产品菜单在哪、需要什么权限、为什么有些菜单看不见，以及「标签」和「分类」的区别。",{"value":18,"label":19},{"model":77,"slug":25,"name":26,"description":27,"sortOrder":28,"status":78},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},"2026-08-08T01:49:44Z",{"model":81,"slug":85,"title":86,"summary":87,"sortOrder":28,"status":88,"category":89,"publishedAt":79,"helpKey":85},{"id":82,"createdAt":83,"updatedAt":84},"4","2026-08-08T01:49:44.866040Z","2026-08-08T07:32:34.341169Z","product-create","创建产品","从哪里进新增表单、三个必填字段、图片和规格怎么填、价格怎么一起录。",{"value":18,"label":19},{"model":90,"slug":25,"name":26,"description":27,"sortOrder":28,"status":91},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},{"model":93,"slug":8,"title":9,"summary":10,"sortOrder":16,"status":94,"category":95,"publishedAt":30,"helpKey":8},{"id":5,"createdAt":6,"updatedAt":7},{"value":18,"label":19},{"model":96,"slug":25,"name":26,"description":27,"sortOrder":28,"status":97},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},{"model":99,"slug":103,"title":104,"summary":105,"sortOrder":106,"status":107,"category":108,"publishedAt":79,"helpKey":103},{"id":100,"createdAt":101,"updatedAt":102},"5","2026-08-08T01:49:44.929105Z","2026-08-08T07:32:34.499211Z","product-edit","编辑产品","编辑入口在详情页而不是列表页；哪些内容在表单里改，哪些在详情页的标签里单独改。",30,{"value":18,"label":19},{"model":109,"slug":25,"name":26,"description":27,"sortOrder":28,"status":110},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},{"model":112,"slug":116,"title":117,"summary":118,"sortOrder":119,"status":120,"category":121,"publishedAt":79,"helpKey":116},{"id":113,"createdAt":114,"updatedAt":115},"6","2026-08-08T01:49:44.989085Z","2026-08-08T07:32:34.572203Z","product-listing","产品上架与下架","四种产品状态之间怎么流转、在哪操作、批量怎么做，以及「对外展示」和「已上架」的区别。",40,{"value":18,"label":19},{"model":122,"slug":25,"name":26,"description":27,"sortOrder":28,"status":123},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},{"model":125,"slug":129,"title":130,"summary":131,"sortOrder":132,"status":133,"category":134,"publishedAt":137,"helpKey":129},{"id":126,"createdAt":127,"updatedAt":128},"7","2026-08-08T01:49:45.070866Z","2026-08-08T07:32:34.647248Z","product-delete","删除产品","删除只在列表页勾选后操作、不可撤销；被单据引用的产品删不掉，该用归档。",50,{"value":18,"label":19},{"model":135,"slug":25,"name":26,"description":27,"sortOrder":28,"status":136},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},"2026-08-08T01:49:45Z",{"model":139,"slug":143,"title":144,"summary":145,"sortOrder":146,"status":147,"category":148,"publishedAt":151,"helpKey":143},{"id":140,"createdAt":141,"updatedAt":142},"9","2026-08-08T07:30:08.544768Z","2026-08-08T07:32:34.720477Z","product-app","用手机 App 管理产品","在手机 App 上查看、新建、修改产品，以及上架下架、批量操作和删除。",60,{"value":18,"label":19},{"model":149,"slug":25,"name":26,"description":27,"sortOrder":28,"status":150},{"id":22,"createdAt":23,"updatedAt":24},{"value":18,"label":19},"2026-08-08T07:30:08Z",1786175923009]