versao em nfeProc: atributo do envelope da NF-e processada

versao em /nfeProc/@versao é um atributo obrigatório do envelope da nota processada. No pacote PL 010f v1.04, ele usa TVerNFe, cujo valor admitido é 4.00. Não é uma tag filha e não identifica a versão do software emissor.

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

Nesta página:

• Onde o atributo fica e o que o número significa
• Atributos iguais em lugares diferentes
• Exemplo e diagnóstico de incompatibilidade
• Leituras relacionadas

Onde o atributo fica e o que o número significa

A forma correta é <nfeProc versao="4.00">. A forma <nfeProc><versao>4.00</versao></nfeProc> cria outro elemento e não satisfaz o atributo obrigatório. Nome e capitalização são exatos: versao não recebe acento nem inicial maiúscula. Fonte: XSD PL 010f v1.04, TNfeProc e TVerNFe.

O pacote se chama PL_010f_v1.04, mas o atributo continua 4.00. Alterações de schemas e regras de negócio podem ocorrer sem alteração desse valor. Assim, versao="4.00" não informa quais notas técnicas foram implementadas pelo emissor ou autorizador.

Atributos iguais em lugares diferentes

nfeProc/@versao descreve o envelope; NFe/infNFe/@versao descreve o bloco fiscal; protNFe/@versao descreve o protocolo. São atributos de elementos diferentes. ide/verProc, por sua vez, identifica a versão do processo emissor e é uma tag. Não use o número de versão do Fiscal Pro, da biblioteca de integração ou do pacote de liberação para preencher nfeProc/@versao.

Na leitura com prefixos, use /n:nfeProc/@versao, associando n ao namespace da NF-e. O atributo é sem namespace: não transforme a consulta em @n:versao.

Exemplo e diagnóstico de incompatibilidade

A abertura abaixo é um recorte, sem filhos e sem fechamento, para identificar o atributo:

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

Se a validação acusar atributo ausente ou valor não permitido, confira o XML bruto, a raiz, a grafia e o schema utilizado. 4, 4.0 e v4.00 não substituem o literal 4.00. Se houver erro em outro campo, trocar esse atributo não instala os schemas novos nem corrige a regra fiscal. Preserve o arquivo original e corrija a configuração ou serialização comprovadamente errada; depois valide o envelope completo com suas dependências XSD.

Leituras relacionadas

O atributo homônimo em infNFe identifica o bloco fiscal, em outro ancestral. versao — /nfeProc/NFe/infNFe/@versao.