Leiaute fiscal

O que é um leiaute fiscal, em termos simples?

Pense no leiaute fiscal como um formulário oficial muito detalhado, só que feito para computadores. Ele diz exatamente quais informações uma nota fiscal eletrônica precisa ter, como o CNPJ do emitente, os produtos, os impostos e os totais, e de que jeito cada uma deve ser escrita.

Cada campo tem um nome técnico, um tipo (número, texto, data), um tamanho máximo, uma indicação de obrigatoriedade e, muitas vezes, uma lista de valores permitidos. Também há regras que relacionam campos entre si, como a exigência de que a soma dos itens bata com o valor total da nota.

Cada tipo de documento tem seu próprio leiaute. A NF-e segue um, a NFC-e compartilha boa parte dele, e CT-e, MDF-e e NFS-e têm estruturas próprias, adequadas ao tipo de operação que registram.

Para que serve o leiaute fiscal?

O leiaute existe para padronizar a comunicação entre milhares de empresas e os órgãos que autorizam os documentos. Sem ele, cada sistema enviaria as informações de um jeito, e seria impossível validar e processar notas automaticamente.

Com um padrão único, a SEFAZ ou a prefeitura consegue verificar em segundos se o documento está completo e coerente, e outros sistemas, como o ERP do cliente ou o do contador, conseguem ler o mesmo arquivo sem adaptações. Isso facilita também a escrituração fiscal e a fiscalização.

Quem define e atualiza o leiaute fiscal?

O leiaute é definido pelas autoridades responsáveis por cada documento. No caso de NF-e, NFC-e, CT-e e MDF-e, as regras são publicadas em manuais oficiais e mantidas de forma coordenada entre as Secretarias da Fazenda estaduais. Na NFS-e, historicamente cada prefeitura podia ter seu próprio padrão, situação que o Padrão Nacional da NFS-e busca unificar.

O leiaute não é fixo. Ele recebe versões novas e ajustes publicados por meio de notas técnicas, que podem criar campos, tornar obrigatórios campos antes opcionais ou mudar regras de validação. A reforma tributária, por exemplo, levou à inclusão de grupos para IBS e CBS nos documentos. Cada mudança costuma ter prazo para testes em homologação antes de valer em produção.

Qual a diferença entre leiaute fiscal e esquema XML?

O leiaute é a especificação completa, escrita em documentação: descreve campos, significados, regras de negócio e mensagens de rejeição. O esquema XML (arquivo XSD) é a tradução técnica de parte dessas regras, usada para verificar automaticamente se a estrutura do arquivo está correta.

Na prática, um XML pode passar no esquema e ainda assim ser rejeitado, porque algumas regras do leiaute só são verificadas pelo autorizador, como conferir se um código de município existe ou se os totais estão consistentes.

O que acontece quando o documento não segue o leiaute?

O autorizador recusa o documento e devolve uma rejeição fiscal, com um código e uma mensagem indicando o problema, como campo obrigatório ausente, formato inválido ou valor fora do permitido. A nota não tem validade jurídica até ser corrigida e reenviada com sucesso.

Erros de leiaute são comuns quando um sistema não acompanha as atualizações publicadas. Uma regra que passa a valer em determinada data pode fazer notas que antes eram autorizadas começarem a ser rejeitadas de um dia para o outro.

Como uma API fiscal ajuda a lidar com o leiaute?

Montar o XML exatamente no leiaute exige conhecimento técnico detalhado e manutenção constante. Uma API fiscal, como a do Conota, recebe os dados da venda em um formato mais simples, geralmente JSON, e cuida de gerar o documento no leiaute vigente, assinar, enviar e acompanhar até a autorização.

Assim, o ERP, a plataforma de vendas ou o marketplace não precisa reescrever sua integração a cada nota técnica. Quando surgem campos novos de preenchimento obrigatório, o sistema do cliente só precisa passar a enviar a informação correspondente, sem se preocupar com a estrutura do XML.

Exemplos de Leiaute fiscal

• Um ERP que monta o XML da NF-e por conta própria precisa ser atualizado quando uma nota técnica torna obrigatório um novo campo no leiaute; caso contrário, as notas passam a ser rejeitadas.
• Uma plataforma de serviços que emite NFS-e em vários municípios precisa lidar com leiautes diferentes de prefeituras que ainda não aderiram ao Padrão Nacional da NFS-e.
• Uma equipe de desenvolvimento testa em ambiente de homologação as mudanças de leiaute ligadas aos grupos de IBS e CBS antes da data em que passam a valer em produção.
• Um marketplace integrado a uma API fiscal envia os dados do pedido em JSON e recebe de volta o XML já no leiaute correto, junto com o DANFE e o status da autorização.