Versão do leiaute fiscal

O que é a versão do leiaute fiscal?

O leiaute fiscal é o modelo oficial que define como um documento fiscal eletrônico deve ser montado: quais informações entram, em que ordem, com que tamanho e em que formato. A versão do leiaute é o número que identifica qual edição desse modelo está em vigor ou está sendo usada em um documento específico.

Assim como um formulário em papel pode ganhar campos novos ao longo do tempo, o leiaute também muda. Cada mudança relevante recebe uma nova versão, para que emissores e órgãos autorizadores saibam exatamente quais regras aplicar.

Onde a versão do leiaute aparece no documento?

A versão é informada dentro do próprio arquivo XML, geralmente como um atributo chamado versao em tags principais do documento. Na NF-e, por exemplo, a tag que reúne os dados da nota traz esse atributo, como em versao="4.00".

Além disso, cada versão vem acompanhada de um conjunto de arquivos de esquema XML, que servem para validar se o documento está montado corretamente. O sistema emissor precisa usar o esquema compatível com a versão declarada.

Por que a versão do leiaute muda?

As mudanças acontecem para acompanhar alterações na legislação tributária, incluir novas informações exigidas pelo fisco, corrigir problemas ou melhorar a segurança e o controle das operações. Um exemplo atual são os ajustes ligados à reforma tributária, que trazem novos grupos de informação, como os de IBS e CBS.

Nem toda alteração gera um novo número principal de versão. Muitas mudanças são publicadas em notas técnicas, que ajustam regras de validação e campos dentro da mesma versão, às vezes com atualização dos esquemas XML.

O que acontece se o sistema usar uma versão desatualizada?

Quando a versão informada no XML não é mais aceita pelo órgão autorizador, o documento é rejeitado e não ganha validade jurídica. Na prática, a empresa fica impedida de emitir a nota até corrigir a integração.

Também pode ocorrer de a versão estar correta, mas o sistema não ter incorporado uma nota técnica recente. Nesse caso, o documento pode ser rejeitado por falta de um campo obrigatório ou por não respeitar uma nova regra de validação.

Como uma API fiscal lida com as versões do leiaute?

Uma API fiscal costuma receber os dados da venda em um formato mais simples, como JSON, e se encarrega de montar o XML na versão exigida por cada documento e cada órgão autorizador. Com isso, o sistema do cliente não precisa reescrever a integração a cada nova versão ou nota técnica.

Ainda assim, quando surgem campos novos obrigatórios, o sistema que envia os dados pode precisar começar a informá-los. Por isso, é recomendável testar as mudanças no ambiente de homologação antes de levá-las ao ambiente de produção.

Exemplos de Versão do leiaute fiscal

• Um ERP que emite NF-e gera o XML com o atributo versao="4.00", indicando à SEFAZ que o documento segue o leiaute 4.00 da nota fiscal eletrônica de produtos.
• Uma plataforma de transporte recebe a rejeição de um CT-e porque sua integração antiga ainda envia o documento em uma versão de leiaute que deixou de ser aceita.
• Após a publicação de uma nota técnica que inclui novos campos de tributação, uma equipe de desenvolvimento valida as alterações no ambiente de homologação antes de liberá-las em produção.
• Um marketplace que emite notas por API fiscal continua enviando os dados em JSON, enquanto a API se encarrega de gerar o XML na versão de leiaute vigente.