Migração do código CN da UE API

API ID 15196

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. As solicitações em lote aceitam até 10 códigos.

Documentação da API

Endpoints

Requisição
Retorna ok quando o serviço está em execução e o banco de dados CN está disponível. Útil para monitorar o tempo de atividade; não contabiliza dados CN. .
Endpoint ID: 40656
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40656/service+health+check
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "status": "ok"
}
Verificação de integridade do serviço — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40656/service+health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Descreve a versão da API em execução, quando os dados da Nomenclatura Combinada foram importados pela última vez, as publicações oficiais usadas como base e o significado de cada status de migração retornado pelos outros endpoints
Endpoint ID: 40657
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40657/api+status+and+data+sources
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "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."
}
Status da API e fontes de dados — TRECHOS DE CÓDIGO

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' 


    
Requisição
Lista as versões da NC disponíveis na API atualmente 2026 e 2027 com a respetiva base jurídica referência do Jornal Oficial data de adoção período de aplicação número de códigos de 8 dígitos e qual versão está em vigor hoje
Endpoint ID: 40658
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40658/list+cn+versions
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "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
}
Listar versões CN — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40658/list+cn+versions' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Contagens reais de códigos CN por ano e das alterações entre 2026 e 2027: códigos adicionados, removidos, divididos, fundidos, ambíguos e modificados, alterações por capítulo e quantos códigos precisam de revisão manual
Endpoint ID: 40659
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40659/cn+change+statistics
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
JSON
{
    "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
        }
    ]
}
Estatísticas de alterações de CN — TRECHOS DE CÓDIGO

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40659/cn+change+statistics' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Requisição
Retorna a descrição oficial, a hierarquia, o capítulo, a posição, a subposição do SH e a unidade suplementar de um código NC de 8 dígitos numa determinada versão da NC, bem como as versões em que o código é válido. Os espaços e os pontos no código são ignorados. .Apenas o texto traduzido deve ser devolvido. Não adicione pontos nem vírgulas. Se ocorrer um erro na tradução, apenas «error» deve ser devolvido.
Endpoint ID: 40660
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40660/look+up+cn+code
PARÂMETROS DE ENTRADA

Consultar código CN — Recursos do endpoint

Objeto Descrição
year Opcional CN version year (2026 or 2027). Defaults to the version in force today.
code Obrigatório

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

year
RESPOSTA DE EXEMPLO DA API
JSON
{
    "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."
}
Consultar código CN — TRECHOS DE CÓDIGO

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' 


    
Requisição
Explica o que acontece com um código CN entre duas versões: seu status de migração, os códigos sucessores ou predecessores candidatos com suas descrições e se é necessária uma revisão manual da classificação antes da aplicação do resultado
Endpoint ID: 40661
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40661/cn+code+migration+2026+to+2027
PARÂMETROS DE ENTRADA

Migração do código CN de 2026 para 2027 — Recursos do endpoint

Objeto Descrição
from_year Opcional Source CN version year. Currently only 2026 is supported.
to_year Opcional Target CN version year. Currently only 2027 is supported.
code Obrigatório

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

from_year
to_year
RESPOSTA DE EXEMPLO DA API
JSON
{
    "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."
}
Migração do código CN de 2026 para 2027 — TRECHOS DE CÓDIGO

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' 


    
Requisição
Lista paginada de todos os códigos CN que mudam entre duas versões Filtre por tipo de alteração e por capítulo de 2 dígitos para planejar uma migração do catálogo ou revisar apenas os códigos relevantes para seus produtos
Endpoint ID: 40662
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40662/list+changed+cn+codes
PARÂMETROS DE ENTRADA

Listar códigos CN alterados — Recursos do endpoint

Objeto Descrição
type Opcional Change type to return: added, removed, replaced, split, merged, ambiguous or modified. Omit for all changes.
chapter Opcional 2-digit CN chapter to filter on, e.g. 85 for electrical machinery.
page Opcional Page number of the results, starting at 1.
page_size Opcional Number of items per page, from 1 to 100 (default 50).
from_year Opcional Source CN version year. Currently only 2026 is supported.
to_year Opcional Target CN version year. Currently only 2027 is supported.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

type
chapter
page
page_size
from_year
to_year
RESPOSTA DE EXEMPLO DA API
JSON
{
    "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"
            ]
        }
    ]
}
Listar códigos CN alterados — TRECHOS DE CÓDIGO

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' 


    

Chave de acesso à API e autenticação

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çalhos
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 🎉)

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

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

Migração do código CN da UE API FAQs

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. .

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas