CSV上传导入指南
Last updated: November 13, 2026
在 Coolset 平台,您可以使用 csv 批量上传以下项目:
产品,
供应商,
订单项(采购或销售订单)
原产地。
开始之前
每个类别都有其必需的列和数据类型。
重要的是 使用完全相同的列名 和 填写正确的数据类型 如下模板或下面提供的表所示。
您可以选择:
创建您自己的CSV文件,遵循所需的结构,或者
直接从平台下载预格式化模板。
下载模板
在 Coolset 平台,选择您想上传的类别。
点击右上角的 “Import”。
下载该类别提供的 CSV 模板。

在 Microsoft Excel 中打开 CSV 模板
模板是一个 .csv 文件。
在 Excel 中正确显示列并打开它:
打开 Microsoft Excel。
转到“数据”选项卡。
点击获取数据 → 从文本/CSV。
选择您下载的模板文件并加载数据。
您的文件现在将在清晰的列结构中显示。

填写模板
在完成模板(或自行创建)时,请遵循本页底部的表格以获取指导:
列名 – 在文件中使用的列的确切名称。
数据类型 – 每列预期的数据格式(例如,文本,数字)。
描述 – 解释需要提供的信息。
必填 – 指示该列是否必须填写以成功上传。
上传您的 CSV 文件
一旦您的 CSV 文件准备好:
转到您想要上传的项目。
点击右上角的“Import”。
将文件拖放到上传区域,或点击框以浏览您的电脑。
一旦选择了文件,点击“Import”开始上传。
上传前,请检查两件事:
将文件另存为 CSV UTF-8。 酷设只能读取以 UTF-8 编码保存的 CSV 文件。Excel 通常会将 CSV 另存为区域格式,这是上传失败最常见的原因。在 Excel 中,转到 文件 → 另存为 ,然后选择 CSV UTF-8(逗号分隔)(.csv) 作为文件类型。
一个错误会导致整个上传失败。 如果文件中的任何一行存在错误,则文件中的所有内容都不会被导入,包括原本正确的行。请修复失败的行,然后重新上传完整文件。
再次上传同一文件时会发生什么? 重新导入会更新现有记录并添加新记录。它不会删除任何内容。酷设会通过每行的 external_id将其与现有记录进行匹配。

必填列及说明
产品
列名 | 数据类型 | 描述 | 必填 |
external_id | 文本 | 来自外部系统(例如 ERP、CRM)的产品唯一标识符。用于在不同系统之间关联数据。 | TRUE |
name | 文本 | 产品名称。 | TRUE |
description | 文本 | 有关产品的其他描述性信息。 | FALSE |
hs_code | 最多 6 位的整数(无小数) | 用于海关分类、识别产品的协调制度(HS)编码。 | TRUE |
commodity | 文本 | 产品所属的商品类别(例如 cattle、cocoa、coffee、palm_oil、rubber、soya 和 wood)。 | TRUE |
scientific_name | 文本 | 物种的科学名称。 必填 仅适用于木材类产品。 | FALSE |
common_name | 文本 | 物种的常用名称(非科学名称)。 必填 仅适用于木材类产品。 | FALSE |
sku | 文本 | 产品的库存单位(SKU)。 | TRUE |
type | 文本 | 表示产品是生产、采购还是制造的。 | TRUE |
bill_of_materials | 文本 | 构成该产品物料清单的产品 external_id 列表,以逗号分隔(如果是制造产品)。 | FALSE |
供应商
列名称 | 数据类型 | 描述 | 必填 |
|---|---|---|---|
external_id | 文本 | 来自 ERP 或 CRM 的唯一 ID | TRUE |
公司名称 | 文本 | 供应商的法定名称 | TRUE |
description | 文本 | 关于供应商的可选备注 | FALSE |
country_code | 文本(2 个字符) | ISO 3166-1 alpha-2 代码(例如 NL、DE) | TRUE |
is_self_managed | TRUE 或 FALSE | 如果您代表此供应商自行申报,请设置为 TRUE | FALSE |
contact_name | 文本 | 主要联系人;如果自行管理则留空 | FALSE |
contact_email | 文本 | 用于发送邀请的联系人电子邮件;如果自行管理则留空 | FALSE |
additional_contact_emails | 文本 | 要从同一供应商处邀请的其他电子邮件地址,除主要联系人外。 | FALSE |
type | 文本 | 价值链合作伙伴的类型。始终填写 "supplier" | TRUE |
订单项
列名称 | 数据类型 | 描述 | 必填 |
external_id | 文本 | 来自外部系统(例如 ERP、CRM)的订单项唯一标识符。用于跨系统关联数据。 | TRUE |
action | 文本 | 此订单的活动类型。action 可以是 'buying' 或 'selling'。 | TRUE |
border_cross_country_code | 文本 | 货物进入或离开欧盟所在国家的代码,即 NL、DE。 | TRUE |
order_external_id | 文本 | 关联订单的标识符。属于同一订单的所有项目共享此 ID。 | TRUE |
order_created_at | 日期 | 订单创建日期(格式:YYYY-MM-DD)。 | TRUE |
order_arrival_at | 日期 | 预计订单到达日期(格式:YYYY-MM-DD)。 | FALSE |
value_chain_external_id | 文本 | 供应商的外部 ID(与供应商导入中的供应商 external_id 匹配)。 | TRUE |
buyer_product_external_id | 文本 | 产品的外部 ID(与产品导入中的产品 external_id 匹配)。 | 当 action 为 buying 时为 TRUE |
seller_product_external_id | 文本 | 产品的外部 ID(与产品导入中的产品 external_id 匹配)。 | 当 action 为 selling 时为 TRUE |
volume | 一个数字 ,带有 位小数 | 订单项中包含的产品数量。 | TRUE |
unit | 文本(最多 3 个字符) | 产品的计量单位:kg。 | TRUE |
来源
列名 | 数据类型 | 描述 | 必填 |
external_id | 文本 | 来自外部系统(例如 ERP、CRM)的唯一标识符。用于在不同系统之间关联数据。 | FALSE |
name | 文本 | 区域或原产地的可读名称 | TRUE |
description | 文本 | 描述原产地的可选文本 | FALSE |
country_code | 文本(最多 2 个字符) | ISO 3166-1 alpha-2 代码(例如:NL、FR、US) | 真 |
坐标 | 文本 (GeoJSON 格式) | 按[经度、纬度]顺序排列的坐标数组;可以表示一个点或多边形边界。 | 真 |