{
"status": "ok"
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40656/service+health+check' --header 'Authorization: Bearer YOUR_API_KEY'
{
"api_version": "1.0.0",
"data": {
"imported_at": "2026-11-18T17:19:47+00:00",
"schema_version": 1,
"available_years": [
2026,
2027
],
"transitions": [
{
"from_year": 2026,
"to_year": 2027
}
],
"correspondence_basis": "derived_from_official_texts",
"coverage": "All 8-digit CN subheadings of Annex I to Regulation (EEC) No 2658/87 as published for 2026 and 2027. TARIC (10-digit) codes, duty rates and national codes are not covered."
},
"status_definitions": {
"unchanged": "The code exists in both versions with identical official description and parent lines, and no CN code was added or removed in its 6-digit HS subheading.",
"modified": "The code exists in both versions, but its official description or a parent line changed, or other CN codes were added/removed in the same 6-digit HS subheading, so its scope may have changed. Manual review required.",
"added": "The code exists only in the target version (new code). Possible predecessor codes are listed.",
"removed": "The code exists only in the source version and no corresponding code could be identified.",
"replaced": "The code exists only in the source version and corresponds to exactly one new code, which itself has no other predecessor (one-to-one).",
"split": "The code exists only in the source version and corresponds to two or more new codes, none of which has another predecessor (one-to-many). Manual review required.",
"merged": "The code exists only in the source version and its single corresponding code also receives goods from other codes (many-to-one). Manual review required.",
"ambiguous": "The code exists only in the source version and its correspondence is many-to-many; all candidate codes are returned. Manual review required.",
"unknown": "The code is well formed but is not a CN code in either version covered by this API."
},
"correspondence_basis_definitions": {
"official_correspondence_table": "Pair listed in an official EU correspondence table (Eurostat).",
"derived_same_hs6_new_codes": "Derived from the two official annexes: the code was deleted and the candidate was created within the same 6-digit HS subheading (HS subheadings are identical in CN 2026 and CN 2027, so goods cannot move to another HS subheading).",
"derived_same_hs6_retained_codes": "Derived from the two official annexes: no new code exists in the same 6-digit HS subheading, so the candidate is an existing code of that subheading."
},
"sources": [
{
"role": "cn_annex_2026",
"title": "Commission Implementing Regulation (EU) 2025/1926, Annex I (Combined Nomenclature 2026), Formex 4 XML, English",
"publisher": "Publications Office of the European Union (EUR-Lex / Cellar)",
"url": "http://publications.europa.eu/resource/cellar/c3c0d050-b5fa-11f0-b37f-01aa75ed71a1.0006.02/DOC_1",
"license": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated).",
"sha256": "23324fedd02019fdff810db0f7fd3e42ff11300e7b5eeec4fe8be75ba0f7bd12",
"retrieved_at": "2026-11-18T17:19:41+00:00",
"used_for": "Complete list of CN 2026 8-digit codes, official descriptions, hierarchy, supplementary units",
"modifications": "Extracted the 'Schedule of customs duties' tables; dashes converted to depth; duty rates not used."
},
{
"role": "cn_annex_2027",
"title": "Commission Implementing Regulation (EU) 2026/2163, Annex I (Combined Nomenclature 2027), Formex 4 XML, English",
"publisher": "Publications Office of the European Union (EUR-Lex / Cellar)",
"url": "http://publications.europa.eu/resource/cellar/f70de77f-d403-11f1-9458-01aa75ed71a1.0006.02/DOC_1",
"license": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated).",
"sha256": "f99ae077f81f795d9a29e749ea5e5d5979ea2a4af6b24f726c3945d96c47760e",
"retrieved_at": "2026-11-18T17:19:41+00:00",
"used_for": "Complete list of CN 2027 8-digit codes, official descriptions, hierarchy, supplementary units",
"modifications": "Extracted the 'Schedule of customs duties' tables; dashes converted to depth; duty rates not used."
},
{
"role": "eurostat_cn_texts",
"title": "Eurostat Comext CN classification (CN.txt, English)",
"publisher": "Eurostat",
"url": "https://ec.europa.eu/eurostat/api/dissemination/files/?sort=1&downfile=comext%2FCOMEXT_METADATA%2FCLASSIFICATIONS_AND_RELATIONS%2FCLASSIFICATIONS%2FENGLISH%2FCN.txt",
"license": "© European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
"sha256": "da4703237379350c8f86d8d2922e1bf4553b72d630ba6088bbd5462438bf4dcd",
"retrieved_at": "2026-11-18T17:19:41+00:00",
"used_for": "Cross-check of the CN 2026 code list; self-explanatory English texts for CN 2026 codes",
"modifications": "Filtered to 8-digit codes valid for the whole of 2026; Comext pseudo-codes dropped."
},
{
"role": "eurostat_pred_succ",
"title": "Eurostat Comext CN8 predecessor/successor relations",
"publisher": "Eurostat",
"url": "https://ec.europa.eu/eurostat/api/dissemination/files/?sort=1&downfile=comext%2FCOMEXT_METADATA%2FCLASSIFICATIONS_AND_RELATIONS%2FRELATIONS%2FCN8-PRED-SUCC.txt",
"license": "© European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
"sha256": "a5a28c853da4db6a16c4f5f06abbf59d69b9eee468d838842fcd3ecea5db5fba",
"retrieved_at": "2026-11-18T17:19:41+00:00",
"used_for": "Official CN 2026 -> CN 2027 correspondences, when Eurostat has published them",
"modifications": "Filtered to successors valid from 1 January 2027."
}
],
"attribution": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated). © European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
"disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40657/api+status+and+data+sources' --header 'Authorization: Bearer YOUR_API_KEY'
{
"versions": [
{
"year": 2026,
"legal_basis": "Commission Implementing Regulation (EU) 2025/1926",
"celex": "32025R1926",
"eli": "http://data.europa.eu/eli/reg_impl/2025/1926/oj",
"official_journal": "OJ L, 2025/1926, 31.10.2025",
"eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32025R1926",
"adopted": "2025-09-22",
"applies_from": "2026-01-01",
"applies_to": "2026-12-31",
"in_force_today": true,
"cn_code_count": 9791
},
{
"year": 2027,
"legal_basis": "Commission Implementing Regulation (EU) 2026/2163",
"celex": "32026R2163",
"eli": "http://data.europa.eu/eli/reg_impl/2026/2163/oj",
"official_journal": "OJ L, 2026/2163, 30.10.2026",
"eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32026R2163",
"adopted": "2026-09-17",
"applies_from": "2027-01-01",
"applies_to": "2027-12-31",
"in_force_today": false,
"cn_code_count": 9809
}
],
"default_year": 2026
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40658/list+cn+versions' --header 'Authorization: Bearer YOUR_API_KEY'
{
"cn_codes_per_year": {
"2026": 9791,
"2027": 9809
},
"transitions": [
{
"from_year": 2026,
"to_year": 2027,
"added_codes": 35,
"removed_codes": 17,
"retained_codes": 9774,
"by_status": {
"unchanged": 9756,
"modified": 18,
"added": 35,
"removed": 0,
"replaced": 0,
"split": 10,
"merged": 0,
"ambiguous": 7
},
"correspondences": 55,
"correspondences_by_basis": {
"derived_same_hs6_new_codes": 55
},
"hs_subheadings_with_new_or_deleted_codes": 13,
"changed_codes_by_chapter": {
"02": 3,
"03": 3,
"39": 6,
"44": 10,
"64": 7,
"72": 5,
"73": 5,
"76": 10,
"84": 1,
"85": 20
},
"manual_review_required": 70
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40659/cn+change+statistics' --header 'Authorization: Bearer YOUR_API_KEY'
{
"code": "02013000",
"code_formatted": "0201 30 00",
"year": 2026,
"valid": true,
"valid_in_years": [
2026
],
"version": {
"legal_basis": "Commission Implementing Regulation (EU) 2025/1926",
"applies_from": "2026-01-01",
"applies_to": "2026-12-31",
"eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32025R1926"
},
"description": "Boneless",
"hierarchy": [
"Meat of bovine animals, fresh or chilled"
],
"chapter": "02",
"heading": "0201",
"hs_subheading": "020130",
"supplementary_unit": null,
"eurostat_self_explanatory_text": "Fresh or chilled bovine meat, boneless",
"disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40660/look+up+cn+code?year=2026&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"code": "02013000",
"code_formatted": "0201 30 00",
"from_year": 2026,
"to_year": 2027,
"status": "split",
"status_definition": "The code exists only in the source version and corresponds to two or more new codes, none of which has another predecessor (one-to-many). Manual review required.",
"valid_in_from_year": true,
"valid_in_to_year": false,
"manual_review_required": true,
"reasons": [
"correspondence_derived_from_official_texts"
],
"from": {
"description": "Boneless",
"hierarchy": [
"Meat of bovine animals, fresh or chilled"
],
"chapter": "02",
"heading": "0201",
"hs_subheading": "020130",
"supplementary_unit": null,
"eurostat_self_explanatory_text": "Fresh or chilled bovine meat, boneless"
},
"to": null,
"successor_candidates": [
{
"code": "02013010",
"code_formatted": "0201 30 10",
"year": 2027,
"description": "Tenderloin, rib steak, flank steak, sirloin and rump steak",
"hierarchy": [
"Meat of bovine animals, fresh or chilled",
"Boneless"
],
"basis": "derived_same_hs6_new_codes"
},
{
"code": "02013090",
"code_formatted": "0201 30 90",
"year": 2027,
"description": "Other",
"hierarchy": [
"Meat of bovine animals, fresh or chilled",
"Boneless"
],
"basis": "derived_same_hs6_new_codes"
}
],
"predecessor_candidates": [],
"other_codes_in_same_hs_subheading": [
{
"code": "02013010",
"status": "added"
},
{
"code": "02013090",
"status": "added"
}
],
"disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40661/cn+code+migration+2026+to+2027?from_year=2026&to_year=2027&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"from_year": 2026,
"to_year": 2027,
"type": "split",
"chapter": null,
"page": 1,
"page_size": 3,
"total": 10,
"total_pages": 4,
"items": [
{
"code": "02013000",
"code_formatted": "0201 30 00",
"status": "split",
"presence": "only_in_from",
"manual_review_required": true,
"description": "Boneless",
"hierarchy": [
"Meat of bovine animals, fresh or chilled"
],
"related_codes": [
"02013010",
"02013090"
]
},
{
"code": "39076100",
"code_formatted": "3907 61 00",
"status": "split",
"presence": "only_in_from",
"manual_review_required": true,
"description": "Having a viscosity number of 78 ml/g or higher",
"hierarchy": [
"Polyacetals, other polyethers and epoxide resins, in primary forms; polycarbonates, alkyd resins, polyallyl esters and other polyesters, in primary forms",
"Poly(ethylene terephthalate)"
],
"related_codes": [
"39076110",
"39076190"
]
},
{
"code": "39076900",
"code_formatted": "3907 69 00",
"status": "split",
"presence": "only_in_from",
"manual_review_required": true,
"description": "Other",
"hierarchy": [
"Polyacetals, other polyethers and epoxide resins, in primary forms; polycarbonates, alkyd resins, polyallyl esters and other polyesters, in primary forms",
"Poly(ethylene terephthalate)"
],
"related_codes": [
"39076910",
"39076990"
]
}
]
}
curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40662/list+changed+cn+codes?type=split&chapter=85&page=1&page_size=50&from_year=2026&to_year=2027' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 欧盟 CN 编码迁移 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
查看欧盟组合命名法(CN)代码从2026年到2027年的变化:状态、后继代码和人工审核标记。对应关系仅供参考,可能需要人工审核。批量请求最多可接受10个代码
欧盟 CN 编码迁移 API 允许用户查看欧盟组合命名法(CN)编码预计如何从 2026 年分类期变更为 2027 年分类期。它提供有关这些变更状态的信息,标明后续编码,并标记可能需要人工审核的编码
该 API 提供 CN 编码的迁移状态、下一分类期对应的后继编码(如适用),以及一个标志,指示是否建议对已识别的对应关系进行人工审核
是的,该 API 支持批量请求。用户可以在单个批量请求中提交最多 10 个 CN 代码,以高效查询其迁移状态
该 API 接受 CN 代码列表或数组作为批量请求的输入。具体结构取决于实际实现,但通常是一个字符串 JSON 数组,其中每个字符串都是一个 CN 代码。
CN 代码通常以字母数字字符串表示。API 要求将这些代码作为字符串数据类型提供。 .
API 响应通常以 JSON 格式返回。对于每个输入的 CN 编码,它将提供迁移状态、后续编码和人工审核标志等详细信息
“status”字段表示 CN 编码迁移检查的结果。这可能包括“已迁移”“无变化”“已停用”或与分类周期之间转换相关的其他状态信息。
“successor_code”字段提供了新的 CN 编码,预计将在后续分类期(例如,从 2026 年查询时为 2027 年)取代输入编码。如果没有直接的后继编码或该编码已停用,此字段可能为 null 或缺失
“manual_review_flag”是一个布尔值或指示标志,用于表明自动确定的新旧 CN 编码对应关系是否需要进一步人工核验。“true”或“yes”表示由于可能存在复杂情况或歧义,建议进行人工审核
从事国际贸易的企业可以使用此 API 主动识别其现有的 CN 编码将如何变化。这使他们能够提前更新产品分类、海关申报和内部系统,确保合规并避免延误
核心价值主张是让企业清晰预见欧盟合并命名法编码即将发生的变化,从而顺利管理过渡、保持合规并优化贸易运营
不,API 明确说明这些对应关系仅供参考。“manual_review_flag”标记表明,某些转换可能需要专家人工判断,以确保分类正确
单次查询有助于快速核实特定产品 CN 编码的迁移状态,例如在推出新产品或对某个具体分类存疑时
可通过使用海关管理系统中的 CN 编码列表调用 API 端点来集成该 API 返回的迁移数据随后可用于更新产品主数据标记需要审核的商品或自动更新分类
批量请求功能显著提升了效率,用户可以同时查询多个 CN 编码,从而减少 API 调用次数和处理时间,这对于大型产品目录至关重要
根据描述,该 API 专门关注从 2026 年到 2027 年的过渡。它似乎不提供其他时期的历史迁移数据】【。
单个查询响应通常是一个 JSON 对象,其中包含诸如“original_code”“migration_status”“successor_code”和“manual_review_flag”等字段,用于表示查询的代码
通过提前通知 CN 编码变更并指出需要人工审核的潜在问题,该 API 可帮助企业确保其分类符合最新的欧盟贸易法规并保持最新状态
对于报关行而言,“manual_review_flag”起到预警系统的作用。它会将其注意力引向特定的、并非一目了然的 CN 编码转换,这些转换需要他们凭借专业知识确认正确的分类,从而降低出错和受罚的风险
所提供的 API 描述侧重于迁移结果(状态、后继项、审核标记),而非变更背后的原因。具体代码变更的详细说明可能需要查阅欧盟官方关税出版物
当 API 服务正在运行且 CN 数据库可用时,它会返回一个小型 JSON 对象,例如 `{"status":"ok"}`。此端点用于运行监控,不会返回 CN 编码、迁移结果或分类数据
它返回 API 版本、数据导入元数据、架构版本、可用的 CN 年份、支持的转换、对应关系依据、覆盖范围说明以及迁移状态的定义。使用它来解读响应字段,并确认哪些数据集和转换可用
覆盖范围包括《第2658/87号条例(EEC)》附件一中已发布的2026年和2027年版本所列的所有8位CN子目。答复可包含描述、层级、章、品目、HS子目、补充单位以及按年份划分的有效性。不包括TARIC代码、关税税率和国家代码。
它返回一个 JSON 数组,用于描述每个可用的中文版本。每个项目可能包含年份、法律依据、CELEX 和 ELI 标识符、《官方公报》参考信息、EUR-Lex 网址、通过日期、适用期限、代码数量以及该版本当前是否有效
迁移响应标明源年份和目标年份、状态、状态定义、在各年份的有效性、人工审核标记、原因,以及源分类和目标分类的详细信息。对于非直接变更,`successor_candidates`或前置候选项可能会列出相关代码及其描述。
状态包括 `unchanged`、`modified`、`added`、`removed`、`replaced`、`split`、`merged` 和 `ambiguous`。它们的确切含义由 API Status 端点提供。例如,`split` 表示一个源代码对应多个新代码,需要人工审核】【。
请求可以指定源年份、目标年份、变更 `type`、两位数的 `chapter`、`page` 和 `page_size`。响应包含已应用的筛选条件、分页信息、总数、总页数,以及一个包含变更代码、状态、是否存在、描述和相关代码的 `items` 数组
CN 编码是 8 位数值,可能包含空格或点号;这些分隔符会被忽略。响应会同时提供紧凑格式的 `code` 和格式化的 `code_formatted` 值。查询还会报告 `valid` 和 `valid_in_years`,使客户端能够区分无效编码与仅在另一个 CN 版本中有效的编码