跳到主要内容

字段

纺织品 / 服装字段

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

本页列出 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
列表。该字段所在行会说明每一项包含什么。["…"]
date
包含日期的字符串。"2027-03-01"

产品标识

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 受限

commodity_code商品编码(HS/CN/TARIC)

该产品的海关分类编码(6位HS协调制度编码、8位欧盟合并商品名目录编码,或10位TARIC综合关税编码)。您在申报出口和报关时很可能已在使用此编码。

类型

text

格式

format_commodity_code POST …/validate 会对其他格式的值给出警告。

来源
  • ESPR (Reg (EU) 2024/1781) Annex III(d) anticipated
访问级别

public 公开

制造商 / 经济运营者

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

列表中的值
全部 15 个值
  • reach REACH (EC 1907/2006)
  • eu_ecolabel EU Ecolabel(欧盟生态标签)
  • oeko_tex_100 OEKO-TEX Standard 100
  • gots GOTS(全球有机纺织品标准)
  • iso_14184 EN ISO 14184 — 甲醛
  • iso_17075 EN ISO 17075 — 六价铬
  • en_14682 EN 14682 — 儿童服装绳索与束带
  • iso_105 ISO 105 — 色牢度
  • iso_13934 ISO 13934 — 拉伸强度
  • iso_12947 ISO 12947 — 耐磨性
  • iso_12945 ISO 12945 — 起球性
  • en_13402 EN 13402 — 尺码标注
  • bci BCI(良好棉花发展协会)
  • grs GRS(全球回收标准)
  • bluesign bluesign®

发布可能拒绝列表之外的值。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 中发送。

材料成分

material_composition材料成分

产品的纤维含量。添加各纤维类型及占比(总计须为 100%)。

类型

array

  • fiber 纤维的名称,以文本表示。
  • percentage 该纤维的占比,以 % 计。
  • recycledPercentage 该纤维中已回收部分的占比,以 % 计。
  • country 该纤维的国家代码:两个大写字母,例如 PT。
[
  {
    "fiber": "cotton",
    "percentage": 60,
    "recycledPercentage": 20,
    "country": "PT"
  },
  {
    "fiber": "polyester",
    "percentage": 40
  }
]
发布

发布时要求提供。

来源
  • Reg (EU) 1007/2011 Art. 9 in_force
  • ESPR (Reg (EU) 2024/1781) Annex I(d) anticipated
访问级别

public 公开

material_composition_method成分检测方法

确定纤维成分所用的方法。EN 12127 测量织物的单位面积质量,不用于确定纤维成分。

类型

select

列表中的值
  • iso_1833 ISO 1833 — 定量化学分析
  • iso_20705 ISO 20705 — 定量显微分析
  • iso_17751 ISO 17751 — 动物纤维鉴别与定量分析
  • en_12127 EN 12127 — 单位面积质量
  • manufacturer_declaration 制造商声明
  • supplier_certificate 供应商证书
  • other 其他

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

访问级别

restricted 受限

material_components成分明细(选填)

多组件产品的各部件纤维成分明细(例如面料、里料、饰边)。上方的平铺材料成分仍为权威数据,本项仅作补充说明。

类型

array

  • component 产品某个部件的名称,例如 Shell 或 Lining。
  • fibers 该部件的纤维。每个条目都包含 fiber、percentage 和 recycledPercentage 这几个键,与 material_composition 中的相同。
[
  {
    "component": "Shell",
    "fibers": [
      {
        "fiber": "cotton",
        "percentage": 100
      }
    ]
  },
  {
    "component": "Lining",
    "fibers": [
      {
        "fiber": "polyester",
        "percentage": 100
      }
    ]
  }
]
来源
  • Reg (EU) 1007/2011 Art. 11 in_force
  • ESPR (Reg (EU) 2024/1781) Annex I(d) anticipated
访问级别

public 公开

pfas_declarationPFAS 申报

说明是否有意添加了 PFAS(全氟和多氟烷基物质)。法国自 2026 年 1 月 1 日起对服装和鞋类中的 PFAS 实施限制,具体适用须考虑浓度限值、豁免及过渡规定。

留空表示“未申报”。申报“无有意添加”前,请核查供应商提供的证明材料。该申报不能证明产品不含 PFAS,也不能证明符合法规。

类型

select

列表中的值
  • no_intentionally_added 不含有意添加的PFAS
  • contains_intentionally_added 含有有意添加的PFAS

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

访问级别

public 公开

microfibre_shedding微纤维释放

该产品在洗涤时是否会释放塑料微纤维。根据法国 AGEC 法,合成纤维占比超过 50% 的产品(适用范围内的卖家)须填写此项。

类型

select

列表中的值
  • released 洗涤时会释放塑料微纤维
  • not_applicable 不适用(非主要合成材料)
  • unknown 未知/未评估

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

来源
  • AGEC Décret 2022-748 microfibre FR in_force_conditional

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

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

public 公开

net_weight_grams净重

成品净重,以克为单位。该数值同时也是法国环境成本评分(coût environnemental,Ecobalyse)的「质量」输入项。

请称量不含包装的成品。

类型

number

计量单位

g

限制

min: 1

访问级别

public 公开

护理说明

care_instructions_text护理说明(文字)

以文字形式描述的护理说明

类型

text

访问级别

public 公开

care_instructions护理说明

选择适用于您产品的护理符号。

类型

array item_type: string

列表中的值
全部 30 个值
  • machine_wash_30 机洗 30°C
  • machine_wash_40 机洗 40°C
  • machine_wash_50 机洗 50°C
  • machine_wash_60 机洗 60°C
  • machine_wash_95 机洗 95°C
  • gentle_wash_30 轻柔机洗 30°C
  • gentle_wash_40 轻柔机洗 40°C
  • very_gentle_wash_30 极轻柔机洗 30°C
  • hand_wash 手洗
  • do_not_wash 不可水洗
  • any_bleach 漂白(可用任何漂白剂)
  • non_chlorine_bleach 仅限非氯漂白剂
  • do_not_bleach 不可漂白
  • tumble_dry_normal 滚筒烘干,常温
  • tumble_dry_low 滚筒烘干,低温
  • tumble_dry_high 滚筒烘干,高温
  • do_not_tumble_dry 不可滚筒烘干
  • line_dry 悬挂晾干
  • flat_dry 平铺晾干
  • drip_dry 滴干
  • iron_low 熨烫,低温(最高 110°C)
  • iron_medium 熨烫,中温(最高 150°C)
  • iron_high 熨烫,高温(最高 200°C)
  • do_not_iron 不可熨烫
  • no_steam 不使用蒸汽熨烫
  • dry_clean_any 干洗(任何溶剂)
  • dry_clean_petroleum 干洗,仅限石油溶剂
  • do_not_dry_clean 不可干洗
  • wet_clean 专业湿洗
  • do_not_wet_clean 不可湿洗

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

访问级别

public 公开

safety_information安全信息/警告

消费者需要了解的任何安全警告或注意事项(例如童装拉绳窒息风险、易燃性说明、过敏原整理剂等)。如产品在正常使用下无需特别说明,请留空。

类型

text

来源
  • GPSR (Reg (EU) 2023/988) Art. 9 in_force
  • ESPR (Reg (EU) 2024/1781) Annex III(f) anticipated
访问级别

public 公开

生产详情

country_of_manufacture制造国

请选择产品的制造国家。

类型

text

格式

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

来源
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

访问级别

public 公开

manufacturing_date生产日期

该物品或批次的生产日期

类型

date

访问级别

restricted 受限

batch_number批次号

用于溯源的生产批次标识

类型

text

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

restricted 受限

country_of_spinning纺纱国家

请选择纱线纺制所在国家(用于计算 coût environnemental,即法国官方环境成本评分)。

类型

text

格式

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

来源
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

访问级别

public 公开

country_of_weaving_knitting织造/针织国家

如有织造或针织工序,请选择该工序主要进行的国家。对于在法国向消费者销售、属于 AGEC 适用范围的全新纺织品,企业满足相应营业额和数量条件时须披露此信息。

类型

text

格式

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

来源
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

访问级别

public 公开

country_of_dyeing_printing染色/印花国家

如有染色或印花工序,请选择该工序主要进行的国家。对于在法国向消费者销售、属于 AGEC 适用范围的全新纺织品,企业满足相应营业额和数量条件时须披露此信息。

类型

text

格式

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

来源
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

访问级别

public 公开

country_of_confection缝制国家(组装)

如有成衣组装工序,请选择该工序主要进行的国家。对于在法国向消费者销售、属于 AGEC 适用范围的全新纺织品,企业满足相应营业额和数量条件时须披露此信息。

类型

text

格式

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

来源
  • AGEC Décret 2022-748 geographic traceability FR in_force_conditional

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

访问级别

public 公开

number_of_references款式数量

计算法国环境成本时,请填写该品牌在本产品所属细分市场中,一个自然年内同一天在售服装款式的最大数量。每种产品与颜色组合计为一款,所有尺码合并计算。请遵循官方关于销售渠道和不计入项目的规则。

类型

number

限制

min: 1 max: 999999

来源
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

访问级别

restricted 受限

price零售价格(€)

法国环境成本计算方法所规定的参考销售渠道中的单件零售价,以欧元计,含增值税,不计促销和打折优惠。

仅用于法国申报,不会显示在公开护照中。

类型

number

限制

min: 1 max: 1000

来源
  • Décret n° 2025-957 (affichage environnemental) coût environnemental calculation inputs FR in_force_conditional

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

访问级别

restricted 受限

epr_registration_numberEPR 生产者注册号

您在欧盟纺织品生产者责任延伸(EPR)制度下的生产者注册号。

在法国,此编号即为您的 ADEME 唯一识别号(UIN)。

类型

text

访问级别

public 公开

耐久性与可修复性

expected_lifetime_wears预计使用寿命(穿着次数)

正常使用条件下的预计穿着次数

类型

number

限制

min: 1

访问级别

public 公开

repairability_score可修复性评分

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

类型

number

限制

min: 0 max: 10

访问级别

public 公开

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

repair_instructions_url维修指南 URL

维修指南、备件信息或服务网点的链接,或上传文件。

类型

url

访问级别

public 公开

可由文件代替

document

文件的 ID 在 repair_instructions_url__document_id 中发送。