# XSD > XSD é a sigla de XML Schema Definition, uma linguagem usada para descrever a estrutura que um arquivo XML deve seguir: quais campos existem, em que ordem aparecem, quais são obrigatórios e que tipo de valor aceitam. No meio fiscal, os arquivos XSD definem o formato oficial de documentos como NF-e, NFC-e, CT-e, MDF-e e NFS-e. **Também conhecido como:** XML Schema, Esquema XSD, Arquivo XSD, Schema XML, XSD, XML Schema Definition **Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** X ## O que é um XSD, em palavras simples? Pense no XSD como um molde ou um formulário oficial em branco. Ele não contém os dados de uma nota fiscal específica, mas diz exatamente como qualquer nota daquele tipo precisa ser montada: o nome de cada campo, onde ele fica, quantos caracteres pode ter e se aceita números, datas ou textos. O próprio XSD também é escrito em XML, só que com regras em vez de dados. Um arquivo XML de NF-e, por exemplo, é comparado com o XSD da NF-e para saber se está correto do ponto de vista da estrutura. ## Para que serve o XSD nos documentos fiscais eletrônicos? Os documentos fiscais eletrônicos são trocados entre milhares de sistemas diferentes: ERPs, plataformas de venda, emissores e os servidores das autoridades fiscais. Para que todos se entendam, é preciso um padrão único e verificável. O XSD cumpre esse papel, garantindo que todos montem o XML do mesmo jeito. Quando o XML chega à SEFAZ ou à prefeitura, uma das primeiras verificações é a validação contra o XSD. Se faltar um campo obrigatório, se um valor tiver formato errado ou se a ordem das tags estiver trocada, o documento é rejeitado antes mesmo de as regras tributárias serem analisadas. ## Como funciona a validação de um XML pelo XSD? Um programa chamado validador lê o XML e o XSD ao mesmo tempo e confere, item por item, se o documento respeita as regras. Ele verifica, por exemplo, se a data está no formato esperado, se um CNPJ tem a quantidade certa de dígitos e se campos com valores pré-definidos usam apenas as opções permitidas. O resultado é simples: o XML é válido ou inválido. Quando é inválido, o validador costuma indicar qual elemento causou o problema, o que ajuda o desenvolvedor a localizar o erro. Muitos sistemas fazem essa validação localmente, antes do envio, para evitar rejeições e economizar tempo. ## Quem publica os XSDs fiscais e com que frequência eles mudam? Os XSDs oficiais são disponibilizados pelos órgãos responsáveis por cada documento, geralmente em pacotes publicados junto com o leiaute e as notas técnicas. No caso da NFS-e, além do Padrão Nacional, há municípios que historicamente usam leiautes próprios, cada um com seus esquemas. Os XSDs mudam sempre que o leiaute é alterado, por exemplo para incluir novos campos ou grupos de tributação. Quem emite documentos precisa acompanhar essas atualizações, pois um XML montado com uma versão antiga do esquema pode passar a ser rejeitado. ## Qual a diferença entre XSD e leiaute fiscal? O leiaute fiscal é a especificação completa do documento, normalmente em formato de manual, com a descrição de cada campo, seu significado e as regras de negócio. O XSD é a tradução técnica e automatizável da parte estrutural desse leiaute. Por isso, um XML pode passar no XSD e ainda assim ser rejeitado: o esquema verifica formato e estrutura, mas não confere, por exemplo, se a alíquota informada é a correta para aquela operação. Essas regras de negócio são validadas depois, pela autoridade fiscal. ## Quem usa uma API fiscal precisa lidar com XSD? Em geral, não diretamente. Em uma API fiscal como a do Conota, o sistema do cliente envia os dados em JSON e a infraestrutura de emissão se encarrega de montar o XML no formato exigido, validar a estrutura e acompanhar o documento até a autorização. Ainda assim, entender o que é XSD ajuda a interpretar mensagens de erro de validação e a compreender por que certos campos têm limites de tamanho ou formatos obrigatórios no payload de emissão. ## Exemplos de XSD - Um ERP que monta o XML da NF-e por conta própria valida o arquivo contra o XSD antes do envio e descobre que o campo de CEP do destinatário estava com um hífen, formato não aceito pelo esquema. - Uma SEFAZ rejeita uma nota com a mensagem de falha de schema porque o grupo de informações de pagamento foi colocado fora da ordem definida no XSD. - Após a publicação de uma nota técnica com novos campos, a equipe de desenvolvimento de um marketplace atualiza os arquivos XSD usados nos testes do ambiente de homologação. - Um desenvolvedor que integra NFS-e de vários municípios percebe que cada prefeitura com leiaute próprio exige um XSD diferente, enquanto o Padrão Nacional unifica a estrutura. ## Perguntas frequentes ### XSD e XML são a mesma coisa? Não. O XML é o documento com os dados, como uma nota fiscal preenchida. O XSD é o conjunto de regras que define como esse XML deve ser estruturado. O XSD também é escrito em XML, mas sua função é validar, não transportar dados. ### Um XML válido no XSD sempre será autorizado? Não. O XSD valida apenas estrutura e formato. Depois disso, a autoridade fiscal confere regras de negócio, como cálculos de impostos, situação cadastral do emitente e numeração. O documento pode ser rejeitado nessas etapas. ### Onde encontro os XSDs da NF-e e de outros documentos? Eles são publicados pelos órgãos responsáveis por cada documento, normalmente em seus portais oficiais, junto com manuais de leiaute e notas técnicas. É importante usar sempre a versão vigente. ### Qual a relação entre XSD e JSON Schema? Ambos descrevem e validam a estrutura de dados. O XSD é usado para arquivos XML; o JSON Schema, para dados em JSON. Em APIs fiscais, é comum o cliente enviar JSON validado por JSON Schema, que depois vira XML validado por XSD. ## Termos relacionados - [Esquema XML](https://conota.dev/glossario/esquema-xml.md) - [Schema de validação](https://conota.dev/glossario/schema-de-validacao.md) - [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md) - [Leiaute fiscal](https://conota.dev/glossario/leiaute-fiscal.md) - [Namespace XML](https://conota.dev/glossario/namespace-xml.md) - [Erro de validação fiscal](https://conota.dev/glossario/erro-de-validacao-fiscal.md) --- Fonte: [XSD](https://conota.dev/glossario/xsd/) · Atualizado em 2026-10-22