NCMs - Listar.
Consulta a tabela de Nomenclatura Comum do Mercosul (NCM), utilizada para a classificação fiscal de mercadorias no comércio internacional e doméstico.
⚠️ VIGÊNCIA: Atente-se aos campos de data de vigência. Consultar NCMs expiradas pode ocasionar rejeições no momento da emissão do documento fiscal eletrônico.
🧪 TESTE: Em ambiente de sandbox, a tabela reflete a estrutura oficial, permitindo validar se a lógica de busca por descrição ou código atende aos requisitos do PDV ou ERP.
🔍 BUSCA SEMÂNTICA: O parâmetro ‘busca’ realiza uma varredura tanto na descrição do item quanto no segmento relacionado, facilitando a identificação correta da mercadoria.
Query Parameters
Filtrar pelo código NCM exato.
Filtrar pela extensão TIPI (EX).
Filtrar por campo de busca genérico.
Data de início de vigência “a partir de”.
Data de início de vigência “até”.
Data de fim de vigência “a partir de”.
Data de fim de vigência “até”.
Quantidade de registros a serem pulados (deslocamento).
Default:1
Limite máximo de registros por página.
Default:10
Headers
Documento do emissor.
Response
Response
OK
ListarNcmsViewModelListPaginationResponse
Dados para a listagem de NCMs.
Show Child Parameters
Authentication
Query Parameters
Headers
NCM - Obter detalhe.
Realiza uma consulta detalhada à tabela de Nomenclatura Comum do Mercosul (NCM), fornecendo informações sobre a classificação fiscal e tributos aproximados por UF.
🔍 CLASSIFICAÇÃO: O código NCM deve ser informado com 8 dígitos numéricos. O tributo aproximado deve ser informado em operações de vendas a consumidor final.
ℹ️ EXTENSÃO TIPI: Caso o produto possua uma exceção tarifária específica, utilize o parâmetro Extensão TIPI (Ex) para obter o detalhamento diferenciado aplicável ao código.
⚠️ ATENÇÃO: A utilização de NCMs inválidos ou extintos pode ocasionar a rejeição de documentos fiscais eletrônicos (NF-e/NFC-e) pelas Secretarias da Fazenda.
Query Parameters
Extensão TIPI do NCM. (Opcional)
Path Parameters
Código do NCM.
Headers
Documento do emissor.
Response
Response
OK
NcmViewModel
Dados detalhados do NCM.
Código da Nomenclatura Comum do Mercosul.
Código de extensão da TIPI (Tabela de Incidência do IPI).
Descrição completa da mercadoria ou serviço vinculada ao NCM.
Data de início da vigência do código NCM.
Example:2025-03-31
Data de término da vigência (opcional).
Dados dos tributos aproximados vinculados a um NCM (Lei da Transparência).
Show Child Parameters
Dados do CEST do NCM.
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Headers
CEST - Listar
Fornece uma listagem completa e atualizada dos códigos CEST, utilizados para identificar mercadorias e bens passíveis de Substituição Tributária (ST) e antecipação de ICMS.
O recurso permite a consulta técnica para auxiliar na correta classificação fiscal de produtos, garantindo que o vínculo entre o NCM e o CEST esteja em conformidade com o Convênio ICMS vigente.
🔍 DICA DE BUSCA: Utilize o filtro por busca para encontrar códigos baseados no agrupamento de mercadorias ou o filtro por código para validações diretas de conformidade.
Query Parameters
Filtrar pelo código CEST.
Filtrar por campo de busca genérico.
Paginação da listagem - offset.
Default:1
Paginação da listagem - limit.
Default:10
Headers
Documento do emissor.
Response
Response
OK
ListarCestsViewModelListPaginationResponse
Dados para listagem de Cests.
Show Child Parameters
Authentication
Query Parameters
Headers
CEST - Obter detalhe.
Permite obter informações detalhadas sobre o CEST com base no seu código identificador.
O recurso é fundamental para a correta identificação de mercadorias sujeitas aos regimes de
substituição tributária e antecipação do ICMS.
🔍 VINCULAÇÃO: O detalhamento auxilia na correlação entre o CEST e o NCM (Nomenclatura Comum do Mercosul),
garantindo que a classificação fiscal do produto esteja em conformidade com as exigências do CONFAZ.
Path Parameters
Código CEST.
Headers
Documento do emissor.
Response
Response
OK
ObterDetalheCestViewModel
Dados detalhados do CEST.
CEST - Código especificador da substituição tributária.
Descrição do CEST.
Dados do NCM no detalhe do CEST.
Show Child Parameters
Authentication
Path Parameters
Headers
Códigos de benefício - Listar.
Permite a consulta e listagem dos códigos de benefício fiscal parametrizados na plataforma.
Este recurso é essencial para a correta identificação de incentivos fiscais vinculados a determinados produtos ou operações,
garantindo a conformidade na emissão de documentos fiscais eletrônicos.
🔍 FILTROS: A busca pode ser refinada combinando o código técnico do benefício, termos contidos em sua descrição
ou restringindo os resultados a uma Unidade Federativa (UF) específica.
📑 PAGINAÇÃO: O retorno é paginado, permitindo o controle de fluxo de dados através dos parâmetros de offset e limit.
Query Parameters
Filtrar pelo código do benefício.
Filtrar por campo de busca genérico.
Unidade Federativa.
Allowed values:ROACAMRRPAAPTOMAPICERNPBPEALSEBAMGESRJSPPRSCRSMSMTGODF
Paginação da listagem - offset.
Default:1
Paginação da listagem - limit.
Default:10
Headers
Documento do emissor.
Response
Response
OK
ListarCodigosBeneficioViewModelListPaginationResponse
Dados de listagem do código de benefício fiscal.