CSV上传导入指南

Last updated: November 13, 2026

在 Coolset 平台,您可以使用 csv 批量上传以下项目:

  • 产品,

  • 供应商,

  • 订单项(采购或销售订单)

  • 原产地。

开始之前

每个类别都有其必需的列和数据类型。
重要的是 使用完全相同的列名 和 填写正确的数据类型 如下模板或下面提供的表所示。

您可以选择:

  • 创建您自己的CSV文件,遵循所需的结构,或者

  • 直接从平台下载预格式化模板。

下载模板

  1. 在 Coolset 平台,选择您想上传的类别。

  2. 点击右上角的 “Import”。

  3. 下载该类别提供的 CSV 模板。

Screenshot 2025-10-09 at 16.37.11.png

在 Microsoft Excel 中打开 CSV 模板

模板是一个 .csv 文件。
在 Excel 中正确显示列并打开它:

  1. 打开 Microsoft Excel。

  2. 转到“数据”选项卡。

  3. 点击获取数据 → 从文本/CSV。

  4. 选择您下载的模板文件并加载数据。

您的文件现在将在清晰的列结构中显示。

Screenshot 2025-10-09 at 16.39.40.png

填写模板

在完成模板(或自行创建)时,请遵循本页底部的表格以获取指导:

  • 列名 – 在文件中使用的列的确切名称。

  • 数据类型 – 每列预期的数据格式(例如,文本,数字)。

  • 描述 – 解释需要提供的信息。

  • 必填 – 指示该列是否必须填写以成功上传。

上传您的 CSV 文件

一旦您的 CSV 文件准备好:

  1. 转到您想要上传的项目。

  2. 点击右上角的“Import”。

  3. 将文件拖放到上传区域,或点击框以浏览您的电脑。

  4. 一旦选择了文件,点击“Import”开始上传。

上传前,请检查两件事:

  • 将文件另存为 CSV UTF-8。 酷设只能读取以 UTF-8 编码保存的 CSV 文件。Excel 通常会将 CSV 另存为区域格式,这是上传失败最常见的原因。在 Excel 中,转到 文件 → 另存为 ,然后选择 CSV UTF-8(逗号分隔)(.csv) 作为文件类型。

  • 一个错误会导致整个上传失败。 如果文件中的任何一行存在错误,则文件中的所有内容都不会被导入,包括原本正确的行。请修复失败的行,然后重新上传完整文件。

  • 再次上传同一文件时会发生什么? 重新导入会更新现有记录并添加新记录。它不会删除任何内容。酷设会通过每行的 external_id将其与现有记录进行匹配。

Screenshot 2025-10-09 at 16.51.46.png

必填列及说明

产品

列名

数据类型

描述

必填

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 格式)

按[经度、纬度]顺序排列的坐标数组;可以表示一个点或多边形边界。

真