跳到主要内容

字段

通用产品字段

通用产品护照的全部字段:字段含义、发送方式,以及发布时的要求。

本页列出 GET /categories/{category}/schema 返回的每一个字段。部分行还会补充该端点不返回的内容,例如文本值必须具备的格式、字段接受的护理符号,以及列表中各条目的键。这些内容来自 API 自身的代码。该端点还会返回每条法规依据背后的条件和说明。本页不列出各类别自身的检查。这类检查仍可能要求提供某个字段,即使该字段所在行没有发布相关的条目,或者显示了一条适用于您的产品的例外。检查也可能拒绝某个值。POST …/validate 会对您的护照运行这些检查,并指出发现的每个问题。

路径、方法、作用域、字段名、错误码和校验规则名称一律以英文发布,因为接口本身的语言就是英文——这些正是调用方需要照原样输入或比对的内容。每一段代码示例、每一个 JSON 载荷,以及错误响应中携带的那句原文,同样如此:/v1 不读取 Accept-Language,把 API 实际发送的内容翻译出来反而会造成误述。围绕它们的说明文字则跟随本页面的语言。

类型

text
字符串。"…" 部分文本字段还会检查格式。其所在行会说明检查内容。
multiselect
字符串列表。["EU"]
url
包含网址的字符串。"https://example.com/document.pdf"
number
数字。50
select
字符串。"kg_co2e"
array
列表。该字段所在行会说明每一项包含什么。["…"]

产品标识

product_name产品名称

产品的商品名称

将作为标题显示在公开护照页面及搜索结果中。

类型

text

发布

发布时要求提供。

访问级别

public 公开

gtinGTIN

已有条形码?条形码下方的编号即为 GTIN。发布前必填。

GTIN 用于将数字产品护照与标签上的实体条形码相关联。

类型

text

格式

format_gtin 发布会拒绝其他格式的值。

发布

发布时要求提供。

已保存的、带有自己条形码的尺码或颜色也算。

来源
  • GS1 / GTIN GS1 General Specifications voluntary
  • ESPR (Reg (EU) 2024/1781) Annex III(b), (c) anticipated

状态是该端点自己的分类。

访问级别

public 公开

serial_number序列号

用于单品级识别的序列号

类型

text

来源
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
访问级别

public 公开

product_description产品描述

产品及其用途的清晰描述

类型

text

发布

发布时要求提供。

访问级别

public 公开

product_category产品类别

通用产品类型(如 T 恤、夹克、床上用品)。选填——有助于整理您的护照。

类型

text

访问级别

public 公开

markets_sold_into销售市场

该产品投放的目标市场。用于判断适用哪些市场专属规则(例如法国 AGEC 法)。若您在法国销售,请单独选择法国(FR)。

仅用于定制合规指引,不会显示在公开护照上。

类型

multiselect

列表中的值
全部 11 个值
  • EU 欧盟/欧洲经济区(通用)
  • FR 法国
  • DE 德国
  • IT 意大利
  • ES 西班牙
  • NL 荷兰
  • BE 比利时
  • PL 波兰
  • UK 英国
  • US 美国
  • OTHER 其他/世界其他地区

发布可能拒绝列表之外的值。POST …/validate 会指出是哪个值。

访问级别

restricted 受限

制造商 / 经济运营者

manufacturer_name制造商名称

制造商的名称、注册商号或注册商标。

类型

text

发布

发布时要求提供。

来源
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
访问级别

public 公开

manufacturer_address制造商地址

制造商的邮寄地址。若单一联系点的邮寄地址不同,请一并填写。

类型

text

发布

发布时要求提供。

来源
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
访问级别

public 公开

manufacturer_country制造商国家

请选择制造商所在国家。

类型

text

格式

format_country_code 发布会拒绝其他格式的值。

发布

发布时要求提供。

来源
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force
访问级别

public 公开

manufacturer_email制造商邮箱

制造商的电子邮件地址。

在通用产品安全法规适用的情况下,该法规要求制造商提供邮寄地址和电子邮件地址。

类型

text

格式

format_email 发布会拒绝其他格式的值。

来源
  • GPSR (Reg (EU) 2023/988) Art. 9(6) in_force_conditional

    存在适用条件。端点在 regulatory_basis[].applies_when 中返回这些条件。

访问级别

public 公开

eori_numberEORI 编号

欧盟海关经济运营商注册和识别号码

类型

text

格式

format_eori 发布会拒绝其他格式的值。

访问级别

restricted 受限

eu_responsible_person欧盟(境内)责任人

欧盟(境内)责任人的姓名和联系方式。制造商位于欧盟境外时,在欧盟销售需要此信息;也可改为填写欧盟进口商。

类型

text

来源
  • GPSR (Reg (EU) 2023/988) Art. 16(1) in_force
  • Market Surveillance Reg (EU) 2019/1020 Art. 4 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(k) anticipated
访问级别

public 公开

eu_importer欧盟进口商

若由您以外的企业将产品投放欧盟市场,请在此填写该进口商。请提供其名称、注册商号或注册商标、邮寄地址和电子邮件地址。

进口商是区别于制造商的独立经济经营者,即将产品引入欧盟的欧盟境内企业。

