Tabelas e Informações
1. Ambientes de Homologação e Produção
O ambiente de homologação destina-se aos testes e à integração das aplicações. A passagem para produção depende da aprovação interna das equipes de tecnologia e de negócios da empresa, após avaliação da adequação, do comportamento e da performance do sistema. NF3e de homologação não têm valor fiscal. Testes indevidos em produção podem acionar os controles de consumo indevido.
2. Tratamento de Caracteres Especiais no XML
Caracteres que afetam o parser XML devem ser representados por sequências de escape.
| Caractere | Sequência de escape |
|---|---|
| < | < |
| > | > |
| & | & |
| " | " |
| ' | ' |
Exemplo: DIAS & DIAS LTDA deve ser informado no XML como DIAS & DIAS LTDA.
3. CNPJ Alfanumérico
O CNPJ alfanumérico mantém 14 posições: oito caracteres alfanuméricos para a raiz, quatro caracteres alfanuméricos para a ordem do estabelecimento e dois dígitos verificadores numéricos. A previsão da NT Conjunta para o início da produção é 06/07/2026.
A expressão regular dos campos passa a ser [A-Z0-9]{12}[0-9]{2}. A NT registra que a exclusão das letras I, O, U, Q e F ainda dependia de confirmação da Receita Federal; por isso, esta página não impõe restrição adicional.
3.1. Cálculo dos Dígitos Verificadores
O cálculo permanece no módulo 11. Cada caractere é convertido pelo valor ASCII menos 48: algarismos mantêm seus valores, A corresponde a 17, B a 18 e assim sucessivamente até Z igual a 42. O primeiro DV é calculado sobre os 12 caracteres; para o segundo, acrescenta-se o primeiro DV e repete-se o procedimento.
4. Chave de Acesso da NF3e
| Campo | Quantidade | Conteúdo |
|---|---|---|
| cUF | 2 | UF do emitente |
| AAMM | 4 | Ano e mês da emissão |
| CNPJ | 14 | CNPJ do emitente |
| mod | 2 | Modelo 66 |
| serie | 3 | Série |
| nNF | 9 | Número da NF3e |
| tpEmis | 1 | Forma de emissão |
| nSiteAutoriz | 1 | Site do autorizador |
| cNF3e | 7 | Código numérico |
| cDV | 1 | Dígito verificador |
A chave totaliza 44 caracteres. A expressão regular preparada pela NT 2025.001 para o CNPJ alfanumérico é [0-9]{6}[A-Z0-9]{12}[0-9]{26}. A própria NT informa que as letras somente podem ser utilizadas após publicação de Nota Técnica que modifique as validações desses campos.
4.1. Cálculo do Dígito Verificador da Chave
O DV é calculado pelo módulo 11. Da direita para a esquerda, cada algarismo é multiplicado repetidamente pelos pesos 2 a 9. Soma-se a ponderação, divide-se por 11 e aplica-se:
DV = 11 - resto da divisãoQuando o resto for 0 ou 1, o DV será 0. No exemplo oficial, a soma das ponderações é 644, cujo resto na divisão por 11 é 6; portanto, o DV é 5.
5. Código de Barras CODE-128
Para suportar caracteres alfanuméricos na chave, a NT Conjunta define uso híbrido do CODE-128: inicia em CODE-128C e alterna para CODE-128A quando houver caracteres não numéricos. O CODE-128A admite algarismos e letras maiúsculas.
- Largura mínima total: 11,5 cm, tanto em impressoras de impacto quanto de não impacto.
- Altura mínima das barras: 0,8 cm.
- Largura mínima do módulo: 0,02 cm.
5.1. Dígito Verificador da Simbologia
O DV utiliza módulo 103 sobre a soma ponderada, incluindo o caractere inicial. No exemplo oficial 5225AB83:
| Código | Valor | Peso | Valor × Peso |
|---|---|---|---|
| START C | 105 | (1) | 105 |
| 52 | 52 | 1 | 52 |
| 25 | 25 | 2 | 50 |
| CODE A | 101 | 3 | 303 |
| 'A' (ASCII) | 33 | 4 | 132 |
| 'B' (ASCII) | 34 | 5 | 170 |
| CODE C | 99 | 6 | 594 |
| 83 | 83 | 7 | 581 |
| Soma | 1987 | ||
| Resto por 103 | 30 |
6. Número do Recibo de Lote - Serviço Desativado
O recibo pertence ao serviço assíncrono de lote, desativado pela NT 2024.002. A formação histórica é mantida para documentação:
| Parte | Posições | Regra |
|---|---|---|
| Código da UF | 2 | UF onde o lote foi entregue, conforme IBGE. |
| Tipo de autorizador | 1 | 1 = SEFAZ normal; 3 = SEFAZ Virtual RS. |
| Identificação do site | 1 | 0 = padrão; 1 a 9 = demais sites. |
| Sequencial | 12 | Posições numéricas sequenciais. |
7. Número do Protocolo
O Ambiente Autorizador gera um protocolo único para identificar as transações de autorização de uso e registro de eventos.
| Parte | Posições | Regra |
|---|---|---|
| Tipo de autorizador | 1 | 1 = SEFAZ Autorizadora; 3 = SEFAZ Virtual RS. |
| Código da UF | 2 | Código IBGE. |
| Ano | 2 | Dois últimos dígitos. |
| Site autorizador | 1 | Número do site que autorizou a NF3e. |
| Sequencial | 10 | Numeração anual. |
A NT 2022.001 reservou o tipo de autorizador 2 para o site alternativo de contingência do ambiente autorizador. No DANF3E, o protocolo é acompanhado de data no formato DD/MM/AAAA e hora no formato hh:mm:ss.
| Região | Códigos IBGE |
|---|---|
| Norte | 11-RO, 12-AC, 13-AM, 14-RR, 15-PA, 16-AP, 17-TO |
| Nordeste | 21-MA, 22-PI, 23-CE, 24-RN, 25-PB, 26-PE, 27-AL, 28-SE, 29-BA |
| Sudeste | 31-MG, 32-ES, 33-RJ, 35-SP |
| Sul | 41-PR, 42-SC, 43-RS |
| Centro-Oeste | 50-MS, 51-MT, 52-GO, 53-DF |
8. Tempo Médio de Resposta
O indicador mede a performance do serviço nos últimos cinco minutos. O tempo de processamento é contado entre o recebimento e o armazenamento da mensagem de resultado. Valores inferiores a um segundo são informados como um segundo, e frações são arredondadas para cima.
9. Relação de CFOP Válidos para NF3e
| CFOP | Descrição |
|---|---|
| 5.250 | Vendas de Energia Elétrica |
| 5.251 | Venda de energia elétrica para distribuição ou comercialização |
| 5.252 | Venda de energia elétrica para estabelecimento industrial |
| 5.253 | Venda de energia elétrica para estabelecimento comercial |
| 5.254 | Venda de energia elétrica para estabelecimento prestador de serviço de transporte |
| 5.255 | Venda de energia elétrica para estabelecimento prestador de serviço de comunicação |
| 5.256 | Venda de energia elétrica para estabelecimento de produtor rural |
| 5.257 | Venda de energia elétrica para consumo por demanda contratada |
| 5.258 | Venda de energia elétrica para não contribuinte |
10. Classificação de Produtos - cClass
A tabela de classificação determina validações e a natureza do item na totalização. Códigos iniciados por 5 deduzem do valor total da nota; os demais códigos, iniciados por 0, são somados.
10.1. Códigos Incluídos pelo IT NF3e 2025.001
| Código | Descrição |
|---|---|
| 0602700 | Energia Ativa - Consumo Baixa Renda - 0-80 kWh |
| 0602701 | Energia Ativa - Consumo Baixa Renda 0-80 kWh - TE |
| 0602702 | Energia Ativa - Consumo Baixa Renda 0-80 kWh - TUSD |
| 0602800 | Energia Ativa - Consumo Baixa Renda acima de 80 kWh |
| 0602801 | Energia Ativa - Consumo Baixa Renda acima de 80 kWh - TE |
| 0602802 | Energia Ativa - Consumo Baixa Renda acima de 80 - TUSD |
10.2. Códigos Incluídos pelo IT NF3e 2025.002
| Código | Descrição |
|---|---|
| 0602900 | Energia Ativa - Desconto Social consumo até 120 kWh |
| 0602901 | Energia Ativa - Desconto Social consumo até 120 kWh - TE |
| 0602902 | Energia Ativa - Desconto Social consumo até 120 kWh - TUSD |
| 0602903 | Energia Ativa - Desconto Social consumo acima de 120 kWh |
| 0602904 | Energia Ativa - Desconto Social consumo acima de 120 kWh - TE |
| 0602905 | Energia Ativa - Desconto Social consumo acima de 120 kWh - TUSD |
A tabela completa e atualizada é disponibilizada no Portal Nacional da NF3e.
11. Meios de Pagamento para Vinculação
O IT 2026.001 relaciona os códigos permitidos no grupo de vinculação da transação de pagamento. Código diferente dos abaixo causa a rejeição 1003 - Tipo de Pagamento inválido.
| Código | Descrição |
|---|---|
| 15 | Boleto |
| 17 | Pix QRCode |
| 18 | TED |
| 20 | PIX chave ou QRCode estático |
| 23 | Pix automático |
| 24 | TEF / booktransfer |
O IT 2024.002 v.1.11 registra a inclusão dos códigos 23 e 24 e a alteração das descrições dos códigos 18 e 20 na tabela nacional.
12. Tabelas do IBS e da CBS
O IT 2025.002 v.1.50 descreve as tabelas de cClassTrib, CST, crédito presumido e alíquotas padrão. Como os arquivos completos das tabelas não integram os documentos fornecidos, esta página reproduz apenas suas definições e os acessos oficiais.
12.1. Código de Classificação Tributária - cClassTrib
| Coluna | Significado |
|---|---|
| CST-IBS/CBS | Código de Situação Tributária do IBS e da CBS. |
| Descrição CST-IBS/CBS | Significado do CST. |
| cClassTrib | Classificação Tributária; os três primeiros dígitos coincidem com o CST. |
| Nome e descrição cClassTrib | Nome reduzido e situação tributária abrangida. |
| LC Redação / LC 214/25 | Redação e dispositivo legal correspondente. |
| Tipo de Alíquota | Tipo de alíquota aplicável. |
| pRedIBS / pRedCBS | Percentuais de redução das alíquotas. |
| Indicadores de grupos | Exigência, permissão ou vedação de grupos do DFe. |
| dIniVig / dFimVig | Início e fim da vigência. |
| DataAtualização | Última atualização da classificação. |
| Indicadores de modelos | Permissão do código por modelo, inclusive indNF3e. |
| ANEXO | Anexo da LC 214/2025; o anexo técnico usa o formato 9XXXY. |
| Link | Artigo legal correspondente. |
12.2. Tabela CST
| Coluna | Significado |
|---|---|
| CST-IBS/CBS | Código de Situação Tributária. |
| Descrição CST-IBS/CBS | Descrição da situação. |
| ind_gIBSCBS | Grupo padrão de IBS/CBS. |
| ind_gIBSCBSMono | Grupo do regime monofásico. |
| ind_gRed | Grupos de redução de alíquota. |
| ind_gDif | Grupos de diferimento. |
| ind_gTransfCred | Grupo de transferência de crédito. |
| ind_gCredPresIBSZFM | Crédito presumido de IBS na ZFM. |
| ind_gAjusteCompet | Ajustes por competência. |
| ind_RedutorBC | Redução da base de cálculo. |
12.3. Classificação do Crédito Presumido - cCredPres
| Coluna | Significado |
|---|---|
| cCredPres | Código da hipótese legal de crédito presumido. |
| Descrição | Descrição da hipótese. |
| LC 214/2025 | Dispositivo legal. |
| Apropria via NF? / evento? | Forma de apropriação do crédito. |
| indDeduzCredPres | Dedução no valor do tributo do item. |
| ind_gCBSCredPres / ind_gIBSCredPres | Exigência dos grupos de crédito presumido. |
| Alíquota CBS / IBS | Orientações sobre as alíquotas. |
| pAliqCredPresCBS / pAliqCredPresIBS | Percentuais específicos, quando aplicáveis. |
| cClass nota referenciada | Classificação da nota referenciada. |
| Campos de vigência | Vigência geral e específica para CBS e IBS. |
12.4. Alíquotas Padrão
| Ano | pIBSUF (%) | pIBSMun (%) | pCBS (%) |
|---|---|---|---|
| 2026 | 0,1 | 0 | 0,9 |
| 2027 | 0,05 | 0,05 | Aguardar legislação* |
| 2028 | 0,05 | 0,05 | Aguardar legislação* |
| 2029 em diante | Aguardar legislação* | Aguardar legislação* | Aguardar legislação* |
* Cada ente federativo define suas alíquotas por lei própria; na ausência, aplica-se a alíquota de referência fixada por resolução do Senado Federal.
12.5. Tabelas e Calculadoras On-line
- CST e cClassTrib - Plataforma da Reforma Tributária
- CST e cClassTrib - Portal DFE/SVRS
- Crédito presumido - Portal DFE/SVRS
- Serviços JSON, mediante certificado digital
- Calculadora on-line
- Calculadora off-line
13. Endereços dos Web Services
Os endereços oficiais podem ser obtidos no Portal Nacional da NF3e. A documentação WSDL é obtida acrescentando ?WSDL ao endereço do serviço desejado.

