{
"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Migração do código CN da UE API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
(Economize 2 meses com cobrança anual 🎉)
Verifique como os códigos da Nomenclatura Combinada (NC) da UE mudam de 2026 para 2027: situação, códigos sucessores e sinalizadores de revisão manual. As correspondências são indicativas e podem exigir revisão manual. Os pedidos em lote aceitam até 10 códigos
A API de migração de códigos NC da UE permite que os utilizadores verifiquem como se espera que os códigos da Nomenclatura Combinada (NC) da UE mudem do período de classificação de 2026 para o de 2027. Fornece informações sobre o estado destas alterações, identifica os códigos sucessores e assinala os códigos que podem exigir uma análise manual
A API fornece o status da migração de um código CN, o código sucessor correspondente para o próximo período de classificação (se aplicável) e um indicador que informa se é recomendável uma revisão manual da correspondência identificada
Sim, a API aceita solicitações em lote. Os usuários podem enviar até 10 códigos CN em uma única solicitação em lote para verificar eficientemente o status da migração.
A API aceita uma lista ou array de códigos CN como entrada para solicitações em lote A estrutura exata dependerá da implementação específica mas normalmente será um array JSON de strings em que cada string é um código CN
Os códigos CN são normalmente representados como sequências alfanuméricas. A API espera que esses códigos sejam fornecidos como dados do tipo string. .
A resposta da API geralmente é retornada no formato JSON. Para cada código CN de entrada, ela fornecerá detalhes como o status da migração, o código sucessor e um indicador de revisão manual.
O campo 'status' indica o resultado da verificação de migração do código CN. Isso pode incluir informações como 'migrado', 'sem alteração', 'descontinuado' ou outros status relevantes relacionados à transição entre períodos de classificação
O campo 'successor_code' fornece o novo código CN que deverá substituir o código de entrada no período de classificação seguinte (por exemplo, 2027 se a verificação for feita a partir de 2026) Este campo pode ser nulo ou estar ausente se não houver um sucessor direto ou se o código tiver sido descontinuado
O 'manual_review_flag' é um valor booleano ou indicador que sugere se a correspondência determinada automaticamente entre o código CN antigo e o novo requer verificação humana adicional Um valor 'true' ou 'yes' indica que a revisão manual é recomendada devido a possíveis complexidades ou ambiguidades
Empresas envolvidas no comércio internacional podem usar esta API para identificar proativamente como seus códigos CN atuais serão alterados Isso permite que atualizem suas classificações de produtos, declarações alfandegárias e sistemas internos com antecedência, garantindo a conformidade e evitando atrasos
A principal proposta de valor é proporcionar clareza e previsibilidade sobre as próximas alterações nos códigos da Nomenclatura Combinada da UE, permitindo que as empresas gerenciem as transições sem problemas, mantenham a conformidade e otimizem suas operações comerciais
Não, a API declara explicitamente que as correspondências são indicativas. O 'manual_review_flag' destaca que algumas transições podem exigir o julgamento de especialistas humanos para garantir a classificação correta.
Uma única consulta é útil para verificar rapidamente o status de migração do código CN de um produto específico talvez quando um novo produto está sendo introduzido ou quando há dúvidas sobre uma classificação específica
A API pode ser integrada por meio de chamadas aos seus endpoints com listas de códigos CN do sistema de gestão aduaneira Os dados de migração retornados podem então ser usados para atualizar os dados mestres dos produtos sinalizar itens para revisão ou automatizar atualizações de classificação
O recurso de solicitação em lote melhora significativamente a eficiência ao permitir que os usuários verifiquem vários códigos CN simultaneamente, reduzindo o número de chamadas à API e o tempo de processamento, o que é crucial para catálogos de produtos grandes.
Com base na descrição, a API se concentra especificamente na transição de 2026 para 2027. Ela não parece fornecer dados históricos de migração para outros períodos. .
Uma resposta a uma única consulta normalmente seria um objeto JSON contendo campos como 'original_code', 'migration_status', 'successor_code' e 'manual_review_flag' para o código consultado
Ao fornecer aviso prévio sobre alterações nos códigos CN e destacar possíveis problemas que exigem revisão manual, a API ajuda as empresas a garantir que suas classificações estejam atualizadas e em conformidade com as regulamentações comerciais mais recentes da UE
Para um despachante aduaneiro, o 'manual_review_flag' funciona como um sistema de alerta. Ele direciona a atenção para transições específicas de códigos CN que não são simples e exigem sua experiência para confirmar a classificação correta, reduzindo assim o risco de erros e penalidades
A descrição da API fornecida concentra-se no resultado da migração (status, sucessor, indicador de revisão), em vez dos motivos subjacentes da alteração. Explicações detalhadas sobre mudanças específicas no código provavelmente exigiriam a consulta às publicações oficiais de tarifas da UE.
Retorna um pequeno objeto JSON, como `{"status":"ok"}`, quando o serviço da API está em execução e o banco de dados CN está disponível. Este endpoint destina-se ao monitoramento operacional e não retorna códigos CN, resultados de migração ou dados de classificação. .
Retorna a versão da API os metadados de importação de dados a versão do esquema os anos da CN disponíveis as transições compatíveis a base de correspondência a declaração de cobertura e as definições dos estados de migração Use-o para interpretar os campos da resposta e verificar quais conjuntos de dados e transições estão disponíveis
A cobertura inclui todas as subposições da NC de 8 dígitos do Anexo I do Regulamento (CEE) n.º 2658/87 para as versões publicadas de 2026 e 2027. As respostas podem incluir descrições, hierarquia, capítulo, posição, subposição do SH, unidades suplementares e validade por ano. Os códigos TARIC, as taxas dos direitos e os códigos nacionais estão excluídos. .
Retorna um array JSON que descreve cada versão CN disponível Cada item pode incluir o ano a base jurídica os identificadores CELEX e ELI a referência do Jornal Oficial a URL do EUR-Lex a data de adoção o período de aplicação a quantidade de códigos e se essa versão está atualmente em vigor
Uma resposta de migração identifica os anos de origem e destino, o status, a definição do status, a validade em cada ano, o indicador de revisão manual, os motivos e os detalhes das classificações de origem e destino. Para alterações não diretas, `successor_candidates` ou os candidatos a predecessores podem listar códigos relacionados com descrições.
Os status incluem `unchanged`, `modified`, `added`, `removed`, `replaced`, `split`, `merged` e `ambiguous`. Seus significados precisos são fornecidos pelo endpoint Status da API. Por exemplo, `split` indica que um código de origem corresponde a vários códigos novos e requer revisão manual. .
As solicitações podem especificar o ano de origem, o ano de destino, o `type` de alteração, o `chapter` de 2 dígitos, a `page` e o `page_size`. A resposta inclui os filtros aplicados, informações da página, contagem total, total de páginas e um array `items` contendo códigos alterados, status, presença, descrições e códigos relacionados
Os códigos CN são valores de 8 dígitos e podem ser fornecidos com espaços ou pontos; esses separadores são ignorados. As respostas fornecem tanto o valor compacto `code` quanto o valor formatado `code_formatted`. Uma consulta também informa `valid` e `valid_in_years`, permitindo que os clientes distingam um código inválido de um válido apenas em outra versão da CN. .