类型

text

来源
  • GPSR (Reg (EU) 2023/988) Art. 11(3) in_force_conditional

    存在适用条件。端点在 regulatory_basis[].applies_when 中返回这些条件。

  • ESPR (Reg (EU) 2024/1781) Art. 29(3) anticipated
  • ESPR (Reg (EU) 2024/1781) Annex III(j) anticipated
访问级别

public 公开

环境数据

carbon_footprint_value碳足迹

产品碳足迹。请在下拉列表中选择相应的计量单位。

类型

number

计量单位

在 carbon_footprint_unit 中发送。

carbon_footprint_unit: kg_co2e、kg_co2e_per_kg、kg_co2e_per_m2

访问级别

public 公开

carbon_footprint_unit碳足迹计量单位

碳足迹数值的计量单位。

类型

select

列表中的值
  • kg_co2e kg CO₂e(每件产品)
  • kg_co2e_per_kg kg CO₂e / kg(按重量)
  • kg_co2e_per_m2 kg CO₂e / m²(按面积)

发布可能拒绝列表之外的值。POST …/validate 会指出是哪个值。

访问级别

public 公开

carbon_footprint_basis碳足迹计算依据

碳足迹的计算方法。

此字段记录计算方法。请保留碳足迹的支持性证明;选择一种方法本身不能证实计算结果。

类型

select

列表中的值
  • iso_14067 ISO 14067(产品碳足迹)
  • pef EU PEF / PEFCR
  • ghg_protocol GHG Protocol Product Standard
  • iso_14040_44 ISO 14040/44 LCA
  • supplier_data 供应商数据 / EPD
  • estimate 内部估算

发布可能拒绝列表之外的值。POST …/validate 会指出是哪个值。

来源
  • UCPD (Dir 2005/29/EC) Art. 12 in_force
访问级别

public 公开

recyclable_content_percentage可回收含量 (%)

产品在使用寿命终期可回收的比例

类型

number

限制

min: 0 max: 100

访问级别

public 公开

recycled_content_percentage回收材料含量 (%)

产品中使用回收材料的比例

类型

number

限制

min: 0 max: 100

来源
  • AGEC Décret 2022-748 recycled-material % FR in_force_conditional

    存在适用条件。端点在 regulatory_basis[].applies_when 中返回这些条件。

  • ESPR (Reg (EU) 2024/1781) Annex I(h) anticipated
访问级别

public 公开

法规合规

substances_of_concern高关注物质

浓度超过阈值的高关注物质清单,或声明「未申报」

类型

array item_type: string

来源
  • REACH (Reg (EC) 1907/2006) Art. 33 in_force
  • SCIP / WFD (Dir 2008/98/EC) Art. 9(1)(i) in_force
  • AGEC Décret 2022-748 Code de l'environnement art. R. 541-228 IX FR in_force_conditional

    存在适用条件。端点在 regulatory_basis[].applies_when 中返回这些条件。

  • ESPR (Reg (EU) 2024/1781) Art. 7(5) anticipated
访问级别

public 公开

conformity_declaration_url符合性声明 URL

欧盟符合性声明文件的链接,或上传该 PDF。

类型

url

访问级别

authority 仅监管机构

可由文件代替

conformity_declaration

文件的 ID 在 conformity_declaration_url__document_id 中发送。

compliance_standards合规标准

选择您的产品所符合的标准。

类型

multiselect

列表中的值
  • reach REACH (EC 1907/2006)
  • eu_ecolabel EU Ecolabel(欧盟生态标签)

发布可能拒绝列表之外的值。POST …/validate 会指出是哪个值。

访问级别

public 公开

产品终期处理

disposal_instructions处置说明

产品无法回收时的安全处置指南

类型

text

访问级别

public 公开

循环经济

mono_material_percentage单一材料占比

产品中由单一可回收材料制成的比例(0-100)。超过 85% 的产品更易于回收。

类型

number

限制

min: 0 max: 100

访问级别

public 公开

recyclability_grade可回收性等级

仅为已填写的值保留;不再要求填写。

类型

select

列表中的值
  • A A — 完全可回收(单一材料,无污染物)
  • B B — 分离后可回收(可拆除的不可回收部件)
  • C C — 部分可回收(混纺,部分组件可回收)
  • D D — 难以回收(复杂混纺、涂层)
  • E E — 不可回收(材料无法分离或含污染性组件)

发布可能拒绝列表之外的值。POST …/validate 会指出是哪个值。

访问级别

public 公开

不会显示在护照的公开页面上。self_declared_label

disassembly_instructions_url拆解说明

不可回收组件(拉链、纽扣、涂层)分离指南的 URL,用于回收,或上传文件。

类型

url

访问级别

public 公开

可由文件代替

document

文件的 ID 在 disassembly_instructions_url__document_id 中发送。

takeback_scheme_url回收计划

收集或回收计划信息的 URL,或上传文件。

类型

url

来源
  • ESPR (Reg (EU) 2024/1781) Art. 7(2)(b)(ii) anticipated
访问级别

public 公开

可由文件代替

document

文件的 ID 在 takeback_scheme_url__document_id 中发送。