versao de infNFe: o leiaute 4.00 dentro dos dados da nota

versao em /nfeProc/NFe/infNFe/@versao identifica o leiaute do bloco fiscal. No pacote PL 010f v1.04, o atributo é obrigatório, usa TVerNFe e recebe 4.00. Ele integra a abertura de infNFe, junto de Id.

Identidade técnica: atributo; XPath /nfeProc/NFe/infNFe/@versao.

Nesta página:

• Onde conferir e como representar
• Por que a Reforma Tributária não virou versao 1.52
• Quando ocorre erro de versão ou schema
• Leituras relacionadas

Onde conferir e como representar

Abertura parcial, com chave ilustrativa fictícia:

<infNFe xmlns="http://www.portalfiscal.inf.br/nfe"
        Id="NFe35191000000000000000550010000000011000000010"
        versao="4.00">

Não crie uma tag <versao> nem coloque o atributo em NFe por conveniência. 4.0, 4 e v4.00 não correspondem ao literal do tipo TVerNFe. Fonte: XSD PL 010f v1.04, TNFe/infNFe e TVerNFe, em leiauteNFe_v4.00.xsd.

Por que a Reforma Tributária não virou versao 1.52

4.00 é a versão do leiaute. PL_010f_v1.04 é a identificação de um pacote de schemas. 1.52 identifica uma versão da NT 2025.002. ide/verProc informa a versão do processo emissor. Esses números pertencem a objetos diferentes e não devem ser substituídos uns pelos outros.

Dois XMLs com infNFe/@versao="4.00" podem ter sido gerados com pacotes diferentes e estar sujeitos a regras distintas pela data, operação e ambiente. O atributo, sozinho, não prova suporte aos campos IBS/CBS/IS nem a implantação de uma NT em determinada autorizadora.

Quando ocorre erro de versão ou schema

Associe um prefixo ao namespace da NF-e e consulte /n:nfeProc/n:NFe/n:infNFe/@versao; o atributo não usa prefixo de namespace. Se o arquivo começar por NFe, remova somente o ancestral nfeProc da consulta.

Para atributo ausente ou formato incorreto, examine o XML bruto e a serialização. Para tag nova recusada, confira o pacote realmente carregado, dependências XSD e cronograma do ambiente. Alterar o número de versão não instala o novo pacote. Como o atributo está no bloco referenciado pela assinatura, não o edite no arquivo autorizado; preserve o original e investigue a integração ou a geração antes de assinar novamente um rascunho pelo fluxo adequado.

Leituras relacionadas

A versão do envelope tem posição e finalidade próprias. versao — /nfeProc/@versao.