Histórico de eventos - Listar.
Permite a listagem e rastreabilidade de eventos processados pela API de Notas Fiscais.
Fornece uma visão detalhada do ciclo de vida das requisições, permitindo auditoria técnica e funcional.
🔍 BUSCA ABRANGENTE: O campo de busca genérica atua sobre a rota acessada e o conteúdo (body) das requisições, facilitando a localização de transações específicas.
⏱️ PERFORMANCE: É possível filtrar eventos por tempo de execução (milissegundos), ideal para identificar gargalos operacionais ou latências atípicas no processamento.
🛡️ AUDITORIA: O filtro por sucesso ou erro permite isolar rapidamente falhas de integração ou validações de negócio impeditivas.
get
Query Parameters
tipoEventostring
Tipo de evento do contexto de notas fiscais.
Allowed values:PreNotaAutomaticaPreNotaSimplificadaEmissaoNfeEmissaoNfceAutomaticaEmissaoNfceSimplificadaEmissaoNfceCancelarNotaFiscalInutilizarFaixaNumeracaoTransmitirNotaFiscalEmitidaEmContingenciaEmitirNfeEstornoEmitirNfeDevolucaoEmitirNfeDevolucaoXmlObterDanfeNfeObterDanfeNfceObterArquivoXmlEmitirCartaDeCorrecaoObterXmlCartaCorrecaoObterArquivoXmlNfseObterDanfeNfseCancelarNotaFiscalServicoEmissaoNfse
sucessoboolean
Filtrar por eventos com sucesso ou erro.
buscastring
Termo de busca genérico (rota ou conteúdo).
dataInicialstring(date-time)
Filtrar pela data de início do evento “a partir de”.
dataFinalstring(date-time)
Filtrar pela data de início do evento “até”.
duracaoInicialMilissegundosnumber(double)
Filtrar pela duração mínima em milissegundos.
duracaoFinalMilissegundosnumber(double)
Filtrar pela duração máxima em milissegundos.
offsetinteger(int32)
Registro inicial para paginação.
Default:1
limitinteger(int32)
Quantidade de registros por página.
Default:10
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
ListarHistoricoEventosNotaFiscalViewModelListPaginationResponse
* Additional properties are NOT allowed.
offsetinteger(int32)
limitinteger(int32)
totalinteger(int32)
dataarray | null[object]
Dados da listagem do histórico de comandos de notas fiscais.
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1/DocumentoFiscal/HistoricoEventos/Listar
Authentication
Query Parameters
Headers
Histórico de eventos - Detalhe.
Permite obter o detalhamento completo de um evento específico vinculado a uma Nota Fiscal, utilizando o identificador único do histórico.
Esta operação é fundamental para a rastreabilidade de ocorrências e conferência de logs de processamento ou eventos fiscais (como cancelamentos, cartas de correção, etc.) registrados na plataforma.
get
Path Parameters
historicoEventoIdstring(uuid)required
Identificador único do histórico do evento.
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
ObterDetalheHistoricoEventosNotaFiscalViewModel
Dados detalhados do histórico de evento de nota fiscal.
* Additional properties are NOT allowed.
idstring(uuid)
Identificador interno do histórico do evento.
tipoEventostring
Tipo de evento do contexto de notas fiscais.
Allowed values:PreNotaAutomaticaPreNotaSimplificadaEmissaoNfeEmissaoNfceAutomaticaEmissaoNfceSimplificadaEmissaoNfceCancelarNotaFiscalInutilizarFaixaNumeracaoTransmitirNotaFiscalEmitidaEmContingenciaEmitirNfeEstornoEmitirNfeDevolucaoEmitirNfeDevolucaoXmlObterDanfeNfeObterDanfeNfceObterArquivoXmlEmitirCartaDeCorrecaoObterXmlCartaCorrecaoObterArquivoXmlNfseObterDanfeNfseCancelarNotaFiscalServicoEmissaoNfse
documentoEmissorstring | null
Documento (CPF/CNPJ) do emissor.
nomeEmissorstring | null
Nome ou Razão Social do emissor.
sucessoboolean
Indica se o processamento do evento foi realizado com sucesso.
rotastring | null
Rota ou endpoint do evento.
jsonEnviadostring | null
Conteúdo do body enviado na requisição.
jsonRetornadostring | null
Conteúdo retornado na requisição.
inicioExecucaostring(date-time)
Data de início da execução do evento.
finalExecucaostring(date-time)
Data do fim da execução do evento.
duracaoMilissegundosnumber(double)
Tempo de duração do evento em milissegundos.
duracaostring | null
Tempo de duração do evento.
get/api/v1/DocumentoFiscal/HistoricoEventos/{historicoEventoId}/ObterDetalhe
Authentication
Path Parameters
Headers
Histórico de eventos - Resumo.
Fornece uma visão consolidada e simplificada dos eventos vinculados ao processamento de Notas Fiscais.
Permite o monitoramento operacional através de filtros por tipo de evento, performance (duração) e status da execução.
get
Query Parameters
tipoEventostring
Tipo de evento do contexto de notas fiscais.
Allowed values:PreNotaAutomaticaPreNotaSimplificadaEmissaoNfeEmissaoNfceAutomaticaEmissaoNfceSimplificadaEmissaoNfceCancelarNotaFiscalInutilizarFaixaNumeracaoTransmitirNotaFiscalEmitidaEmContingenciaEmitirNfeEstornoEmitirNfeDevolucaoEmitirNfeDevolucaoXmlObterDanfeNfeObterDanfeNfceObterArquivoXmlEmitirCartaDeCorrecaoObterXmlCartaCorrecaoObterArquivoXmlNfseObterDanfeNfseCancelarNotaFiscalServicoEmissaoNfse
sucessoboolean
Filtrar por eventos com sucesso ou erro.
buscastring
Filtrar pela busca genérica por texto.
dataInicialstring(date-time)
Filtrar pela data de início do evento “a partir de”.
dataFinalstring(date-time)
Filtrar pela data de início do evento “até”.
duracaoInicialMilissegundosnumber(double)
Filtrar pela duração mínima em milissegundos.
duracaoFinalMilissegundosnumber(double)
Filtrar pela duração máxima em milissegundos.
Headers
DocumentoEmissorstringrequired
Documento do emissor.
Response
Response
OK
Resumo do histórico de eventos de nota fiscal.
* Additional properties are NOT allowed.
tipoEventostring
Tipo de evento do contexto de notas fiscais.
Allowed values:PreNotaAutomaticaPreNotaSimplificadaEmissaoNfeEmissaoNfceAutomaticaEmissaoNfceSimplificadaEmissaoNfceCancelarNotaFiscalInutilizarFaixaNumeracaoTransmitirNotaFiscalEmitidaEmContingenciaEmitirNfeEstornoEmitirNfeDevolucaoEmitirNfeDevolucaoXmlObterDanfeNfeObterDanfeNfceObterArquivoXmlEmitirCartaDeCorrecaoObterXmlCartaCorrecaoObterArquivoXmlNfseObterDanfeNfseCancelarNotaFiscalServicoEmissaoNfse
totalEventosinteger(int32)
Quantidade total de eventos registrados para o tipo de evento e filtros aplicados.
totalSucessointeger(int32)
Quantidade total de eventos processados com sucesso para o tipo de evento e filtros aplicados.
totalFalhainteger(int32)
Quantidade total de eventos processados com falha para o tipo de evento e filtros aplicados.
get/api/v1/DocumentoFiscal/HistoricoEventos/Resumo
Authentication
Query Parameters
Headers
RecursosAdicionais
Controlador de Recursos Adicionais e Tabelas Auxiliares da Stone Tax API.
Fornece acesso a tabelas normatizadas e metadados fiscais essenciais para o preenchimento de documentos eletrônicos,
garantindo a integridade dos dados de classificação e operação fiscal.
Centraliza a consulta a códigos de tabelas externas (como CFOP e NCM), permitindo que o sistema parceiro
valide parâmetros de negócio contra as regras vigentes da SEFAZ e órgãos reguladores.
Todos os recursos disponibilizados exigem autenticação e visam apoiar a manutenção de cadastros
mestres e a correta parametrização de fluxos de entrada e saída de mercadorias.
Localização e Logradouro - Consultar por CEP.
Realiza a busca detalhada de informações do logradouro com base no Código de Endereçamento Postal (CEP).
Este recurso é essencial para a padronização de cadastros de clientes, fornecedores e emissores, garantindo a integridade dos dados de localização.
⚠️ ATENÇÃO: O CEP informado deve conter apenas números (8 dígitos).
🔍 DICA DE INTEGRAÇÃO: Utilize este endpoint para o preenchimento automático de campos de endereço em interfaces de usuário, minimizando erros de digitação e facilitando o cálculo de alíquotas baseadas na localidade (ISS/ICMS).
get
Path Parameters
cepstringrequired
CEP - Código de Endereçamento Postal.
Headers
DocumentoEmissorstring
Documento do emissor.
Response
Response
OK
ConsultaCepViewModel
Dados detalhados da consulta de endereço via CEP.
* Additional properties are NOT allowed.
cepstring | null
Código de Endereçamento Postal.
logradourostring | null
Nome da rua, avenida ou logradouro.
complementostring | null
Informações adicionais do endereço.
bairrostring | null
Bairro onde se localiza o logradouro.
localidadestring | null
Nome da cidade ou localidade.
ufstring | null
Unidade Federativa (Estado).
ibgestring | null
Código do município no IBGE.
get/api/v1/RecursosAdicionais/Cep/{cep}/Consultar