CFOPs - Listar.
Fornece uma listagem completa dos Códigos Fiscais de Operações e Prestações (CFOP). Este recurso é fundamental para determinar a natureza da circulação de mercadorias ou a prestação de serviços.
⚠️ ATENÇÃO: A escolha incorreta do CFOP pode impactar diretamente na apuração de impostos e na validação da nota fiscal pela SEFAZ. Utilize os filtros para restringir a busca ao cenário de negócio desejado.
🔍 DICA DE INTEGRAÇÃO: Recomenda-se o cache dessas informações no sistema local, realizando consultas periódicas para capturar novos códigos ou alterações em indicadores de faturamento e devolução.
Query Parameters
Filtrar pelo código numérico do CFOP.
Filtrar por campo de busca genérico.
Tipo de operação do CFOP.
Allowed values:EntradaSaida
Tipo de destino do CFOP.
Allowed values:EstadualInterestadualExterior
Tipo de ICMS do CFOP.
Allowed values:IcmsTributadoIcmsRetidoAmbos
Tipo de destinatário do CFOP.
Allowed values:NaoContribuinteAmbos
Filtrar se permite emissão de NFe.
Filtrar se indica serviços de comunicação.
Filtrar se indica serviços de transporte.
Filtrar se caracteriza devolução.
Filtrar se envolve combustíveis.
Filtrar se compõe faturamento.
Quantidade de registros a serem pulados.
Default:1
Limite máximo de registros por página.
Default:10
Headers
Documento do emissor.
Response
Response
OK
ListarCfopsViewModelListPaginationResponse
Dados para listagem de CFOPs (Código Fiscal de Operações e de Prestações).
Show Child Parameters
Authentication
Query Parameters
Headers
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.