Stone Tax API

Fornece uma visão consolidada e totalizada do histórico de consultas de CNPJ realizadas pela aplicação.
Este recurso é estratégico para a gestão e bilhetagem do consumo, permitindo auditar o volume de requisições
processadas dentro de um período específico ou através de termos de busca.

📊 INDICADORES: O retorno contempla somatórios que auxiliam no controle operacional e financeiro do uso da API de consulta cadastral.

Permite listar consultas de CNPJ realizadas. O recurso retorna uma relação resumida das consultas, possibilitando a identificação de quais CNPJs foram consultados em um determinado período.

📋 PAGINAÇÃO: A listagem utiliza o padrão de offset e limit. É recomendável parametrizar o tamanho da página para otimizar o tempo de resposta e o tráfego de dados.

🔍 FILTROS: É possível refinar os resultados utilizando intervalos de datas ou filtro para localizar registros específicos no histórico.

Permite obter o detalhamento completo de uma consulta de CNPJ realizada anteriormente.
O recurso recupera os dados cadastrais e fiscais da entidade consultada conforme registrado no momento da transação original,
utilizando o identificador único gerado pelo histórico.

🔍 RASTRO: Este endpoint é essencial para auditoria e recuperação de dados de consultas anteriores sem a necessidade de realizar um novo consumo tarifado, desde que o ID do histórico esteja disponível.

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.

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.