SEFAZ
Gere chaves de acesso de NF-e, valide números de documento, calcule dígitos verificadores e gere QRCode de NFC-e. Ferramentas para trabalhar com os protocolos e regras da SEFAZ.
Gerador de Chave de Acesso
Gere chaves de acesso para NF-e, NFC-e, CT-e e MDF-e. Suporta CNPJ alfanumérico (NT 2026.004).
Validador de Chave de Acesso
Valide chaves de acesso de 44 caracteres (alfanuméricos) e extraia as informações. NT 2026.004.
Gerador QRCode NFC-e
Gere o QRCode para NFC-e (Nota Fiscal de Consumidor Eletrônica) no formato exigido pela SEFAZ.
Calculadora DV
Calcule o dígito verificador de chaves de acesso com suporte a caracteres alfanuméricos (NT 2026.004).
Conversor cUF
Converta códigos de UF (cUF) em nomes de estados e vice-versa.
Guia
A SEFAZ (Secretaria da Fazenda) é o órgão responsável pela administração tributária nos estados brasileiros e pela emissão e validação de documentos fiscais eletrônicos. Cada estado possui sua própria SEFAZ, que autoriza a emissão de NF-e (Nota Fiscal Eletrônica), CT-e (Conhecimento de Transporte Eletrônico), MDF-e (Manifesto Eletrônico de Documentos Fiscais) e outros documentos. Entender os protocolos, chaves de acesso e regras de validação da SEFAZ é essencial para trabalhar com emissão fiscal.
Chave de acesso de NF-e
A chave de acesso de uma NF-e é um número de 44 dígitos que identifica unicamente cada documento fiscal eletrônico. Ela é composta por: código da UF (2 dígitos), AAMM (ano e mês de emissão, 2 dígitos), CNPJ do emitente (14 dígitos), modelo do documento (2 dígitos), série (3 dígitos), número do documento (9 dígitos), forma de emissão (1 dígito), código numérico aleatório (8 dígitos) e dígito verificador (1 dígito). Essa chave é usada para consulta, cancelamento e conferência do documento.
Dígito verificador (DV)
O dígito verificador da chave de acesso é calculado utilizando o algoritmo Módulo 11 sobre os primeiros 43 dígitos da chave. Esse DV serve para detectar erros de digitação na chave, garantindo que ela esteja correta antes de ser utilizada em consultas ou transmissões. O cálculo envolve multiplicar cada dígito por pesos crescentes (2, 3, 4, ..., até 9, reiniciando o ciclo), somar os produtos, calcular o módulo 11 e subtrair de 11. Se o resultado for 11, o DV é 0; se for 10, o DV é 0 por convenção.
Consultas na SEFAZ
A SEFAZ disponibiliza webservice para consultas como: situação da NF-e (autorizada, cancelada, denegada), chave de acesso para conferência (disponível em XML e DANFE), protocolo de autorização e eventos relacionados ao documento. Essas consultas são realizadas via web service SOAP ou, mais recentemente, via API REST em alguns estados. A chave de acesso é obrigatória para a maioria das consultas e deve ser mantida em banco de dados por pelo menos 5 anos.
QRCode de NFC-e
A NFC-e (Nota Fiscal do Consumidor Eletrônica) exibe um QRCode que permite ao consumidor consultar os dados da nota fiscal pelo celular. O QRCode é gerado a partir de uma URL que contém a chave de acesso, o valor total da nota, data e hora de emissão, e o token de segurança definido pela SEFAZ. A URL segue um padrão específico para cada estado, e o conteúdo deve ser codificado corretamente para que o QRCode seja lido pelos aplicativos de consulta.
Código numérico da chave
O código numérico é uma sequência de 8 dígitos aleatórios que faz parte da chave de acesso da NF-e. Sua função é tornar a chave imprevisível, evitando que terceiros possam "adivinhar" chaves de notas anteriores para consultar dados fiscais. O código numérico deve ser gerado de forma aleatória pelo sistema emissor e não pode seguir padrão sequencial ou baseado em dados previsíveis como data e hora.