CSV字段描述
| 列 | 描述 |
|---|---|
| SKU | 识别您业务中产品的代码，例如，GRLS-GRPHC-BBT-T-S |
| 产品ID | 您的产品标识符，通常是您电子商务平台上的ID，例如，254678901 |
| 名称 | 您产品的名称，例如，女孩图案婴儿T恤 |
| 描述 | 您产品的完整详细描述，例如，体验我们优质聚酯衬衫带来的无与伦比的舒适和优雅，精心制作以增强您的衣橱必需品。该衬衫以现代个体为设计理念，具有流畅而多功能的美学，使其在休闲和正式场合中都能完美适应。 |
| 海关描述 | 商业发票的简明产品描述。字符限制为30，例如，女孩衬衫，100%聚酯 |
| 重量单位 | 产品的重量单位。如果未提供单位，则值默认为pound。有效值为gram、kilogram、pound和ounce。 |
| 重量 | 产品的重量。重量值必须为正数。 |
| 尺寸单位 | 产品的尺寸单位。如果未提供单位，则值默认为inch。有效值为inch、foot、yard、millimeter、centimeter和meter。 |
| 长度 | 产品的长度。长度值必须为正数。 |
| 宽度 | 产品的宽度。宽度值必须为正数。 |
| 高度 | 产品的高度。高度值必须为正数。 |
| 包装偏好 | 您的产品是否单独运输ships_alone或可以consolidated。如果您的产品可以与其他产品一起合并运输（最常见），您可以将此字段留空。 |
| 限制国家 | Restrict 您的产品在某些国家的限制。值为用竖线分隔2位ISO代码。如果您想要restrict所有国家，请输入ALL。如果您想要restrict所有国家，除了一个或几个，请输入ALL-后跟您想要解除限制的国家，用竖线分隔，例如，ALL-CA|AU|US。如果您只想要restrict特定国家，请输入您想要restrict的国家，用竖线分隔，例如，AU|KR|MY|SG。如果您想要移除所有现有的限制国家，请输入NONE作为值。 |
| 产品类型 | 确定产品的性质。有效值为physical_good、digital_good、service、subscription、bundle和partial_item。如果您的产品是实物商品（最常见），您可以将此字段留空。 |
| 原产国 | 产品制造的国家。值2位ISO代码，例如，JP, GB, KR。 |
| 通用HS编码 | 产品的通用6位HS编码，例如，9506.62 |
| 国家特定的HS编码 | 产品的国家特定HS编码，当有多个国家特定编码时，用竖线分隔，例如，IT=6109.10.0010|DE=6109.10.0010|GB=6109.10.0010|JP=6109.10.020 |
| 图片URL | 产品的图片URL，例如，https://www.exampleclothingstore.com/images/girls-graphic-baby-tee-pink-unicorn-001.jpg |
| 材料 | 产品的主要材料或成分，例如，聚酯 |
| 品牌 | 产品的品牌，例如，耐克 |
| 价格 | 您为产品收取的价格。 |
| 零售价格 | 产品在折扣前的原始价格。将其与销售价格一起显示可以突出客户的节省。零售价格必须高于基本产品价格（如上所述）。 |
| 货币 | 价格的货币。值为3位数的货币代码，例如，USD、CAD或AUD。 |
对于酒精饮料商家： 如果您销售的产品属于协调系统第22章（酒精饮料），则需要额外的测量字段以进行消费税计算。请参阅我们的 消费税文档 并使用 专用CSV模板 处理这些产品。
| 列 | 描述 |
|---|---|
| 体积单位 | 体积的计量单位（酒精饮料必需）。有效值为毫升、升、液体盎司等。 |
| 体积 | 产品的体积（酒精饮料和消费税计算必需）。 |
| 酒精含量 | 酒精百分比含量（酒精饮料必需）。值应以百分比输入，例如，12表示12% ABV。 |
CSV导入错误
在导入您的目录产品时，您可能会遇到错误。以下列表描述了导入错误及其解决方法。一旦您解决了错误，就可以重新导入您的CSV。
导入错误
| 错误 | 描述 |
|---|---|
| 文件必须小于 1 GB。 | 您的文件太大。文件必须小于 1 GB。 |
| 文件必须为 CSV 格式。 | 目录仅支持 CSV 文件格式。为了解决此问题，请确保您的文件格式为 CSV。 |
| 缺少列标题。 | 目录仅支持与目录模板完全相同格式的文件。确保您的 CSV 标题与 CSV 模板文件的标题匹配。 |
| 无法识别的列标题。 | 您有无法识别的列标题。目录仅支持与目录模板完全相同格式的标题。请删除无法识别的列标题，并仔细检查您的 CSV 标题是否与 CSV 模板的标题匹配。 |
| 您缺少 SKU 或产品 ID。确保所有产品都有 SKU 或产品 ID。 | 创建目录产品需要一个标识符(SKU/产品 ID）。为了解决此问题，请为每个产品添加 SKU 或产品 ID。 |
| 海关描述超过 30 个字符的限制。 | 默认情况下，海关描述限制为 30 个字符，这与商业发票的最常见字符限制一致。 |
| 产品类型无效。 | 该值可以是 physical_good、digital_good、service、subscription、bundle 和 partial_item。 |
| 包装偏好无效。目录支持以下包装偏好：ships_alone 和 consolidated。如果您的产品可以与其他产品合并，请留空。 | 包装偏好无效。目录支持以下包装偏好：ships_alone 和 consolidated。如果您的产品可以与其他产品合并，您可以将其留空，因为 consolidated 是默认值。 |
| 重量单位无效。目录仅支持以下重量单位：克、千克、磅和盎司。 | 目录仅支持以下未缩写的单位：gram、kilogram、pound 或 ounce。 |
| 重量必须大于零，且不能包含字母或符号。 | 确保您的重量值是有效的正数，且不包含符号或字母。目录支持最多两位小数的重量，例如 5.85 |
| 尺寸单位无效。目录支持以下尺寸单位：英寸、英尺、码、毫米、厘米和米。 | 目录仅支持以下未缩写的单位：inch、foot、yard、millimeter、centimeter 或 meter。 |
| 长度必须大于零，且不能包含字母或符号。 | 确保您的长度是有效的正数，且不包含符号或字母。目录支持最多两位小数的长度，例如 5.29 |
| 宽度必须大于零，且不能包含字母或符号。 | 确保您的宽度是有效的正数，且不包含符号或字母。目录支持最多两位小数的宽度，例如 2.44 |
| 高度必须大于零，且不能包含字母或符号。 | 确保您的高度是有效的正数，且不包含符号或字母。目录支持最多两位小数的高度，例如 8.02 |
| 提供重量值时需要一个重量单位。 | 为具有重量值的产品提供一个重量单位。目录支持以下重量单位：gram、kilogram、pound 和 ounce。 |
| 如果提供尺寸值，则需要一个尺寸单位。 | 为具有尺寸值的产品提供一个尺寸单位。目录支持以下尺寸单位：inch、foot、yard、millimeter、centimeter 和 meter。 |
| HS 代码必须在 6 到 16 个字符之间。 | HS 代码必须在 6 到 16 个字符之间，因为通用 HS 代码为 6 位，最长的国家特定 HS 代码为 16 位。 |
| 国家特定 HS 代码必须采用 '国家代码=HS 代码' 的格式 | 国家特定 HS 代码必须采用国家代码=HS 代码 的格式，例如，KR=8518.30.9000。如果有多个 HS 代码，请用竖线分隔每个代码，例如，KR=8518.30.9000|CA=8518.30.9010。 |
| [国家代码] 不是有效的国家代码。 | 发货国家必须采用 ISO 格式，例如，KR 或 BR。确保您的发货国家采用 2 位 ISO 格式。 |
| 原产国值必须采用 ISO 格式。 | 确保您的原产国采用 2 位 ISO 格式。 |
| 价格不能包含负值、字母或符号。 | 确保您的价格是一个正的有效值。目录支持最多三位小数的价格，例如，104.399 |
| 如果提供价格，则需要货币代码。 | 为您的产品提供货币代码，前提是这些产品有价格。 |
| 货币代码必须采用 ISO 格式，例如，AUD 或 THB。 | 确保您的货币代码采用 3 位 ISO 格式。 |
| 如果提供了一维字段，则必须提供所有三个字段。 | 确保您为具有尺寸值的产品提供所有三个尺寸字段。 |
导入失败示例
目录CSV导入
批量导入您的产品到目录。Zonos目录的批量导入允许您一次性导入整个目录。在填写目录CSV模板时，每个产品唯一的必填字段SKU或产品ID。如果您的文件中基于SKU和产品ID有重复的同一产品，目录会在第一次创建该产品，然后，如果相关，产品详细信息将会与任何新的或补充的信更新以处理重复的产品。