NF-e: validar, entender a rejeição e achar o código do campo
Três perguntas resolvem quase toda emissão travada: o XML está válido?, por que a nota foi rejeitada? e qual valor esse campo aceita? Cada uma tem ferramenta ou tabela oficial aqui — com a regra de validação, não só a mensagem de erro.
Validador de XML — grupo IBS/CBS
Cola o XML e confere o grupo IBSCBS contra as regras da NT 2025.002: CST × cClassTrib, vigência, alíquota do ano, matemática por item e totalizadores. Cada achado linka a ficha da rejeição.
Rejeições da NF-e
1039 códigos cStat com o motivo oficial e a regra de validação que dispara cada erro — inclusive a série 1000+ da reforma.
Códigos de campo (enums do schema)
64 valores aceitos nos campos da NF-e, direto do esquema XML: motivos de desoneração do ICMS, CST do IPI e os enums de identificação da nota.
Validador de GTIN
Confere dígito verificador e prefixo GS1 do código de barras — a rejeição 611 recusa GTIN inválido.
Código de município (IBGE)
5.571 municípios com o código IBGE usado nos campos de origem, destino e local da prestação.
Os códigos que a reforma trouxe para a nota
- · cClassTrib — 164 códigos — A classificação tributária do IBS/CBS que a nota exige por item.
- · CST do IBS/CBS — A situação tributária da reforma.
- · Indicador de local da operação — Onde a operação se considera realizada — define o ente destinatário da receita.
- · Crédito presumido (cCredPres) — As hipóteses legais, a forma de apropriação e a vigência.
- · Rejeições da reforma — A série 1000+ organizada pela causa.
Os 41 eventos da NF-e
A rejeição impede a nota de nascer; o evento é o que acontece depois que ela existe — cancelar, corrigir, manifestar, prorrogar. Todos com o código oficial, lido do schema que valida cada um.
| tpEvento | Evento | Schema |
|---|---|---|
| 110001 | Informar “Cancelamento de Evento | e110001_v1.00.xsd |
| 110110 | Carta de Correção | e110110_v1.00.xsd |
| 110111 | Cancelamento | e110111_v1.00.xsd |
| 110112 | Cancelamento por substituição | e110112_v1.00.xsd |
| 110130 | Comprovante de Entrega da NF-e | e110130_v1.00.xsd |
| 110131 | Cancelamento Comprovante de Entrega da NF-e | e110131_v1.00.xsd |
| 110140 | EPEC | e110140_v1.00.xsd |
| 110192 | Insucesso na Entrega da NF-e | e110192_v1.00.xsd |
| 110193 | Cancelamento Insucesso na Entrega da NF-e | e110193_v1.00.xsd |
| 110750 | ECONF | e110750_v1.00.xsd |
| 110751 | Cancelamento Conciliação Financeira | e110751_v1.00.xsd |
| 111500 | Pedido de Prorrogação | e111500_v1.00.xsd |
| 111501 | Pedido de Prorrogação | e111501_v1.00.xsd |
| 111502 | Cancelamento de Pedido de Prorrogação | e111502_v1.00.xsd |
| 111503 | Cancelamento de Pedido de Prorrogação | e111503_v1.00.xsd |
| 112110 | de Informação de efetivo pagamento integral para liberar cré | e112110_v1.00.xsd |
| 112120 | Descrição do evento: "Importação em ALC/ZFM não convertida em isenção | e112120_v1.00 .xsd |
| 112130 | Descrição do evento: "Perecimento, perda, roubo | e112130_v1.00.xsd |
| 112140 | "Descrição do evento: "Fornecimento não realizado com pagamento antecipado | e112140_v1.00.xsd |
| 112150 | Descrição do evento: "Atualização da Data de Previsão de Entrega | e112150_v1.00.xsd |
| 210200 | Descrição do Evento: | e210200_v1.00.xsd |
| 210210 | Descrição do Evento: | e210210_v1.00.xsd |
| 210220 | Descrição do Evento: | e210220_v1.00.xsd |
| 210240 | Descrição do Evento:"Operação não Realizada | e210240_v1.00.xsd |
| 211110 | de Solicitação de Apropriação de crédito presumido | e211110_v1.00.xsd |
| 211124 | Descrição do evento: “Perecimento, perda, roubo | e211124_v1.00.xsd |
| 211128 | Descrição do evento: "Aceite de débito na apuração por emissão de nota de crédi | e211128_v1.00.xsd |
| 211130 | de Imobilização de Item | e211130_v1.00.xsd |
| 211140 | de Solicitação de Apropriação de Crédito de Combustível | e211140_v1.00.xsd |
| 211150 | Descrição do evento: "Solicitação de Apropriação de Crédito para bens e serviço | e211150_v1.00.xsd |
| 212110 | Descrição do evento: "Manifestação sobre Pedido de Transferência de Crédito de | e212110_v1.00.xsd |
| 212120 | Descrição do evento: "Manifestação sobre Pedido de Transferência de Créditode CB | e212120_v1.00.xsd |
| 411500 | Fisco Prorrogação ICMS remessa para industrialização | e411500_v1.00.xsd |
| 411501 | Fisco Prorrogação ICMS remessa para industrialização | e411501_v1.00.xsd |
| 411502 | Fisco Prorrogação ICMS remessa para industrialização | e411502_v1.00.xsd |
| 411503 | Fisco Prorrogação ICMS remessa para industrialização | e411503_v1.00.xsd |
| 412120 | "Descrição do evento: Manifestação do Fisco sobre Pedido de Transferência de Cr | e412120_v1.00.xsd |
| 412130 | Descrição do evento: "Manifestação do Fisco sobre Pedido de Transferência de Cr | e412130_v1.00.xsd |
| 790700 | Averbação para Exportação | e790700_v1.00.xsd |
| 990900 | Vistoria SUFRAMA | e990900_v1.00.xsd |
| 990910 | Confirmação de Internalização da Mercadoria na SUFRAMA | e990910_v1.00.xsd |
Do pacote de schemas de evento da NF-e (Portal Nacional). O código sai do nome do arquivo, que é onde a Receita o declara — nos documentos setoriais o schema traz o campo sem enumerar, e lá o código fica em branco em vez de deduzido.
Perguntas frequentes
Como saber por que a NF-e foi rejeitada?
Pelo código cStat que o autorizador devolve. Cada um tem ficha própria aqui, com o motivo oficial e — o que costuma faltar em outras consultas — a REGRA DE VALIDAÇÃO que dispara o erro, que é o que permite corrigir o XML em vez de adivinhar. São 1039 códigos, do MOC e das Notas Técnicas.
Como validar o grupo IBS/CBS antes de transmitir?
Colando o XML no validador. Ele confere o que a NT 2025.002 exige no grupo IBSCBS: presença do grupo por item, CST existente, cClassTrib existente e vigente, compatibilidade entre os dois, uso no modelo certo de documento, grupo de redução coerente, alíquotas do ano de teste, a matemática dos valores por item e dos totalizadores, o grupo de devolução de tributo, código de município, CEP e dígito de GTIN.
O que são os "códigos de campo" da NF-e?
São as listas de valores que o esquema XML aceita em cada campo — enumerações. Valor fora da lista é recusado pelo schema, antes mesmo das regras de validação. Estão publicados aqui os 64 códigos dos campos de desoneração do ICMS, CST do IPI e identificação da nota, com a descrição do próprio schema.
A NF-e já exige IBS e CBS?
O grupo existe no leiaute e a validação do conteúdo está ativa para quem informa. A rejeição por AUSÊNCIA do grupo estava prevista para 03/08/2026 e foi adiada sem nova data pela NT 2025.002-RTC v1.51, aprovada pelo Ato Técnico Conjunto RFB/CGIBS nº 1/2026 — a NT trocou a data da regra por "implementação futura para produção".