Manual do Extrator de Chaves de Acesso

Aprenda como usar o Extrator de Chaves de Acesso para localizar chaves de NF-e, NFC-e, CT-e e MDF-e em arquivos XML, TXT, CSV, JSON, LOG ou HTML e exportar uma planilha limpa com uma chave por linha.

O Extrator de Chaves de Acesso é uma ferramenta gratuita do Nota Fiscal criada para localizar, organizar e exportar chaves de acesso de documentos fiscais eletrônicos a partir de arquivos como XML, TXT, CSV, JSON, LOG e HTML.

A ferramenta identifica chaves de 44 dígitos, utilizadas em documentos como NF-e, NFC-e, CT-e, CT-e OS e MDF-e. O processamento acontece diretamente no navegador, sem envio dos arquivos para o servidor.

Para que serve o Extrator de Chaves?

O extrator ajuda profissionais fiscais, contábeis e empresas a localizar rapidamente chaves de acesso dentro de arquivos diversos.

Ele pode ser útil em situações como:

• Recuperar chaves de acesso presentes em relatórios fiscais.
• Localizar chaves em arquivos XML, TXT, CSV, JSON, LOG ou HTML.
• Organizar chaves de NF-e, NFC-e, CT-e e MDF-e.
• Remover chaves duplicadas.
• Exportar uma planilha limpa com uma chave por linha.
• Analisar possíveis saltos de numeração em documentos de saída.

Quais arquivos posso importar?

A ferramenta aceita arquivos nos seguintes formatos:

A ferramenta foi configurada para aceitar até 20 arquivos por vez na versão gratuita. Esse limite está previsto no próprio código da ferramenta.

Como usar o Extrator de Chaves

1. Escolha o tipo de operação

Antes de importar os arquivos, selecione uma das opções:

A seleção ajuda a organizar a análise e também influencia a verificação de saltos de numeração, que é mais útil para documentos de saída.

2. Importe os arquivos

Você pode importar os arquivos de duas formas:

• Arrastando os arquivos para a área indicada.
• Clicando na área de upload e selecionando os arquivos no computador.

Depois de selecionar os arquivos, clique em:

Extrair chaves

A ferramenta fará a leitura dos arquivos diretamente no navegador. O código usa leitura local dos arquivos via navegador, sem necessidade de envio para servidor.

3. Aguarde o processamento

Durante a leitura, a ferramenta mostra o progresso da importação.

Ao final, ela informa que a extração foi concluída e atualiza os indicadores da tela:

A ferramenta localiza sequências numéricas de 44 dígitos, monta os dados da chave e identifica informações como UF, emissão, CNPJ, modelo, série, número e status.

O que a ferramenta identifica em cada chave?

Para cada chave de acesso localizada, o extrator pode organizar as seguintes informações:

Os modelos reconhecidos pela ferramenta incluem 55 NF-e, 65 NFC-e, 57 CT-e, 67 CT-e OS e 58 MDF-e.

O que significa “Chaves duplicadas”?

Quando a mesma chave aparece mais de uma vez nos arquivos importados, a ferramenta considera como duplicidade.

Exemplo:

Arquivo 1 contém a chave 3524...
Arquivo 2 também contém a mesma chave 3524...

Nesse caso, ela mantém apenas uma chave única na tabela principal e contabiliza a repetição no indicador Duplicadas. O código cria um mapa de chaves para remover repetições e manter apenas registros únicos.

O que são saltos de numeração?

Os saltos de numeração indicam possíveis intervalos faltantes entre documentos fiscais de uma mesma série, modelo e CNPJ emitente.

Exemplo:

NF-e número 100
NF-e número 101
NF-e número 104

Nesse caso, a ferramenta pode apontar que houve um salto entre os números 101 e 104, sugerindo ausência dos documentos 102 e 103.

Essa análise é especialmente útil para documentos de saída, pois ajuda a identificar possíveis lacunas na sequência de emissão.

A ferramenta agrupa os documentos por CNPJ, modelo e série, ordena a numeração e identifica intervalos faltantes.

Como pesquisar os resultados?

Depois da extração, você pode usar o campo de busca para localizar rapidamente informações como:

• Chave de acesso.
• CNPJ.
• Modelo fiscal.
• Série.
• Número do documento.
• UF.
• Nome do arquivo de origem.

A busca global verifica os campos dos registros extraídos e filtra os resultados conforme o termo digitado.

Como exportar as chaves?

Após a extração, você pode usar o botão:

Exportar Excel

A exportação recomendada deve gerar uma planilha com abas separadas:

A primeira aba deve conter apenas as chaves, sem texto antes, sem cabeçalho obrigatório e sem dados adicionais na mesma linha. Isso facilita copiar e colar as chaves em outros sistemas.

Exemplo de uso prático

Imagine que você recebeu um arquivo TXT exportado do ERP com várias informações fiscais misturadas:

Documento: NF-e
Chave: 35240112345678000199550010000123451000123456
Valor: 1500,00
Fornecedor: Empresa Exemplo Ltda

Ao importar esse arquivo no extrator, a ferramenta identifica a sequência de 44 dígitos e organiza a chave para consulta, análise ou exportação.

O arquivo é enviado para o servidor?

Não.

O processamento é feito localmente no navegador. Isso significa que os arquivos são lidos no próprio computador do usuário durante a sessão de uso da ferramenta.

Mesmo assim, por boas práticas de segurança, evite usar arquivos que contenham dados sensíveis desnecessários, quando não houver necessidade de análise.

O extrator baixa XML automaticamente?

Não.

O extrator apenas localiza e organiza chaves de acesso.

Para baixar XMLs, consultar eventos ou recuperar documentos fiscais antigos, é necessário utilizar uma solução específica de consulta e recuperação de XML, respeitando as regras da SEFAZ, certificado digital, manifestação do destinatário e disponibilidade legal dos documentos.

Quando usar essa ferramenta?

Use o extrator quando você tiver:

• Arquivos SPED com chaves no Registro C100.
• Relatórios do ERP com chaves fiscais.
• XMLs acumulados em pastas.
• Listas de chaves em TXT ou CSV.
• Logs de integração fiscal.
• Arquivos exportados de sistemas contábeis ou fiscais.
• Necessidade de montar uma planilha limpa com chaves de acesso.

Limitações da ferramenta

A ferramenta é de apoio e não substitui uma auditoria fiscal completa.

Algumas limitações importantes:

• Ela não baixa XML diretamente da SEFAZ.
• Ela não consulta eventos da NF-e ou CT-e.
• Ela não valida a situação fiscal do documento.
• Ela não verifica se o XML está autorizado, cancelado ou denegado.
• Ela depende das chaves estarem presentes no conteúdo dos arquivos importados.
• A versão gratuita limita a quantidade de arquivos processados por vez.

Próximo passo

Depois de extrair as chaves, você pode:

1. Exportar a planilha com as chaves.
2. Conferir duplicidades.
3. Avaliar possíveis saltos de numeração.
4. Usar as chaves para organizar seu acervo fiscal.
5. Buscar uma solução para recuperação ou automação de XMLs.

Se sua empresa ainda faz esse controle manualmente, vale avaliar uma solução de automação fiscal para monitorar documentos eletrônicos, capturar XMLs, organizar eventos e reduzir riscos de perda documental.